19 дек 2014

Тeги: awesome-widgets,pytextmonitor

Похожие посты:
Как загрузить скриншот в S3 с помощью linux
Awesome Widgets - Произвольные форматеры и макросы

Awesome Widgets - свистелки и перделки

Данная статья посвящена обсуждению настройки своих скриптов и графических баров в новой версии Awesome Widgets (2.1).

Введение

Для начала, я настоятельно рекомендую для после обновления не открывая настроек виджета скопировать в безопасное место файл $HOME/.kde4/share/config/extsysmon.conf, так как старые настройки кастомных скриптов теперь несовместимы. Вообще, следует заметить, что все фичи можно настраивать и из графического интерфейса, однако я опишу, как это делается простым редактированием desktop файлов.

Общее

Все элементы хранятся в двух директориях: /usr/share/awesomewidgets/%TYPE%/ и $HOME/.local/share/awesomewidgets/%TYPE%/ (пути могут немного отличаться в зависимости от используемого дистрибутива). Настройки в домашней директории перезаписывают глобальные настройки. Общие настройки для любого расширения следующие:

Поле Обязательное Значение По-умолчанию
Name да имя none
Comment нет комментарий empty
X-AW-Active нет активно или нет данное расширение, игнорируется барами true
X-AW-ApiVersion да совместимость API. Не меняйте, если не знаете, что делаете 0
X-AW-Interval да интервал запуска расширения в стандартных интервалах обновления виджета, игнорируется барами 1
X-AW-Number да уникальный номер, который будет ассоциирован с данным расширением случайное число меньше 1000
X-AW-Schedule нет cron-like расписание обновлений. Доступные поля minutes hours days month weekdays, доступные дополнительные символы -, *, , (пусто)
X-AW-Socket нет путь к сокет-файлу. Значения будут обновлены в том случае, если сокет активирован (пусто)

Бары

Директория называется desktops, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
X-AW-Custom да содержит ли значение произвольную формулу или нет false
X-AW-Value да значение бара. Доступны теги cpu*, gpu, mem, swap, hdd*, bat. В случае X-AW-Custom=true использует синтаксис аналогичный []лямбда функциям](/ru/projects/awesome-widgets/#lambda) cpu
X-AW-Max нет максимально возможное значение 100.0
X-AW-Min нет минимально возможное значение 0.0
X-AW-Count нет число точек, используется при X-AW-Type=Graph 100
X-AW-ActiveColor да заполнение активной части в формате R,G,B,A или полный путь к изображению 0,0,0,130
X-AW-InactiveColor да заполнение неактивной части в формате R,G,B,A или полный путь к изображению 255,255,255,130
X-AW-Type да тип бара. Поддерживаемые типы Horizontal, Vertical, Circle, Graph Horizontal
X-AW-Direction да направление заполнения. Доступны варианты LeftToRight, RightToLeft LeftToRight
X-AW-Height да высота в пикселях 100
X-AW-Width да ширина в пикселях 100

Котировки

Для получения данных используется API Yahoo! Finance. Директория называется quotes, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
X-AW-Ticker да тикер из системы Yahoo! Finance EURUSD=X

Запросы

GET запрос к внешнему ресурсу. Директория называется requests, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
X-AW-Url да url для GET запроса https://httpbin.org/get

Скрипты

Директория называется scripts, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
Exec да путь к исполняемому файлу /usr/bin/true
X-AW-Prefix нет префикс к исполняемому файлу. Обычно не требуется, однако в отдельных случаях может потребоваться явно указать путь, например, к используемому интерпретатору
X-AW-Redirect нет перенаправление потоков сообщений. Доступны варианты stderr2stdout, nothing, stdout2stderr, swap. stderr доступен, если запустить в режиме отладки nothing
X-AW-Filters нет фильтры из awesomewidgets-extscripts-filters.json разделенные запятой

Обновления

Директория называется upgrade, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
Exec да путь к исполняемому файлу /usr/bin/true
X-AW-Filter нет регулярное выражение, которое будет применено к выдаче команды. Если не пустое, параметр X-AW-Null будет проигнорирован
X-AW-Null нет число строк stdout, которые будут пропущены при подсчете 0

Погода

Для показа погоды используются данные и API Yahoo! Weather. Директория называется weather, файлы настроек имеют следующие поля:

Поле Обязательное Значение По-умолчанию
X-AW-City да город London
X-AW-Country да двухбуквенное обозначения страны uk
X-AW-Image нет использовать изображения в качестве иконки погоды или текст uk
X-AW-Provider да провайдер погоды. Доступны Yahoo, OWM OWM
X-AW-TS да на какое время прогноз (целое число). 0 - текущая погода, 1 - погода через 3 часа и т.д. 0