i3status - Онлайн в облаке

ПРОГРАММА:

ИМЯ

i3status - генерирует строку состояния для i3bar, dzen2, xmobar или lemonbar

СИНТАКСИС

i3status [-c файл конфигурации] [-h] [-v]

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

-c
Задает альтернативный путь к файлу конфигурации. По умолчанию i3status ищет
файлы конфигурации в следующем порядке:

1. ~ / .i3status.conf

2. ~ / .config / i3status / config (или $ XDG_CONFIG_HOME / i3status / config, если установлено)

3. /etc/i3status.conf

4. / etc / xdg / i3status / config (или $ XDG_CONFIG_DIRS / i3status / config, если задано)

ОПИСАНИЕ

i3status - небольшая программа (около 1500 SLOC) для создания строки состояния для i3bar,
dzen2, xmobar, lemonbar или аналогичные программы. Он разработан, чтобы быть очень эффективным
выдача очень небольшого количества системных вызовов, поскольку обычно требуется обновить такой
строка состояния каждую секунду. Это гарантирует, что даже при высокой нагрузке ваша строка состояния будет
обновился правильно. Кроме того, это экономит немного энергии, не перегружая ваш процессор так сильно, как
порождение соответствующего количества команд оболочки.

КОНФИГУРАЦИЯ

Основная идея i3status заключается в том, что вы можете указать, какие «модули» следует использовать (
директива заказа). Затем вы можете настроить каждый модуль с его собственным разделом. Для каждого
модуль, вы можете указать формат вывода. См. Ниже полную ссылку.

Образец конфигурация.

Общее {
output_format = "dzen2"
цвета = правда
интервал = 5
}

заказ + = "ipv6"
заказ + = "диск /"
order + = "run_watch DHCP"
заказ + = "run_watch VPNC"
заказ + = "path_exists VPN"
заказ + = "беспроводной wlan0"
заказ + = "ethernet eth0"
заказ + = "батарея 0"
order + = "cpu_temperature 0"
заказ + = "загрузка"
заказ + = "tztime local"
заказ + = "tztime berlin"

беспроводная сеть0 {
format_up = "W: (% качество при% essid,% битрейт)% ip"
format_down = "W: вниз"
}

Ethernet eth0 {
# если вы используете% скорости, i3status требует возможности cap_net_admin
format_up = "E:% ip (% скорости)"
format_down = "E: вниз"
}

батарея 0 {
format = "% статус% процент% оставшееся время% пустое время"
format_down = "Нет батареи"
status_chr = "⚇ CHR"
status_bat = "⚡ BAT"
status_full = "☻ ПОЛНЫЙ"
путь = "/ sys / class / power_supply / BAT% d / uevent"
низкий_порог = 10
}

run_watch DHCP {
pidfile = "/var/run/dhclient*.pid"
}

run_watch VPNC {
# файл, содержащий PID процесса vpnc
pidfile = "/ var / run / vpnc / pid"
}

path_exists VPN {
# путь существует, когда активен VPN-туннель, запущенный nmcli / nm-applet
путь = "/ proc / sys / net / ipv4 / conf / tun0"
}

местное время {
format = "% Y-% m-% d% H:% M:% S"
}

tztime берлин {
format = "% Y-% m-% d% H:% M:% S% Z"
timezone = "Европа / Берлин"
}

нагрузка {
format = "% 5min"
}

температура_процессора 0 {
format = "T:% градусов ° C"
путь = "/sys/devices/platform/coretemp.0/temp1_input"
}

disk "/" {
format = "% бесплатно"
}

Общие
Директива цветов отключит все цвета, если вы установите для нее значение false. Вы также можете указать
цвета, которые будут использоваться для отображения "хороших", "ухудшенных" или "плохих" значений с помощью
color_good, color_degraded или color_bad соответственно. Эти директивы
используется только в том случае, если поддержка цвета не отключена директивой цветов. Формат ввода для
значения цвета - канонический шестнадцатеричный триплет RGB (без разделителей между
цвета) с префиксом решетки ("#").

Пример конфигурация:

color_good = "# 00FF00"

Точно так же вы можете использовать директиву color_separator, чтобы указать цвет, который будет использоваться.
покрасить разделительную планку. Разделитель всегда выводится в цвете, даже если цвета
отключено директивой цветов. Этот параметр не действует, если для output_format установлено значение
i3bar или нет.

Директива interval указывает время в секундах, в течение которого i3status будет спать перед
печать следующей строки состояния.

Используя output_format, вы можете выбрать, какие строки формата i3status должен использовать в своем выводе.
В настоящее время доступны:

