diff --git a/_posts/2014-12-19-aw-2.1-bells-and-whistles.html b/_posts/2014-12-19-aw-2.1-bells-and-whistles.html new file mode 100644 index 0000000..5c81eaf --- /dev/null +++ b/_posts/2014-12-19-aw-2.1-bells-and-whistles.html @@ -0,0 +1,138 @@ +--- +category: en +type: paper +hastr: true +layout: paper +tags: awesome-widgets, pytextmonitor +title: Awesome Widgets 2.1: bells and whistles +short: aw-2.1-bells-and-whistles +description: The paper deals with settings of a custom scripts and graphical bars in the new version of Awesome Widgets (2.1). +--- +
For a start it is highly recommended copy file $HOME/.kde4/share/config/extsysmon.conf
after widget update before you open widget settings, because old and new script settings are incompatible. Also I should note that these features can be configured from graphical interface, but I will describe how it can be done by simply editing the desktop file.
Bars are stored in the two directories: /usr/share/apps/plasma_applet_awesome-widget/desktops/
and $HOME/.kde4/share/apps/plasma_applet_awesome-widget/desktops/
(path may be differ in depend from your distro). Settings in the home directory have a higher priority that global ones. Configuration files have the following fields:
Field | +Required | +Value | +Default | +
---|---|---|---|
Name | +yes | +bar name. It should be as barN and should be unique |
+ none | +
Comment | +no | +comment | +empty | +
X-AW-Value | +yes | +bar value. The following tags are available cpu* , gpu , mem , swap , hdd* , bat |
+ cpu | +
X-AW-ActiveColor | +yes | +active part fill in format R,G,B,A |
+ 0,0,0,130 | +
X-AW-InactiveColor | +yes | +inactive part fill in format R,G,B,A |
+ 255,255,255,130 | +
X-AW-Type | +yes | +bar type. The following types are supported Horizontal , Vertical , Circle |
+ Horizontal | +
X-AW-Direction | +yes | +the fill direction. The following variants are supported LeftToRight , RightToLeft |
+ LeftToRight | +
X-AW-Height | +yes | +height, pixels | +100 | +
X-AW-Width | +yes | +width, pixels | +100 | +
Scripts are stored in the two directories: /usr/share/apps/plasma_engine_extsysmon/scripts/
and $HOME/.kde4/share/apps/plasma_engine_extsysmon/scripts/
(path may be differ in depend from your distro). Settings in the home directory have a higher priority that global ones. To enable script you should type it on the output field. Configuration files have the following fields:
Field | +Required | +Value | +Default | +
---|---|---|---|
Name | +yes | +script name | +none | +
Comment | +no | +comment | +empty | +
Exec | +yes | +path to executable file | +/usr/bin/true | +
X-AW-Prefix | +no | +prefix to executable file. Usually it's not required, but in other you may want to specify interpretor for example. | ++ |
X-AW-Active | +no | +whether or not the script is active | +true | +
X-AW-Output | +no | +whether or not the script has output to console. You may set it to false if you want use the script as cron jobs |
+ true | +
X-AW-Redirect | +no | +stream redirection. The following variants are available stderr2stdout , nothing , stdout2stderr . stderr will be enabled, if you run application with DEBUG=yes |
+ nothing | +
X-AW-Interval | +no | +update interval in standard widget intervals | +1 | +
Для начала, я настоятельно рекомендую для после обновления не открывая настроек виджета скопировать в безопасное место файл $HOME/.kde4/share/config/extsysmon.conf
, так как старые настройки кастомных скриптов теперь несовместимы. Вообще, следует заметить, что обе новых фичи можно настраивать и из графического интерфейса, однако я опишу, как это делается простым редактированием desktop файлов.
Бары хранятся в двух директориях: /usr/share/apps/plasma_applet_awesome-widget/desktops/
и $HOME/.kde4/share/apps/plasma_applet_awesome-widget/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 |
+ Horizontal | +
X-AW-Direction | +да | +направление заполнения. Доступны варианты LeftToRight , RightToLeft |
+ LeftToRight | +
X-AW-Height | +да | +высота в пикселях | +100 | +
X-AW-Width | +да | +ширина в пикселях | +100 | +
Скрипты хранятся в двух директориях: /usr/share/apps/plasma_engine_extsysmon/scripts/
и $HOME/.kde4/share/apps/pplasma_engine_extsysmon/scripts/
(пути могут немного отличаться в зависимости от используемого дистрибутива). Настройки в домашней директории перезаписывают глобальные настройки. Для того, чтобы активировать скрипт необходимо прописать нужный тег в поле вывода. Файлы настроек имеют следующие поля:
Поле | +Обязательное | +Значение | +По-умолчанию | +
---|---|---|---|
Name | +да | +имя скрипта | +none | +
Comment | +нет | +комментарий | +empty | +
Exec | +да | +путь к исполняемому файлу | +/usr/bin/true | +
X-AW-Prefix | +нет | +префикс к исполняемому файлу. Обычно не требуется, однако в отдельных случаях может потребоваться явно указать путь, например, к используемому интерпретатору | ++ |
X-AW-Active | +нет | +активен или нет данный скрипт | +true | +
X-AW-Output | +нет | +имеет ли данный скрипт сообщения в консоль. Полезно выставить в false , если вы хотите использовать скрипт, как аналог задач в cron |
+ true | +
X-AW-Redirect | +нет | +перенаправление потоков сообщений. Доступны варианты stderr2stdout , nothing , stdout2stderr . stderr доступен, если запустить с DEBUG=yes |
+ nothing | +
X-AW-Interval | +да | +интервал запуска скрипта в стандартных интервалах обновления виджета | +1 | +