---
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).
---
<h2><a href="#intro" class="anchor" id="intro"><span class="octicon octicon-link"></span></a>Введение</h2>
<p>Для начала, я настоятельно рекомендую для после обновления <b>не открывая настроек виджета</b> скопировать в безопасное место файл <code>$HOME/.kde4/share/config/extsysmon.conf</code>, так как старые настройки кастомных скриптов теперь несовместимы. Вообще, следует заметить, что все фичи можно настраивать и из графического интерфейса, однако я опишу, как это делается простым редактированием desktop файлов.</p>

<h2><a href="#general" class="anchor" id="general"><span class="octicon octicon-link"></span></a>Общее</h2>
<p>Все элементы хранятся в двух директориях: <code>/usr/share/awesomewidgets/%TYPE%/</code> и <code>$HOME/.local/share/awesomewidgets/%TYPE%/</code> (пути могут немного отличаться в зависимости от используемого дистрибутива). Настройки в домашней директории перезаписывают глобальные настройки.</p>

<h2><a href="#bars" class="anchor" id="bars"><span class="octicon octicon-link"></span></a>Бары</h2>
<p>Директория называется <code>desktops</code>, файлы настроек имеют следующие поля:</p>

<table>
  <tr>
    <th>Поле</th>
    <th>Обязательное</th>
    <th>Значение</th>
    <th>По-умолчанию</th>
  </tr>
  <tr>
    <th>Name</th>
    <td>да</td>
    <td>имя бара. Должно иметь вид <code>barN</code> и быть уникальным</td>
    <td>none</td>
  </tr>
  <tr>
    <th>Comment</th>
    <td>нет</td>
    <td>комментарий</td>
    <td>empty</td>
  </tr>
  <tr>
    <th>X-AW-Value</th>
    <td>да</td>
    <td>значение бара. Доступны теги <code>cpu*</code>, <code>gpu</code>, <code>mem</code>, <code>swap</code>, <code>hdd*</code>, <code>bat</code></td>
    <td>cpu</td>
  </tr>
  <tr>
    <th>X-AW-ActiveColor</th>
    <td>да</td>
    <td>заполнение активной части в формате <code>R,G,B,A</code></td>
    <td>0,0,0,130</td>
  </tr>
  <tr>
    <th>X-AW-InactiveColor</th>
    <td>да</td>
    <td>заполнение неактивной части в формате <code>R,G,B,A</code></td>
    <td>255,255,255,130</td>
  </tr>
  <tr>
    <th>X-AW-Type</th>
    <td>да</td>
    <td>тип бара. Поддерживаемые типы <code>Horizontal</code>, <code>Vertical</code>, <code>Circle</code>, <code>Graph</code></td>
    <td>Horizontal</td>
  </tr>
  <tr>
    <th>X-AW-Direction</th>
    <td>да</td>
    <td>направление заполнения. Доступны варианты <code>LeftToRight</code>, <code>RightToLeft</code></td>
    <td>LeftToRight</td>
  </tr>
  <tr>
    <th>X-AW-Height</th>
    <td>да</td>
    <td>высота в пикселях</td>
    <td>100</td>
  </tr>
  <tr>
    <th>X-AW-Width</th>
    <td>да</td>
    <td>ширина в пикселях</td>
    <td>100</td>
  </tr>
  <tr>
    <th>X-AW-Number</th>
    <td>да</td>
    <td>уникальный номер, который будет ассоциирован с данным баром. Введено для совместимости с другими расширениями. Должно быть такое же, как и в поле Name</td>
    <td>число из Name</td>
  </tr>
</table>

<h2><a href="#quotes" class="anchor" id="quotes"><span class="octicon octicon-link"></span></a>Котировки</h2>
<p>Директория называется <code>quotes</code>, файлы настроек имеют следующие поля:</p>

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

<h2><a href="#scripts" class="anchor" id="scripts"><span class="octicon octicon-link"></span></a>Скрипты</h2>
<p>Директория называется <code>scripts</code>, файлы настроек имеют следующие поля:</p>

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

<h2><a href="#upgrade" class="anchor" id="upgrade"><span class="octicon octicon-link"></span></a>Обновления</h2>
<p>Директория называется <code>upgrade</code>, файлы настроек имеют следующие поля:</p>

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

<h2><a href="#weather" class="anchor" id="weather"><span class="octicon octicon-link"></span></a>Погода</h2>
<p>Для показа погоды используются данные и API <a href="//openweathermap.org/" title="Сайт OpenWeatherMap">OpenWeatherMap</a>. Директория называется <code>weather</code>, файлы настроек имеют следующие поля:</p>

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