i3bar
i3bar поставляется с i3 и предоставляет панель рабочего пространства, которая делает правильные вещи в
ситуации с несколькими мониторами. Он также поддерживает лоток и может отображать i3status.
вывод. Этот тип вывода использует JSON для передачи в i3bar столько метаинформации, сколько
возможно (например, цвета, какие блоки можно укорачивать и т. д.).

дзен2
Dzen - это универсальная программа для обмена сообщениями, уведомлениями и меню для X11. Это было
разработан для написания сценариев на любом языке и хорошо интегрируется с оконными менеджерами, такими как
dwm, wmii и xmonad, хотя он будет работать с любым оконным менеджером

хмобар
xmobar - это минималистичная текстовая строка состояния. Он был разработан для работы с
xmonad оконный менеджер.

лимонный бар
Lemonbar - это легкий батончик, полностью основанный на XCB. Он имеет полную поддержку UTF-8 и
Соответствует EWMH.

срок
Используйте escape-последовательности ANSI, чтобы получить вывод терминала, максимально приближенный к
графические выходы. Это немного упрощает отладку вашего файла конфигурации, потому что
вывод терминала i3status становится более читаемым, но его следует использовать только для
такие быстрые взгляды, потому что он будет поддерживать только самые основные функции вывода (для
Например, вы получаете только 3 бита глубины цвета).

нет
Не использует никаких цветовых кодов. По умолчанию значения разделяются вертикальной чертой. Этот
должен использоваться с i3bar и может использоваться для пользовательских скриптов.

Также можно использовать директивы color_good, color_degraded, color_bad для определения
определенные цвета для каждого модуля. Если одна из этих директив определена в разделе модуля, ее
value заменит значение, определенное в общем разделе только для этого модуля.

Если вам не нравятся вертикальные разделители между модулями, которые i3status / i3bar использует по умолчанию,
вы можете использовать директиву разделителя, чтобы настроить разделение модулей. Ты сможешь
либо полностью отключить разделитель по умолчанию, установив для него пустую строку. Ты мог бы
затем определите разделение как часть строки формата модуля. Это ваш единственный вариант, когда
использование формата вывода i3bar в качестве разделителя рисуется непосредственно i3bar в противном случае. За
другие форматы вывода, предоставленная непустая строка будет автоматически заключена
с необходимыми цветными битами, если включена поддержка цвета.

