i3blocks - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

i3blocks - Một công cụ lập lịch linh hoạt cho i3bar

SYNOPSIS

i3blocks [-NS tập tin cấu hình] [-v] ... [-h] [-V]

MÔ TẢ

i3blocks cho phép người ta dễ dàng mô tả các khối ở một định dạng đơn giản và tạo ra một trạng thái
dòng cho i3bar(1). Nó xử lý các nhấp chuột, tín hiệu và khoảng thời gian cho các tập lệnh của người dùng.

LỰA CHỌN

-c tập tin cấu hình
Chỉ định đường dẫn tệp cấu hình thay thế. Theo mặc định, i3blocks tìm kiếm
các tệp cấu hình theo thứ tự sau (lưu ý rằng / Etc có thể được bắt đầu bằng
/ usr / local tùy thuộc vào cờ biên dịch):

1. ~ / .config / i3blocks / config (hoặc $ XDG_CONFIG_HOME / i3blocks / config nếu được đặt)
2. ~ / .i3blocks.conf
3. / etc / xdg / i3blocks / config (hoặc $ XDG_CONFIG_DIRS / i3blocks / config nếu được đặt)
4. /etc/i3blocks.conf

-v
Mức đăng nhập. Tùy chọn này là tích lũy. Theo mặc định, thông báo lỗi được hiển thị trên stderr.
Đã vượt qua một lần, lỗi trong quá trình cập nhật được hiển thị trong khối. Đã vượt qua hai lần cho phép
gỡ lỗi thông báo trên stderr.

-V
In phiên bản và thoát.

-h
In thông báo trợ giúp và thoát.

CẤU HÌNH

Tệp cấu hình là tệp ini. Mỗi phần mô tả một khối mới. Một dòng
bắt đầu bằng một # dấu hiệu là một nhận xét, và các dòng trống bị bỏ qua. Một tài sản là một
key = giá trị ghép nối trên mỗi dòng, không có khoảng trắng xung quanh dấu bằng. Thuộc tính được khai báo bên ngoài
một khối (tức là ở đầu tệp) mô tả cài đặt chung.

Đây là một tệp cấu hình ví dụ:

# Đây là một nhận xét
khoảng thời gian = 5
màu = # 00FF00

[thời tiết]
lệnh =~ / bin / weather.pl
khoảng thời gian = 1800

[thời gian]
lệnh = ngày +% T

Để sử dụng i3blocks làm dòng trạng thái của bạn, hãy xác định nó trong thanh khối của bạn ~ / i3 / config tập tin:

quán ba {
status_command i3blocks
}

A

Các thuộc tính được sử dụng để mô tả một khối là các khóa được chỉ định trong giao thức i3bar
http://i3wm.org/docs/i3bar-protocol.html, cộng với các thuộc tính bổ sung được sử dụng bởi i3blocks đến
mô tả khi nào và làm thế nào để cập nhật một khối. Tất cả các thuộc tính được hỗ trợ được mô tả bên dưới.

Các phím sau là tiêu chuẩn, hãy xem http://i3wm.org/docs/i3bar-protocol.html để biết thêm chi tiết.

· toàn_văn bản

· văn bản ngắn

· màu sắc

· tối thiểu

· sắp xếp

· tên

· ví dụ

· khẩn cấp

· phân cách

· Septor_block_width

· đánh dấu

Các khóa sau dành riêng cho i3blocks.

lệnh
Lệnh được thực thi bởi một trình bao, được sử dụng để cập nhật khối. Hành vi mong đợi là
được mô tả bên dưới, trong COMMAND phần.

khoảng thời gian
Nếu đó là một số nguyên dương, thì khối được tạo ra khi khởi động và giá trị là
được sử dụng như một khoảng thời gian tính bằng giây để lập lịch cập nhật trong tương lai. Nếu không xác định hoặc 0,
khối sẽ không được thực thi khi khởi động (rất hữu ích để mô phỏng các nút). Nếu như
"một lần" (hoặc -1), khối sẽ chỉ được thực thi khi khởi động (lưu ý rằng một lần nhấp hoặc
tín hiệu sẽ vẫn kích hoạt cập nhật). Nếu "lặp lại" (hoặc -2), khối sẽ là
sinh ra khi khởi động và ngay sau khi nó kết thúc (hữu ích khi lặp lại chặn
lệnh). Sử dụng cẩn thận! Nếu "vẫn tồn tại" (hoặc -3), khối sẽ chỉ được thực thi
khi khởi động và được cập nhật ngay khi nó xuất ra một dòng. Do đó giới hạn ở một dòng
cập nhật.

