i3blocks - ออนไลน์ในคลาวด์

โครงการ:

ชื่อ

i3blocks - ตัวกำหนดเวลาที่ยืดหยุ่นสำหรับ i3bar

เรื่องย่อ

i3blocks [-ค ไฟล์คอนฟิก] [-v]... [-h] [-V]

DESCRIPTION

i3blocks ช่วยให้สามารถอธิบายบล็อคในรูปแบบง่ายๆ และสร้างสถานะได้อย่างง่ายดาย
บรรทัดสำหรับ ไอ3บาร์(1). จัดการการคลิก สัญญาณ และช่วงเวลาสำหรับสคริปต์ผู้ใช้

OPTIONS

-c ไฟล์คอนฟิก
ระบุพาธไฟล์คอนฟิกูเรชันทางเลือก ตามค่าเริ่มต้น i3blocks จะค้นหา
ไฟล์การกำหนดค่าตามลำดับต่อไปนี้ (โปรดทราบว่า / ฯลฯ อาจขึ้นต้นด้วย
/ usr / local ขึ้นอยู่กับแฟล็กการคอมไพล์):

1. ~/.config/i3blocks/config.php (หรือ $XDG_CONFIG_HOME/i3blocks/config หากตั้งค่าไว้)
2. ~/.i3blocks.conf
3. /etc/xdg/i3blocks/config (หรือ $XDG_CONFIG_DIRS/i3blocks/config หากตั้งค่าไว้)
4. /etc/i3blocks.conf

-v
ระดับล็อก ตัวเลือกนี้เป็นแบบสะสม ตามค่าเริ่มต้น ข้อความแสดงข้อผิดพลาดจะแสดงบน stderr
ผ่านหนึ่งครั้ง ความล้มเหลวระหว่างการอัปเดตจะแสดงขึ้นภายในบล็อก ผ่านสองครั้งทำให้
ข้อความดีบักบน stderr

-V
พิมพ์เวอร์ชันและออก

-h
พิมพ์ข้อความช่วยเหลือและออก

การกำหนดค่า

ไฟล์คอนฟิกูเรชันเป็นไฟล์ ini แต่ละส่วนจะอธิบายบล็อกใหม่ สาย
ขึ้นต้นด้วย # เครื่องหมายเป็นความคิดเห็น และบรรทัดว่างจะถูกละเว้น ทรัพย์สินคือ
คีย์=ค่า คู่ต่อบรรทัด โดยไม่มีช่องว่างรอบเครื่องหมายเท่ากับ ประกาศคุณสมบัติภายนอก
บล็อก (เช่น ที่จุดเริ่มต้นของไฟล์) อธิบายการตั้งค่าส่วนกลาง

นี่คือตัวอย่างไฟล์ปรับแต่ง:

#นี่คือความคิดเห็น
ช่วงเวลา=5
สี=#00FF00

[สภาพอากาศ]
คำสั่ง =~/bin/weather.pl
ช่วงเวลา=1800

[เวลา]
คำสั่ง=วันที่ +%T

ในการใช้ i3blocks เป็นบรรทัดสถานะของคุณ ให้กำหนดเป็น บาร์ บล็อกของคุณ ~/i3/config ไฟล์:

บาร์ {
status_command i3blocks
}

BLOCK

คุณสมบัติที่ใช้อธิบายบล็อกคือคีย์ที่ระบุในโปรโตคอล i3bar
http://i3wm.org/docs/i3bar-protocol.html, รวมทั้งคุณสมบัติเพิ่มเติมที่ใช้โดย i3blocks ไปยัง
อธิบายว่าจะอัปเดตบล็อกเมื่อใดและอย่างไร คุณสมบัติที่รองรับทั้งหมดได้อธิบายไว้ด้านล่าง

คีย์ต่อไปนี้เป็นแบบมาตรฐาน ดู http://i3wm.org/docs/i3bar-protocol.html เพื่อดูรายละเอียด

· ข้อความเต็ม

· ข้อความสั้น

· สี

· min_width