i3bar поддерживает разметку Pango, позволяя строкам формата указывать цвет шрифта, размер и
и т. д., установив для директивы разметки значение «pango». Обратите внимание, что амперсанд ("&"), меньше чем
("<"), символы "больше" (">"), одинарные кавычки ("'") и двойные кавычки ("" ") должны быть
заменить на "&", "<", ">", "'" и "" "соответственно. Это
выполняется автоматически для сгенерированного контента (например, беспроводной ESSID, время).

Пример конфигурация:

Общее {
output_format = "xmobar"
разделитель = ""
}

заказ + = "загрузка"
заказ + = "диск /"

нагрузка {
format = "[загрузка:% 1min,% 5min,% 15min]"
}
disk "/" {
format = "% avail"
}

IPv6
Этот модуль получает IPv6-адрес, используемый для исходящих соединений (то есть лучший
доступный общедоступный IPv6-адрес на вашем компьютере).

Пример format_up:% ip

Пример format_down: нет IPv6

Диск
Получает использованные, свободные, доступные и общее количество байтов в данной смонтированной файловой системе.

Эти значения также могут быть выражены в процентах с помощью percent_used,
форматы проценты_свободно, процент_доступности и процент_использованной_доступности.

Размеры байтов представлены в удобочитаемом формате с использованием набора префиксов, тип которых может
можно указать с помощью опции "prefix_type". Доступны три набора префиксов:

двоичный
Префиксы IEC (Ki, Mi, Gi, Ti) представляют собой степени, кратные 1024. Это
по умолчанию.

десятичная дробь
Префиксы SI (k, M, G, T) представляют собой кратные степени 1000.

изготовленный на заказ
Пользовательские префиксы (K, M, G, T) представляют собой кратные степени 1024.

Можно определить low_threshold, при котором текст на диске будет отображаться с помощью
color_bad. Тип low_threshold может иметь значение threshold_type "bytes_free", "bytes_avail",
"percent_free" или "percent_avail", где первые два могут быть добавлены
общий префикс (k, m, g, t), имеющий prefix_type. Итак, если вы настроите low_threshold на 2,
threshold_type на "gbytes_avail" и prefix_type на "binary", а оставшиеся доступные
объем дискового пространства меньше 2 ГиБ, он будет плохо окрашен. Если не указано, значение threshold_type равно
предполагается, что это "процент_средства", а нижний_порог должен быть установлен на 0, что означает отсутствие
окраска вообще.

Вы можете определить другой формат с помощью опции "format_not_mounted", которая используется, если
путь не существует или не является точкой монтирования. Таким образом, вы можете просто очистить вывод для
заданный путь с добавлением format_not_mounted = "" в раздел конфигурации.

Пример заказ: диск / mnt / usbstick

Пример формат:% бесплатно (% доступности) /% всего

Пример формат: использовано% процент_использовано, свободно% процент_бесплатно, доступно% процент_авил

Пример префикс_тип: обычай

Пример низкий_порог: 5

Пример порог_тип: percent_free

Беги-часы
Расширяет указанный путь к pidfile и проверяет, действителен ли найденный внутри идентификатор процесса
(то есть, если процесс запущен). Вы можете использовать это, чтобы проверить, работает ли конкретное приложение
например, VPN-клиент или ваш DHCP-клиент. Также есть вариант
"формат_вниз". Вы можете скрыть вывод с помощью format_down = "".

Пример заказ: запустить_смотреть DHCP

Пример формат:% title:% статус

Путь существует
Проверяет, существует ли указанный путь в файловой системе. Вы можете использовать это, чтобы проверить,
активен, как, например, туннель VPN, управляемый NetworkManager. Также есть
опция «format_down». Вы можете скрыть вывод с помощью format_down = "".

Пример заказ: путь_существует VPN

Пример формат:% title:% статус

Беспроводной сети
Получает качество связи, частоту и ESSID данного интерфейса беспроводной сети. Ты
может указывать разные форматные строки для подключаемой или неподключенной сети.

Специальное имя интерфейса _first_ будет заменено на первую беспроводную сеть.
интерфейс, найденный в системе (за исключением устройств, начинающихся с "lo").

Пример заказ: беспроводной wlan0

Пример формат: W: (% качество при% essid,% битрейт /% частота)% ip

Ethernet
Получает IP-адрес и (если возможно) скорость соединения данного интерфейса Ethernet.
Для получения скорости соединения требуется возможность cap_net_admin. Установите его с помощью setcap
cap_net_admin = ep $ (который i3status).

Специальное имя интерфейса _first_ будет заменено на первую не беспроводную сеть.
интерфейс, найденный в системе (за исключением устройств, начинающихся с "lo").

Пример заказ: Ethernet eth0

Пример формат: E:% ip (% скорости)

Аккумулятор
Получает статус (зарядка, разрядка, работа), процент, оставшееся время и мощность
потребление (в ваттах) данной батареи и когда она оценивается как разряженная. если ты
хотите использовать последнюю полную мощность вместо проектной (при использовании расчетной
емкости, может случиться так, что ваша батарея полностью заряжена на 23%, потому что она старая.
В общем, я хочу видеть это таким, потому что он говорит мне, насколько разряжена моя батарея.),
просто укажите last_full_capacity = true. Вы можете скрыть секунды в оставшемся времени и
оценки пустого времени, установив hide_seconds = true.

Если вы хотите, чтобы процент заряда батареи отображался без десятичных знаков, добавьте
целочисленная_батарея_емкость = истина.

Если ваша батарея представлена ​​нестандартным путем в / sysобязательно измените
"path" соответственно, т.е. указывающий на файл uevent в вашей системе. Первое
появление% d заменяется номером батареи, но вы можете просто жестко запрограммировать путь
так же.

Можно определить low_threshold, при котором текст батареи будет окрашен в красный цвет.
Тип low_threshold может иметь значение threshold_type «время» или «процент». Итак, если вы
настройте low_threshold на 10 и threshold_type на "время", и вашей батареи хватит еще на один
9 минут, он станет красным.

При желании пользовательские строки, включая любые символы UTF-8, могут использоваться для разных батарей
состояния. Это позволяет отображать отдельные символы для каждого состояния (зарядка,
разряжающийся, полный) Конечно, он также будет работать со специальными иконическими шрифтами, такими как
FontAwesome. Если какая-либо из этих специальных строк состояния опущена, значение по умолчанию (CHR, BAT,
ПОЛНЫЙ).

Пример заказ: аккумулятор 0

Пример формат:% status% Осталось (% пустого времени% потребления)

Пример format_down: Нет батареи

Пример status_chr: ⚇ ЧР

Пример status_bat: ⚡ БАТ

Пример статус_полный: ☻ ПОЛНЫЙ

Пример низкий_порог: 30

Пример порог_тип: время

Пример путь: / система / класс / power_supply / CMB1 / uevent

CPU-Температура
Получает температуру данной тепловой зоны. Можно определить max_threshold
который окрасит температуру в красный цвет в случае, если указанная тепловая зона станет слишком горячей.
По умолчанию 75 градусов C.

Пример заказ: температура_процессора 0

Пример формат: T:% градусов ° C

Пример максимальный_порог: 42

Пример путь: /sys/устройства/платформа/coretemp.0/temp1_input

ЦП Применение
Получает процентное использование ЦП из / proc / stat (Linux) или Sysctl(3) (FreeBSD / OpenBSD).

Пример заказ: использование процессора

Пример формат: %использование

нагрузка
Получает загрузку системы (количество процессов, ожидающих процессорного времени за последние 1, 5 и 15
минут). Можно определить max_threshold, который будет окрашивать значение нагрузки в красный цвет в
если средняя загрузка за последнюю минуту становится выше настроенного порога.
По умолчанию 5.

Пример заказ: нагрузка

Пример формат:% 1мин% 5мин% 15мин

Пример максимальный_порог: "0,1"

Дата
Выводит текущее время в местном часовом поясе. Чтобы использовать другой часовой пояс, вы можете установить
переменную окружения TZ или используйте модуль tztime. Видеть стрфтайм(3) для получения подробной информации о
строка формата.

Пример заказ: время

Пример формат:% Y-% m-% d% H:% M:% S

ТзВремя
Выводит текущее время в указанном часовом поясе. Если часовой пояс не указан, местное время будет
использоваться. Видеть стрфтайм(3) для получения подробной информации о строке формата. База данных часовых поясов системы
обычно устанавливается в / usr / share / zoneinfo. Файлы ниже этого пути соответствуют действительному часовому поясу
строки, например, для / usr / share / zoneinfo / Европа / Берлин вы можете установить часовой пояс в Европу / Берлин
в модуле tztime.

Пример заказ: tztime берлин

Пример формат:% Y-% m-% d% H:% M:% S% Z

Пример часовой пояс: Европа / Берлин

Если вы хотите использовать разметку в этом разделе, есть отдельная опция format_time.
который автоматически экранируется. Затем его вывод заменяет% time в строке формата.

Пример конфигурация (разметка):

время tztime {
format = " время: % времени"
format_time = "% H:% M% Z"
}

Дата
Выводит текущую дату в дискордиане в указанном пользователем формате. Видеть ddate(1) подробнее о
строка формата. Внимание: Ни %. ни %X еще не реализованы.

Пример заказ: ддата

Пример формат:% {% a,% b% d%},% Y% N -% H

Объём
Выводит громкость указанного микшера на указанном устройстве. PulseAudio и ALSA
(Только Linux) поддерживаются. Если PulseAudio отсутствует, можно использовать упрощенную конфигурацию.
используется во FreeBSD и OpenBSD из-за отсутствия ALSA, параметры устройства и микшера могут быть
игнорируется в этих системах. В этих системах вместо этого используется OSS API для запроса / dev / Mixer.
напрямую, если Mixer_idx равен -1, в противном случае / dev / Mixer + Mixer_idx +.

Чтобы получить информацию о громкости PulseAudio, необходимо использовать в устройстве следующий формат
строки:

устройство = "импульс"

or

device = "pulse: N"

где N - индекс приемника PulseAudio. Если приемник не указан, используется значение по умолчанию.
Если строка устройства отсутствует или установлена ​​на «по умолчанию», PulseAudio будет пробовать, если
обнаружен и вернется к ALSA (Linux) или OSS (FreeBSD / OpenBSD).

Пример заказ: мастер громкости

Пример формат: ♪:% объема

Пример format_muted: ♪: 0 %%

Пример конфигурация:

мастер громкости {
format = "♪:% объема"
format_muted = "♪: без звука (% громкости)"
устройство = "по умолчанию"
Mixer = "Мастер"
Mixer_idx = 0
}

Пример конфигурация (Импульсный звук):

мастер громкости {
format = "♪:% объема"
format_muted = "♪: без звука (% громкости)"
устройство = "импульс: 1"
}

УНИВЕРСАЛЬНЫЙ МОДУЛЬ ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

При использовании формата вывода i3bar можно использовать несколько дополнительных параметров.
со всеми модулями, чтобы настроить их внешний вид:

выравнивать
Политика выравнивания, используемая, когда минимальная ширина (см. Ниже) не достигается. Либо
по центру (по умолчанию), вправо или влево.

минимальная_ширина
Минимальная ширина (в пикселях), которую должен занимать модуль. Если модуль занимает меньше места
чем указанный размер, блок будет дополнен слева и / или справа,
в соответствии с установленной политикой согласования. Это полезно, если вы хотите предотвратить
вся строка состояния от смещения, когда значения занимают больше или меньше места между каждым
итерация. Параметр также может быть строкой. В этом случае ширина данного текста
определяет минимальную ширину блока. Это полезно, если вы хотите установить
разумная минимальная ширина независимо от того, какой шрифт вы используете и в каком конкретном
размер. Обратите внимание, что число, заключенное в кавычки, по-прежнему будет рассматриваться как
номер.

Пример конфигурация:

disk "/" {
format = "% avail"
align = "влево"
минимальная_ширина = 100
}

С ПОМОЩЬЮ I3СТАТУС ДЗЕН2

После установки dzen2 вы можете напрямую использовать его с i3status. Просто убедитесь, что
output_format установлен в dzen2.

Пример для пользования of i3status дзен2:

i3status | dzen2 -fg белый -ta r -w 1280 \
-fn "-misc-fixed-medium-r-normal--13-120-75-75-C-70-iso8859-1"

С ПОМОЩЬЮ I3СТАТУС ХМОБАР

Чтобы запустить xmobar, вам может потребоваться скопировать файл конфигурации по умолчанию в
~ / .xmobarrc. Также убедитесь, что для параметра output_format для i3status установлено значение xmobar.

Пример для пользования of i3status хмобар:

i3status | xmobar -o -t "% StdinReader%" -c "[Запустить StdinReader]"

ЧТО О НАС ПАМЯТЬ ИСПОЛЬЗОВАНИЕ OR ЦП ЧАСТОТА?

Говоря о двух конкретных вещах, пожалуйста, воспринимайте этот раздел как общий
объяснение, почему ваша любимая информация не включена в i3status.

Поговорим конкретно об использовании памяти. Трудно измерить память так, чтобы
точный или содержательный. Глубокое понимание того, как работает подкачка и виртуальная память в
требуется ваша операционная система. Более того, даже если бы у нас был четко определенный способ
отображение использования памяти, и вы бы это поняли, я думаю, что это бесполезно
постоянно контролировать использование памяти. Одна из причин этого в том, что у меня не закончились
память за последние несколько лет. Память стала настолько дешевой, что даже у меня в 4 года
Ноутбук, у меня 8 ГиБ ОЗУ. Другая причина заключается в том, что ваша операционная система будет выполнять
все равно правильно: либо у вас недостаточно оперативной памяти для вашей рабочей нагрузки, но вам нужно сделать
в любом случае, ваша операционная система поменяется местами. Или вам не хватает оперативной памяти и вы хотите
чтобы ограничить вашу рабочую нагрузку так, чтобы она соответствовала, тогда операционная система убьет процесс
используя слишком много оперативной памяти, и вы можете действовать соответственно.

По частоте процессора ситуация аналогичная. Многие люди не понимают, как частота
масштабирование работает точно. Обычно рекомендуемый регулятор частоты процессора ("ondemand")
изменяет частоту процессора гораздо чаще, чем i3status может это отображать. Дисплей
поэтому номер часто бывает неверным и тоже не говорит вам ничего полезного.

В общем, i3status хочет отображать то, на что вы в любом случае время от времени будете смотреть,
например, текущая дата / время, подключены ли вы к сети Wi-Fi или нет, и если вы
достаточно места на диске для загрузки 4.3 ГиБ.

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

ВНЕШНИЙ ВИД ЗДАНИЯ СКРИПТЫ / ПРОГРАММЫ I3СТАТУС

В i3status мы не хотим снова внедрять управление процессами. Следовательно, нет
модуль для запуска произвольных скриптов или команд. Вместо этого вы должны использовать свою оболочку для
пример вроде этого:

Пример для добавление i3status выходной:

#!/ Бен / ш
# сценарий оболочки для добавления к i3status дополнительных сведений

i3status | пока :
do
читать строку
echo "mystuff | $ line" || выход 1
сделанный

Поместите это в какой-нибудь скрипт, скажем .bin / my_i3status.sh, и выполните его вместо i3status.

Обратите внимание: если вы хотите использовать выходной формат JSON (с цветами в i3bar), вам необходимо
используйте немного более сложный сценарий-оболочку. В папке contrib / есть примеры, см.
http://code.i3wm.org/i3status/tree/contrib

СИГНАЛЫ

При получении SIGUSR1, функция nanosleep () i3status будет прервана, и вы заставите
обновление. Вы можете использовать killall -USR1 i3status для принудительного обновления после изменения системы
объем, например.

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