tín hiệu Số tín hiệu được sử dụng để cập nhật khối. Tất cả thời gian thực (nghĩ ưu tiên
và có thể xếp hàng) tín hiệu có sẵn cho người dùng. Số có giá trị từ 1 đến
N, trong đó SIGRTMIN + N = SIGRTMAX. (Lưu ý: có 31 tín hiệu thời gian thực trong Linux.)
Ví dụ, tín hiệu = 10 có nghĩa là khối này sẽ được cập nhật khi i3blocks
nhận SIGRTMIN + 10.

nhãn Một nhãn tùy chọn để trả trước cho toàn_văn bản sau khi cập nhật.

định dạng Thuộc tính này chỉ định định dạng của văn bản đầu ra. Định dạng mặc định là đơn giản
văn bản, như được mô tả trong COMMAND phần. Nếu "json" (hoặc 1) được sử dụng, khối
đầu ra được phân tích cú pháp dưới dạng JSON.

COMMAND

Giá trị của lệnh key sẽ được truyền và thực thi như một trình bao.

Đầu ra tiêu chuẩn của dòng lệnh được sử dụng để cập nhật nội dung khối. Mỗi
dòng không trống của đầu ra sẽ ghi đè lên thuộc tính tương ứng:

1. toàn_văn bản

2. văn bản ngắn

3. màu sắc

Ví dụ: tập lệnh này đặt toàn_văn bản màu xanh lam nhưng không văn bản ngắn:

echo "Đây là nhãn của tôi"
bỏ lỡ
tiếng vọng \ # 0000FF

Nếu dòng lệnh trả về 0 hoặc 33, khối được cập nhật. Nếu không, nó được coi là
lỗi và dòng đầu tiên (nếu có) vẫn hiển thị. Lưu ý rằng stderr bị bỏ qua. MỘT
mã trả về 33 sẽ thiết lập khẩn cấp cờ thành true.

Ví dụ: tập lệnh này in phần trăm pin và đặt cờ khẩn cấp nếu nó
dưới 10%:

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

echo "BAT: $ BAT"
kiểm tra $ {BAT%?} -le 10 && thoát ra 33 || thoát 0

Khi fork một lệnh khối, i3blocks sẽ thiết lập môi trường với một số KHỐI_*
biến. Các biến sau đây luôn được cung cấp, cuối cùng là một chuỗi trống như
giá trị.

BLOCK_NAME
Tên của khối (thường là tên phần).

BLOCK_INSTANCE
Một đối số tùy chọn cho tập lệnh.

BLOCK_BUTTON
Nút chuột (1, 2 hoặc 3) nếu khối được nhấp.

BLOCK_X và BLOCK_Y
Tọa độ nơi nhấp chuột xảy ra, nếu khối được nhấp.

Đây là một ví dụ sử dụng môi trường:

[khối]
command = echo name = phiên bản $ BLOCK_NAME = $ BLOCK_INSTANCE
khoảng thời gian = 1

[nhấp vào đây]
full_text = Nhấp vào tôi!
command = echo button = $ BLOCK_BUTTON x = $ BLOCK_X y = $ BLOCK_Y
min_width = button = 1 x = 1366 y = 768
align = left

Lưu ý rằng i3blocks cung cấp một tập hợp các tập lệnh tùy chọn để thuận tiện, chẳng hạn như mạng
trạng thái, kiểm tra pin, tải cpu, âm lượng, v.v.

VÍ DỤ

Ví dụ, đây là một cấu hình gần với trạng thái i3(1) cài đặt mặc định:

ALL

khoảng thời gian = 5
tín hiệu = 10

[ipv6]

[miễn phí]

[dhcp]

[vpn]

[wifi]

[ethernet]
min_width = E: 255.255.255.255 (1000 Mbit / s)

[pin]

[CPU]

[ngày giờ]

Khối sau cho thấy việc sử dụng tín hiệu với một số i3(1) các ràng buộc điều chỉnh
khối lượng, trước khi phát hành pkill -RTMIN + 1 i3blocks:

[âm lượng]
lệnh = echo -n ´Volume: ´; amixer get Master | grep -E -o ´ [0-9] [0-9]?% ´
khoảng thời gian = một lần
tín hiệu = 1
# không có khoảng thời gian, chỉ kiểm tra trên SIGRTMIN + 1

Đây là một ví dụ về cấu hình rất tối giản, giả sử bạn có một loạt các tập lệnh trong
~ / bin / blocks / trùng tên với các khối:

lệnh =~ / bin / blocks /$ BLOCK_NAME
khoảng thời gian = 1

[miễn phí]
[wifi]
[ethernet]
[pin]
[CPU]
[ngày giờ]

Sử dụng i3blocks trực tuyến bằng các dịch vụ onworks.net