· จัดแนว

· ชื่อ

· ตัวอย่าง

· ด่วน

· คั่น

· ตัวคั่น_block_width

· มาร์กอัป

คีย์ต่อไปนี้ใช้เฉพาะกับ i3blocks.

คำสั่ง
คำสั่งที่ดำเนินการโดยเชลล์ ใช้เพื่ออัพเดตบล็อก พฤติกรรมที่คาดหวังคือ
อธิบายไว้ด้านล่างใน คำสั่ง มาตรา.

ระยะห่าง
หากเป็นจำนวนเต็มบวก บล็อกจะเกิดเมื่อเริ่มต้นและค่าคือ
ใช้เป็นช่วงเวลาในหน่วยวินาทีเพื่อกำหนดเวลาการอัปเดตในอนาคต หากไม่ระบุหรือ 0
บล็อกจะไม่ทำงานเมื่อเริ่มต้น (ซึ่งมีประโยชน์ในการจำลองปุ่ม) ถ้า
"ครั้งเดียว" (หรือ -1) บล็อกจะถูกดำเนินการเมื่อเริ่มต้นเท่านั้น (โปรดทราบว่าการคลิกหรือ
สัญญาณจะยังคงทริกเกอร์การอัปเดต) หาก "ทำซ้ำ" (หรือ -2) บล็อกจะเป็น
เกิดเมื่อเริ่มต้นและทันทีที่สิ้นสุด (มีประโยชน์ในการบล็อกซ้ำ
คำสั่ง) ใช้ด้วยความระมัดระวัง! หาก "ยังคงอยู่" (หรือ -3) บล็อกจะถูกดำเนินการเท่านั้น
เมื่อเริ่มต้นและอัปเดตทันทีที่ส่งออกบรรทัด จึงจำกัดอยู่เพียงบรรทัดเดียว
การปรับปรุง

สัญญาณ หมายเลขสัญญาณที่ใช้ในการอัพเดทบล็อค ทั้งหมดตามเวลาจริง (คิดจัดลำดับความสำคัญ
และเข้าคิวได้) สัญญาณมีให้สำหรับผู้ใช้ ตัวเลขนี้ใช้ได้ตั้งแต่ 1 ถึง
N โดยที่ SIGRTMIN+N = SIGRTMAX (หมายเหตุ: มี 31 สัญญาณเรียลไทม์ใน Linux)
ยกตัวอย่างเช่น สัญญาณ=10 หมายความว่าบล็อกนี้จะได้รับการอัปเดตเมื่อ i3blocks
ได้รับ SIGRTMIN+10

ฉลาก ฉลากเสริมเพื่อนำหน้าไปยัง ข้อความเต็ม หลังจากการอัพเดท

รูป คุณสมบัตินี้ระบุรูปแบบของข้อความเอาต์พุต รูปแบบเริ่มต้นเป็นแบบธรรมดา
ข้อความตามที่อธิบายไว้ใน คำสั่ง ส่วน. หากใช้ "json" (หรือ 1) บล็อก
เอาต์พุตถูกแยกวิเคราะห์เป็น JSON

คำสั่ง

ค่าของ คำสั่ง คีย์จะถูกส่งผ่านและดำเนินการตามที่เป็นโดยเชลล์

เอาต์พุตมาตรฐานของบรรทัดคำสั่งใช้เพื่ออัพเดตเนื้อหาบล็อก แต่ละ
บรรทัดเอาต์พุตที่ไม่ว่างเปล่าจะเขียนทับคุณสมบัติที่เกี่ยวข้อง:

1.full_text

2. ข้อความสั้น

3. สี

ตัวอย่างเช่น สคริปต์นี้ตั้งค่า ข้อความเต็ม ในสีน้ำเงิน แต่ไม่มี ข้อความสั้น:

echo "นี่คือป้ายชื่อของฉัน"
เสียงสะท้อน
echo \"0000FF

