--- category: ru type: paper hastr: true layout: paper tags: awesome-widgets, pytextmonitor title: Awesome Widgets - свистелки и перделки short: aw-v21-bells-and-whistles description: Данная статья посвящена обсуждению настройки своих скриптов и графических баров в новой версии Awesome Widgets (2.1). ---

## Введение

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

## Общее

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

## Бары

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

Поле | Обязательное | Значение | По-умолчанию
--- | --- | --- | ---
Name | да | имя бара. Должно иметь вид `barN` и быть уникальным | none
Comment | нет | комментарий | empty
X-AW-Value | да | значение бара. Доступны теги `cpu*`, `gpu`, `mem`, `swap`, `hdd*`, `bat` | cpu
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
X-AW-Number | да | уникальный номер, который будет ассоциирован с данным баром. Введено для совместимости с другими расширениями. Должно быть такое же, как и в поле Name | число из Name

## Котировки

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

Поле | Обязательное | Значение | По-умолчанию
--- | --- | --- | ---
Name | да | имя котировок | none
Comment | нет | комментарий | empty
X-AW-Ticker | да | тикер из системы Yahoo! Finance | EURUSD=X
X-AW-Active | нет | активны или нет данные котировки | true
X-AW-Interval | да | интервал запуска котировок в стандартных интервалах обновления виджета | 1
X-AW-Number | да | уникальный номер, который будет ассоциирован с данными котировками | случайное число меньше 1000

## Скрипты

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

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

## Обновления

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

Поле | Обязательное | Значение | По-умолчанию
--- | --- | --- | ---
Name | да | имя скрипта обновлений | none
Comment | нет | комментарий | empty
Exec | да | путь к исполняемому файлу | /usr/bin/true
X-AW-Filter | нет | регулярное выражение, которое будет применено к выдаче команды. Если не пустое, параметр `X-AW-Null` будет проигнорирован |
X-AW-Active | нет | активен или нет данный скрипт обновления | true
X-AW-Null | нет | число строк stdout, которые будут пропущены при подсчете | 0
X-AW-Interval | да | интервал запуска скрипта в стандартных интервалах обновления виджета | 1
X-AW-Number | да | уникальный номер, который будет ассоциирован с данным скриптом | случайное число меньше 1000

## Погода

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

Поле | Обязательное | Значение | По-умолчанию
--- | --- | --- | ---
Name | да | имя погоды | none
Comment | нет | комментарий | empty
X-AW-City | да | город | London
X-AW-Country | да | двухбуквенное обозначения страны | uk
X-AW-Image | нет | использовать изображения в качестве иконки погоды или текст | uk
X-AW-TS | да | на какое время прогноз (целое число). `0` - текущая погода, `1` - погода через 3 часа и т.д. | 0
X-AW-Active | нет | активен или нет данный монитор погоды | true
X-AW-Interval | да | интервал запуска монитора в стандартных интервалах обновления виджета | 1
X-AW-Number | да | уникальный номер, который будет ассоциирован с данным монитором | случайное число меньше 1000