i3blocks - онлайн в облаке

ПРОГРАММА:

ИМЯ

i3блоки - Гибкий планировщик для i3bar

СИНТАКСИС

i3блоки [-с файл конфигурации] [-v] ... [-h] [-V]

ОПИСАНИЕ

i3блоки позволяет легко описывать блоки в простом формате и генерировать статус
линия для i3bar(1). Он обрабатывает клики, сигналы и временной интервал для пользовательских скриптов.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

-c файл конфигурации
Задает альтернативный путь к файлу конфигурации. По умолчанию i3blocks ищет
файлы конфигурации в следующем порядке (обратите внимание, что / и т.д. может иметь префикс
/ USR / местные в зависимости от флагов компиляции):

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-файл. Каждый раздел описывает новый блок. Линия
начиная с # Знак - это комментарий, пустые строки игнорируются. Недвижимость - это
ключ = значение пара в строке, без пробелов вокруг знака равенства. Объекты, заявленные за пределами
блок (т.е. в начале файла) описывает глобальные настройки.

Вот пример файла конфигурации:

# Это комментарий
interval = 5
цвет = # 00FF00

[Погода]
команда =~ / bin / weather.pl
interval = 1800

[время]
команда = дата +% T

Чтобы использовать i3blocks в качестве строки состояния, определите его в бар блок вашего ~ / i3 / config файл:

бар {
status_command i3blocks
}

BLOCK / БЛОК

Свойства, используемые для описания блока, - это ключи, указанные в протоколе i3bar.
http://i3wm.org/docs/i3bar-protocol.html, плюс дополнительные свойства, используемые i3блоки в
описать, когда и как обновлять блок. Все поддерживаемые свойства описаны ниже.

Следующие клавиши являются стандартными, см. http://i3wm.org/docs/i3bar-protocol.html для получения информации.

· полный текст

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

· цвет

· минимальная_ширина

· выравнивать

· имя

· пример

· срочный

· разделитель

· separator_block_width

· наценка

Следующие ключи относятся к i3блоки.

команду
Команда, выполняемая оболочкой, используемая для обновления блока. Ожидаемое поведение
описано ниже, в КОМАНДА .

интервал
Если это положительное целое число, то блок создается при запуске, и значение равно
используется как временной интервал в секундах для планирования будущих обновлений. Если не указано или 0,
блок не будет выполняться при запуске (что полезно для имитации кнопок). Если
«один раз» (или -1), блок будет выполняться только при запуске (обратите внимание, что щелчок или
signal по-прежнему будет запускать обновление). Если "повтор" (или -2), блок будет
появляется при запуске, и как только он завершается (полезно повторить блокировку
команды). Используйте с осторожностью! Если "сохраняться" (или -3), блок будет выполняться только
при запуске и обновляется, как только выводит строку. Таким образом ограничивается одной строкой
обновления.

сигнал Номер сигнала, используемый для обновления блока. Все в режиме реального времени (думайте о приоритетах
и в очереди) доступны пользователю. Номер действителен от 1 до
N, где SIGRTMIN + N = SIGRTMAX. (Примечание: в Linux есть 31 сигнал реального времени.)
Например, сигнал = 10 означает, что этот блок будет обновлен, когда i3блоки
получает SIGRTMIN + 10.

этикетка Необязательная метка для предварительного добавления к полный текст после обновления.

формат Это свойство определяет формат выходного текста. Формат по умолчанию - простой
текст, как описано в КОМАНДА раздел. Если используется "json" (или 1), блок
вывод анализируется как JSON.

КОМАНДА

Значение команду key будет передан и выполнен оболочкой.

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

1. полный_текст

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

3. цвет

Например, этот скрипт устанавливает полный текст синим, но нет короткий_текст:

echo "Вот мой ярлык"
эхо
эхо \ # 0000FF

Если командная строка возвращает 0 или 33, блок обновляется. В противном случае это считается
ошибка и первая строка (если есть) все еще отображается. Обратите внимание, что stderr игнорируется. А
код возврата 33 установит срочный значение true.

Например, этот сценарий печатает процент заряда батареи и устанавливает флаг срочности, если он
ниже 10%:

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

echo "BAT: $ BAT"
test $ {BAT%?} -le 10 && exit 33 || выход 0

При разветвлении команды блока, i3блоки установит среду с некоторыми БЛОКИРОВАТЬ_*
переменные. Всегда предоставляются следующие переменные, в конечном итоге с пустой строкой как
Значение.

БЛОК_ИМЯ
Название блока (обычно название раздела).

БЛОК_ИНСТАНЦИЯ
Необязательный аргумент сценария.

BLOCK_BUTTON
Кнопка мыши (1, 2 или 3), если был нажат блок.

БЛОК_X и БЛОК_Y
Координаты, где произошел щелчок, если щелкнули блок.

Вот пример использования окружения:

[блокировать]
command = echo name = экземпляр $ BLOCK_NAME = $ BLOCK_INSTANCE
interval = 1

[нажми на меня]
full_text = Щелкните меня!
команда = кнопка эха = $ BLOCK_BUTTON x = $ BLOCK_X y = $ BLOCK_Y
min_width = button = 1 x = 1366 y = 768
ALIGN = левый

Обратите внимание, что i3блоки предоставляет набор дополнительных скриптов для удобства, например, сетевой
состояние, проверка батареи, загрузка процессора, громкость и т. д.

ПРИМЕРЫ

В качестве примера приведем конфигурацию, близкую к i3status(1) настройки по умолчанию:

TODO

interval = 5
сигнал = 10

[ipv6]

[свободно]

[DHCP]

[ВПН]

[вай фай]

[Ethernet]
min_width = E: 255.255.255.255 (1000 Мбит / с)

[аккумулятор]

[Процессор]

[дата и время]

В следующем блоке показано использование сигнал с некоторыми i3(1) крепления, регулирующие
том, перед выпуском убийство -RTMIN + 1 i3блоки:

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

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

команда =~ / bin / блоки /$ BLOCK_NAME
interval = 1

[свободно]
[вай фай]
[Ethernet]
[аккумулятор]
[Процессор]
[дата и время]

Используйте i3blocks онлайн с помощью сервисов onworks.net