หากบรรทัดคำสั่งคืนค่า 0 หรือ 33 บล็อกจะถูกอัพเดต มิเช่นนั้นจะถือว่าเป็น
ล้มเหลวและบรรทัดแรก (ถ้ามี) ยังคงแสดงอยู่ โปรดทราบว่า stderr จะถูกละเว้น NS
รหัสส่งคืน 33 จะตั้งค่า ด่วน ตั้งค่าสถานะเป็นจริง

ตัวอย่างเช่น สคริปต์นี้พิมพ์เปอร์เซ็นต์แบตเตอรี่และตั้งค่าสถานะเร่งด่วนหากเป็น
ต่ำกว่า 10%:

BAT=`acpi -b | grep -E -o ´[0-9][0-9]?%``

เสียงสะท้อน "BAT: $BAT"
ทดสอบ ${BAT%?} -le 10 && ออก 33 || ทางออก 0

เมื่อทำการฟอร์คคำสั่งบล็อก i3blocks จะกำหนดสภาพแวดล้อมด้วยบ้าง บล็อก_*
ตัวแปร ตัวแปรต่อไปนี้มีให้เสมอ โดยในท้ายที่สุดจะเป็นสตริงว่าง as
มูลค่า.

BLOCK_NAME
ชื่อของบล็อก (โดยปกติคือชื่อส่วน)

BLOCK_INSTANCE
อาร์กิวเมนต์ที่เป็นทางเลือกของสคริปต์

BLOCK_BUTTON
ปุ่มเมาส์ (1, 2 หรือ 3) หากมีการคลิกบล็อก

BLOCK_X และ BLOCK_Y
พิกัดที่เกิดการคลิก หากมีการคลิกบล็อก

นี่คือตัวอย่างการใช้สภาพแวดล้อม:

[บล็อก]
command=echo name=$BLOCK_NAME อินสแตนซ์=$BLOCK_INSTANCE
ช่วงเวลา=1

[คลิกฉัน]
full_text=คลิกฉัน!
command=ปุ่ม echo=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=ปุ่ม=1 x=1366 y=768
จัด=ซ้าย

โปรดทราบว่า i3blocks จัดเตรียมชุดของสคริปต์เสริมเพื่อความสะดวก เช่น network
สถานะ ตรวจสอบแบตเตอรี่ โหลดซีพียู ระดับเสียง ฯลฯ

ตัวอย่าง

ตัวอย่างเช่น นี่คือการกำหนดค่าที่ใกล้เคียงกับ i3สถานะ(1) การตั้งค่าเริ่มต้น:

ทั้งหมด

ช่วงเวลา=5
สัญญาณ=10

[ไอพีวี6]

[ฟรี]

[dhcp]

[วีพีเอ็น]

[ไวไฟ]

[อีเธอร์เน็ต]
min_width=E: 255.255.255.255 (1000 เมกะบิต/วินาที)

[แบตเตอรี่]

[ซีพียู]

[วันเวลา]

บล็อกต่อไปนี้แสดงการใช้งานของ สัญญาณ กับบางอย่าง i3(1) การผูกที่ปรับ
ปริมาณก่อนออก ฆ่า -RTMIN+1 i3blocks:

[ปริมาณ]
command=echo -n ´ปริมาณ: ´; amixer รับมาสเตอร์ | grep -E -o ´[0-9][0-9]?%´
ช่วงเวลา=ครั้งเดียว
สัญญาณ=1
# ไม่มีช่วงเวลา ตรวจสอบเฉพาะใน SIGRTMIN+1

นี่คือตัวอย่างการกำหนดค่าแบบมินิมอล สมมติว่าคุณมีสคริปต์จำนวนมากภายใต้
~/bin/บล็อก/ ด้วยชื่อเดียวกับบล็อก:

คำสั่ง =~/bin/บล็อก/$BLOCK_NAME
ช่วงเวลา=1

[ฟรี]
[ไวไฟ]
[อีเธอร์เน็ต]
[แบตเตอรี่]
[ซีพียู]
[วันเวลา]

ใช้ i3blocks ออนไลน์โดยใช้บริการ onworks.net