i3blocks - онлайн в хмарі

ПРОГРАМА:

ІМ'Я

i3blocks - Гнучкий планувальник для i3bar

СИНТАКСИС

i3blocks [-c конфігураційний файл] [-v]... [-h] [-V]

ОПИС

i3blocks дозволяє легко описувати блоки в простому форматі та генерувати статус
лінія для i3bar(1). Він обробляє кліки, сигнали та часовий інтервал для користувацьких скриптів.

ВАРІАНТИ

-c конфігураційний файл
Вказує альтернативний шлях до файлу конфігурації. За замовчуванням i3blocks шукає
конфігураційні файли в такому порядку (зверніть увагу, що / Etc може мати префікс з
/ usr / local залежно від прапорів компіляції):

1. ~/.config/i3blocks/config (або $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

[погода]
command =~/bin/weather.pl
інтервал=1800

[час]
команда=дата +%T

Щоб використовувати i3block як рядок стану, визначте його в a бар блок вашого ~/i3/config Файл:

бар {
status_command i3blocks
}

БЛОК

Властивості, які використовуються для опису блоку, є ключами, зазначеними в протоколі i3bar
http://i3wm.org/docs/i3bar-protocol.html, а також додаткові властивості, які використовує i3blocks до
описати, коли і як оновити блок. Усі підтримувані властивості описані нижче.

Наступні клавіші є стандартними, див http://i3wm.org/docs/i3bar-protocol.html for details.

· повний_текст

· короткий_текст

· color

· min_width

· вирівнювати

· ім'я

· екземпляр

· терміново

· роздільник

· separator_block_width

· розмітка

Наведені нижче ключі є специфічними для i3blocks.

команда
Команда, що виконується оболонкою, використовується для оновлення блоку. Очікувана поведінка є
описано нижче, в КОМАНДА .

інтервал
Якщо це додатне ціле число, то блок створюється під час запуску, а значення дорівнює
використовується як часовий інтервал у секундах для планування майбутніх оновлень. Якщо не вказано або 0,
блок не буде виконуватися під час запуску (що корисно для імітації кнопок). Якщо
«один раз» (або -1), блок буде виконано лише під час запуску (зверніть увагу, що клацання або
сигнал все одно ініціює оновлення). Якщо "повторити" (або -2), блок буде
створюється під час запуску, і як тільки він завершується (корисно повторити блокування
команди). Використовуйте з обережністю! Якщо "persist" (або -3), блок буде виконано лише
під час запуску та оновлюється, щойно він виводить рядок. Таким чином обмежується однією лінією
оновлення

сигналізувати Номер сигналу, який використовується для оновлення блоку. Все в режимі реального часу (вважайте, що пріоритети
та доступні для користувача сигнали. Число дійсне від 1 до
N, де SIGRTMIN+N = SIGRTMAX. (Примітка: у Linux є 31 сигнал реального часу.)
Так, наприклад, сигнал=10 означає, що цей блок буде оновлено, коли i3blocks
отримує SIGRTMIN+10.

етикетка Необов’язкова мітка, яка передує до повний_текст після оновлення.

формат Ця властивість визначає формат вихідного тексту. Формат за замовчуванням простий
текст, як описано в КОМАНДА розділ. Якщо використовується «json» (або 1), блок
вихід аналізується як JSON.

КОМАНДА

Значення команда ключ буде переданий і виконаний як є оболонкою.

Стандартний вихід командного рядка використовується для оновлення вмісту блоку. Кожен
непорожній рядок виводу перезапише відповідну властивість:

1. повний_текст

2. короткий_текст

3. колір

Наприклад, цей скрипт встановлює параметр повний_текст синім, але ні короткий_текст:

echo "Ось моя етикетка"
нудьгувати
луна \#0000FF

Якщо командний рядок повертає 0 або 33, блок оновлюється. В іншому випадку вважається а
помилка, а перший рядок (якщо є) все ще відображається. Зверніть увагу, що stderr ігнорується. А
код повернення 33 встановить терміново прапорець значення true.

Наприклад, цей скрипт друкує відсоток заряду батареї та встановлює прапор термінового, якщо він є
нижче 10%:

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

echo "BAT: $BAT"
тест ${BAT%?} -le 10 && вихід 33 || вихід 0

Під час розділення команди блоку, i3blocks створить середовище з деякими БЛОК_*
змінні. Завжди надаються наступні змінні, зрештою порожній рядок як
значення.

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 button=$BLOCK_BUTTON x=$BLOCK_X y=$BLOCK_Y
min_width=button=1 x=1366 y=768
вирівняти=ліворуч

Зверніть увагу, що i3blocks надає набір необов'язкових сценаріїв для зручності, наприклад мережевих
стан, перевірка батареї, навантаження на процесор, гучність тощо.

ПРИКЛАДИ

Як приклад, ось близька конфігурація до i3status(1) налаштування за замовчуванням:

ALL

інтервал=5
сигнал=10

[ipv6]

[безкоштовно]

[dhcp]

[vpn]

[wifi]

[ethernet]
min_width=E: 255.255.255.255 (1000 Мбіт/с)

[батарея]

[ЦП]

[дата, час]

Наступний блок показує використання сигналізувати з деякими i3(1) прив'язки, які регулюють
том, перед видачею а пкіл -RTMIN+1 i3blocks:

[том]
command=echo -n ´Гучність: ´; amixer отримати Master | grep -E -o ´[0-9][0-9]?%´
інтервал = один раз
сигнал=1
# немає інтервалу, перевірте лише SIGRTMIN+1

Ось приклад дуже мінімалістичної конфігурації, припускаючи, що у вас є купа скриптів
~/bin/blocks/ з такою ж назвою, що й блоки:

command =~/bin/blocks/$BLOCK_NAME
інтервал=1

[безкоштовно]
[wifi]
[ethernet]
[батарея]
[ЦП]
[дата, час]

Використовуйте i3block онлайн за допомогою служб onworks.net