update aw page

This commit is contained in:
Evgenii Alekseev 2024-04-20 15:22:24 +03:00
parent 3411bf74d2
commit 952b1d707f
2 changed files with 115 additions and 242 deletions

View File

@ -29,10 +29,7 @@ links:
---
<!-- info block -->
A collection of minimalistic easily configurable Plasmoids written on `C++/Qt`,
which look like widgets in [Awesome WM](//awesome.naquadah.org/ "Awesome Homepage").
Also it provides additional system [DataEngine]
(//techbase.kde.org/Development/Tutorials/Plasma/DataEngines "Developers tutorial").
A collection of minimalistic easily configurable Plasmoids written on `C++/Qt`, which look like widgets in [Awesome WM](//awesome.naquadah.org/ "Awesome Homepage"). Also it provides additional system [DataEngine](//techbase.kde.org/Development/Tutorials/Plasma/DataEngines "Developers tutorial").
<!--more-->
@ -68,31 +65,26 @@ Special thanks:
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction
* Download an [archive](//github.com/arcan1s/awesome-widgets/releases "GitHub")
with latest version of source files.
* Download an [archive](//github.com/arcan1s/awesome-widgets/releases "GitHub") with latest version of source files.
* Extract it and install:
```bash
cd /where/is/applet/
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr ../
make
sudo make install
cmake -B build -S sources -DCMAKE_BUILD_TYPE=Release
cmake --build build
cmake --install build
```
**NOTE:** on Plasma 5 it very likely requires `-DKDE_INSTALL_USE_QT_SYS_PATHS=ON`
flag.
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies
I want note that all were tested on latest version of dependencies.
* plasma-framework
* plasma-workspace
* cmake *(make)*
* extra-cmake-modules *(make)*
* hddtemp **or** smartmontools *(optional, for HDD temperature monitor)*
* one of supported music player *(optional, for music player monitor)*
* proprietary video driver *(optional, for GPU monitor)*
* udev *(optional, GPU features)*
* wireless_tools *(optional, WiFi information)*
<!-- end of install block -->
@ -103,8 +95,7 @@ Open your Plasma widgets and select `Awesome Widget`.
### <a href="#tips" class="anchor" id="tips"><span class="octicon octicon-link"></span></a>Tips & tricks
You may use different colours inside. Just put label text into html code. See
[issue](//github.com/arcan1s/awesome-widgets/issues/9 "GitHub") for more details.
You may use different colours inside. Just put label text into html code. See [issue](//github.com/arcan1s/awesome-widgets/issues/9 "GitHub") for more details.
<!-- end of howto block -->
@ -122,9 +113,6 @@ edit it.
| | |
|----------|-----------|
| ACPIPATH | Path to ACPI devices. Default is `/sys/class/power_supply/`. |
| GPUDEV | Set GPU device. May be `nvidia` (for nVidia), `ati` (for ATI Radeon), `disable` or `auto`. Default is `auto`. |
| HDDDEV | Set block device for `hddtemp` comma separated or use `all`. `disable` will disable HDD temperature monitor. Default is `all`. |
| HDDTEMPCMD | A command which will be run for hddtemp DataEngine. Default is `sudo hddtemp`. Supported applications are `hddtemp` and `smartmontools`. |
| MPDADDRESS | MPD host address. Default is `localhost`. |
| MPDPORT | MPD host port. Default is `6600`. |
| PLAYER | Set music player. Supported players are mpd and MPRIS/DBus supported. `disable` will disable this monitor. |
@ -132,8 +120,7 @@ edit it.
### <a href="#widconf" class="anchor" id="widconf"><span class="octicon octicon-link"></span></a>Widget configuration
To edit output you need open Settings window and specify output format. HTML
tags work normally.
To edit output you need open Settings window and specify output format. HTML tags work as expected.
Available flags are in the table below.
@ -157,8 +144,9 @@ Available flags are in the table below.
| `$cpucl` | Average CPU clock, MHz, `----`. | 1.1.2 |
| `$cpuclN` | CPU clock for core N, MHz, `----`. | 1.7.0 |
| `$tempN` | Temperature for device N, `----`. For example, `$temp0`. ||
| `$gpu` | GPU usage, %, `-----`. `aticonfig` or `nvidia-smi` must be installed. | 1.3.2 |
| `$gputemp` | GPU temperature, `----`. `aticonfig` or `nvidia-smi` must be installed. | 1.3.2 |
| `$gpu` | GPU usage, %, `-----`. Requies `udev` to be installed. | 1.3.2 |
| `$gpuN` | GPU usage for device N, %, `-----`. For example, `$gpu0`. Requies `udev` to be installed. | 4.0.0 |
| `$gputempN` | GPU temperature for device N, `----`. For example, `$gputemp0`. Requies `udev` to be installed. | 4.0.0 |
| `$mem` | Memory usage, %, `-----`. ||
| `$memmb` | Memory usage, MB, `-----`. | 1.1.1 |
| `$memgb` | Memory usage, GB, `----`. | 1.7.3 |
@ -184,7 +172,6 @@ Available flags are in the table below.
| `$hddtotgbN` | Total size of mount point N, GB, `-----`. For example `$hddtotgb0`. | 1.10.0 |
| `$hddrN` | Read speed of disk N, KB/s, `-----`. For example `$hddr0`. | 1.9.0 |
| `$hddwN` | Write speed of disk N, KB/s, `-----`. For example `$hddw0`. | 1.9.0 |
| `$hddtempN` | Temperature for HDD N, `----`. For example `$hddtemp0`. `hddtemp` or `smartmontools` must be installed. | 1.7.0 |
| `$down` | Download speed for active device, KB/s or MB/s, `----`. | 1.7.0 |
| `$downkb` | Download speed for active device, KB/s, `----`. | 3.0.0 |
| `$downunits` | Download speed units for active device, `----`. | 3.0.0 |
@ -207,7 +194,15 @@ Available flags are in the table below.
| `$uptotalkbN` | Total transmitted for device N, KB, `----`. | 3.1.2 |
| `$netdev` | Current network device. | 1.1.1 |
| `$bat` | Average battery charge, %, `---`. ||
| `$batN` | Battery N charge, %, `---`. | 2.0.3 |
| `$batN` | Battery N charge, %, `---`. For example `$bat0`. | 2.0.3 |
| `$batleft` | Battery discharge time, s, `---`. | 3.4.2 |
| `$batleftN` | Battery N discharge time, s, `---`. For example `$batleft0`. | 3.4.2 |
| `$batnow` | Battery current capacity, `---`. | 3.4.2 |
| `$batnowN` | Battery N current capacity, `---`. For example `$batnow0`. | 3.4.2 |
| `$batrate` | Battery discharge rate, 1/s, `-----`. | 3.4.2 |
| `$batrateN` | Battery N discharge rate, 1/s, `-----`. For example `$batrate0`. | 3.4.2 |
| `$battotal` | Battery total capacity, `---`. | 3.4.2 |
| `$battotalN` | Battery N total capacity, `---`. For example `$battotal0`. | 3.4.2 |
| `$ac` | Status of AC device. Returns `(*)` if AC device is online or `( )` if offline. ||
| `$album` | Current song album. One of supported music players must be installed. | 1.5.3 |
| `$dalbum` | Current song album with fixed symbols count shown as a running line. | 3.0.0 |
@ -240,15 +235,16 @@ Available flags are in the table below.
| `$percaskchgN` | Get price change for ticker N, %. For example `$percpricechg0`. | 2.2.2 |
| `$weatherIdN` | Numerical weather ID. For example `$weatherId0`. | 2.4.0 |
| `$weatherN` | Weather status. For example `$weather0`. | 2.4.0 |
| `$humidityN` | Humidity, %. For example `$humidity0`. | 2.4.0 |
| `$pressureN` | Pressure, bars. For example `$pressure0`. | 2.4.0 |
| `$temperatureN` | Temperature. For example `$temperature0`. | 2.4.0 |
| `$humidityN` | Humidity, %, `---`. For example `$humidity0`. | 2.4.0 |
| `$pressureN` | Pressure, bars, `-----`. For example `$pressure0`. | 2.4.0 |
| `$temperatureN` | Temperature, `-----`. For example `$temperature0`. | 2.4.0 |
| `$brightness` | Screen brightness, %, `---` | 3.4.2 |
| `$volume` | System volume, %, `---`. | 3.4.2 |
| `$ssid` | Current WiFi ssid. `wireless_tools` must be installed. | 4.0.0 |
### <a href="#lambda" class="anchor" id="lambda"><span class="octicon octicon-link"></span></a>Lambda and template functions
Since version 3.0.0 the main widget supports lambda functions, which are
calculated at runtime. It may be declared by using `{% raw %}${{{% endraw %}
{% raw %}}}{% endraw %}` construction:
Since version 3.0.0 the main widget supports lambda functions, which are calculated at runtime. It may be declared by using `{% raw %}${{{% endraw %} {% raw %}}}{% endraw %}` construction:
```javascript
{% raw %}${{{% endraw %}
@ -260,8 +256,7 @@ three()
{% raw %}}}{% endraw %}
```
A functions inside will be interpreted as JavaScript ones, any variables from main
body is supported, thus the following function:
A functions inside will be interpreted as JavaScript ones, any variables from main body is supported, thus the following function:
```javascript
{% raw %}${{{% endraw %}
@ -276,8 +271,7 @@ colorCpu()
{% raw %}}}{% endraw %}
```
will show `$cpu` value in red if it is more than 90.0, otherwise it will be shown
in default colour. Any calculations are also supported:
will show `$cpu` value in red if it is more than 90.0, otherwise it will be shown in default colour. Any calculations are also supported:
```javascript
{% raw %}${{{% endraw %}
@ -285,10 +279,7 @@ $down - $up
{% raw %}}}{% endraw %}
```
will show difference between download and upload speed. Another feature provided
by lambda functions is `$this` value which returns the last value of the lambda
function. Here is a little more complicated example which will show running line
"Artist - Title" with length less or equal than 20 symbols:
will show difference between download and upload speed. Another feature provided by lambda functions is `$this` value which returns the last value of the lambda function. Here is a little more complicated example which will show running line "Artist - Title" with length less or equal than 20 symbols:
```javascript
{% raw %}${{{% endraw %}
@ -304,14 +295,9 @@ runningLine()
{% raw %}}}{% endraw %}
```
Thus this feature may be used for example to show any custom values which will
be calculated in runtime and to show different information depending on some
conditions. But please keep in mind that such runtime calculation may increase
CPU load.
Thus this feature may be used for example to show any custom values which will be calculated in runtime and to show different information depending on some conditions. But please keep in mind that such runtime calculation may increase CPU load.
Another feature which has been introduced with 3.1.0 is templates. It works in
the same way as lambda functions, but they are calculated only once (at the start),
e.g.:
Another feature which has been introduced with 3.1.0 is templates. It works in the same way as lambda functions, but they are calculated only once (at the start), e.g.:
```javascript
{% raw %}$template{{{% endraw %}
@ -327,13 +313,7 @@ will always show `3` and will not be calculated each time.
### <a href="#functions" class="anchor" id="functions"><span class="octicon octicon-link"></span></a>Special functions
To allow some features with lambdas and templates several internal functions
have been introduced with 3.1.0. They have the same syntax:
`$aw_function<args>{% raw %}{{{% endraw %}body{% raw %}}}{% endraw %}`.
where args may be optional. If there are several args they should be comma
separated. If you want to pass comma as arg use `$,`. If you want to use double
brackets inside body screen them by using `$`, e.g. `${`. Functions will be called
once and before any actions.
To allow some features with lambdas and templates several internal functions have been introduced with 3.1.0. They have the same syntax: `$aw_function<args>{% raw %}{{{% endraw %}body{% raw %}}}{% endraw %}`, where args may be optional. If there are several args they should be comma separated. If you want to pass comma as arg use `$,`. If you want to use double brackets inside body screen them by using `$`, e.g. `${`. Functions will be called once and before any actions.
| Function | Description | Args | Body |
|----------|-------------|------|------|
@ -346,8 +326,7 @@ once and before any actions.
### <a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Advanced settings
**Enable background:** Uncheck to disable default background and set transparent
one. Default is `true`.
**Enable background:** Uncheck to disable default background and set transparent one. Default is `true`.
**Translate strings:** Translate strings tags. Default is `true`.
@ -355,28 +334,19 @@ one. Default is `true`.
**Word wrap:** Enable word wrap. Default is `false`.
**Enable popup:** Uncheck box if you do not want popup messages on system events.
Default is `true`.
**Enable popup:** Uncheck box if you do not want popup messages on system events. Default is `true`.
**Check updates:** Check updates on load. Default is `true`.
**Optimize subscription:** Optimize work with DataEngines. Probably you don't
want change this option despite the fact that one feature will not be available.
Default is `true`.
**Optimize subscription:** Optimize work with DataEngines. Probably you don't want change this option despite the fact that one feature will not be available. Default is `true`.
**Widget height:** Disable automatic widget height definition and set it to this
value. Default is `0` (auto).
**Widget height:** Disable automatic widget height definition and set it to this value. Default is `0` (auto).
**Widget width:** Disable automatic widget width definition and set it to this
value. Default is `0` (auto).
**Widget width:** Disable automatic widget width definition and set it to this value. Default is `0` (auto).
**Update interval:** Widget update interval. Default is `1000`.
**Queue limit:** Use thread pool with this maximum thread counts. `0` means CPU
ideal thread count. Default is `0`.
**Temperature units:** Select units for temperature. Available units are Celsius,
Farenheit, Kelvin, Reaumur, cm^-1, kJ/mol, kcal/mol.
**Temperature units:** Select units for temperature. Available units are Celsius, Farenheit, Kelvin, Reaumur, cm^-1, kJ/mol, kcal/mol.
**Custom time format:**
@ -419,38 +389,21 @@ Farenheit, Kelvin, Reaumur, cm^-1, kJ/mol, kcal/mol.
**AC offline tag:** Line which will be shown when AC is offline. Default is `( )`.
**Enable remote telemetry:** Enable upload of your configuration to remote server.
**History count:** Total count of stored configurations localy.
**Telemetry ID:** Unique client ID used for remote telemetry.
### <a href="#tooltips" class="anchor" id="tooltips"><span class="octicon octicon-link"></span></a>Tooltips
Since version 1.7.0 CPU, CPU clock, memory, swap, network and battery support
graphical tooltip. To enable them just select required fields. The number of
stored values can be set in the tab. Colours of the graphs are configurable too.
Since version 1.7.0 CPU, CPU clock, memory, swap, network and battery support graphical tooltip. To enable them just select required fields. The number of stored values can be set in the tab. Colours of the graphs are configurable too.
### <a href="#deguiconf" class="anchor" id="deguiconf"><span class="octicon octicon-link"></span></a>DataEngine settings
**ACPI path:** Path to ACPI devices. The file `/sys/class/power_supply/`.
**GPU device:** Select one of supported GPU devices. `auto` will enable auto
selection, `disable` will disable all GPU monitors. Default is `auto`.
**HDD:** Select one of HDDs for HDD temperature monitor. `all` will enable
monitor for all devices, `disable` will disable HDD temperature monitor. Default
is `all`.
**hddtemp cmd:** Type a command which will be run for hddtemp DataEngine. Default
is `sudo smartctl -a`.
**Player symbol count:** Symbol count for dynamic player tags.
**Music player:** Select one of supported music players for player label.
**MPRIS:** Select MPRIS player name. `auto` will enable auto selection. Default
is `auto`.
**MPRIS:** Select MPRIS player name. `auto` will enable auto selection. Default is `auto`.
**MPD address:** Address of MPD server. Default is `localhost`.
@ -458,32 +411,25 @@ is `auto`.
### <a href="#desktoppanel" class="anchor" id="desktoppanel"><span class="octicon octicon-link"></span></a>Desktop Panel
Since version 1.11.0 it provides a minimalistic panel to control destops.
And yes, it looks like the same panel in Awesome.
Since version 1.11.0 it provides a minimalistic panel to control destops. And yes, it looks like the same panel in Awesome.
### <a href="#dpconf" class="anchor" id="dpconf"><span class="octicon octicon-link"></span></a>Desktop panel configuration
**Enable background:** Uncheck to disable default background and set transparent
one. Default is `true`.
**Enable background:** Uncheck to disable default background and set transparent one. Default is `true`.
**Vertical layout:** Use vertical layout instead of horizontal one. Default is
`false`.
**Vertical layout:** Use vertical layout instead of horizontal one. Default is `false`.
**Widget height:** Disable automatic widget height definition and set it to this
value. Default is `0` (auto).
**Widget height:** Disable automatic widget height definition and set it to this value. Default is `0` (auto).
**Widget width:** Disable automatic widget width definition and set it to this
value. Default is `0` (auto).
**Widget width:** Disable automatic widget width definition and set it to this value. Default is `0` (auto).
**Mark:** Type symbol (or string) which will be shown if this desktop is active
now.
**Mark:** Type symbol (or string) which will be shown if this desktop is active now.
**Tooltip type:** Select tooltip type. Default is `windows`.
**Tooltip type:** Select tooltip type. Default is `contours`.
**Tooltip width:** Using tooltip width in px. Default is `200px`.
**Color of tooltip:** Colour which is used in some tooltip types. Default is
`#ffffff`.
**Color of tooltip:** Colour which is used in some tooltip types. Default is `#ffffff`.
**Pattern tags**
@ -493,6 +439,7 @@ now.
| `$name` | Name of the desktop. |
| `$number` | Number of the desktop. |
| `$total` | Total number of desktops. |
<!-- end of config block -->
<!-- gui block -->

View File

@ -30,16 +30,11 @@ links:
---
<!-- info block -->
Набор минималистичных легко настраиваемых пламоидов, написанных на `C++/Qt`. Они
выглядят, как виджеты в [Awesome WM](//awesome.naquadah.org/ "Домашняя страница
Awesome"). Также пакет предоставляет дополнительный системный [DataEngine]
(//techbase.kde.org/Development/Tutorials/Plasma/DataEngines "Мануал для
разработчиков").
Набор минималистичных легко настраиваемых пламоидов, написанных на `C++/Qt`. Они выглядят, как виджеты в [Awesome WM](//awesome.naquadah.org/ "Домашняя страница Awesome"). Также пакет предоставляет дополнительный системный [DataEngine](//techbase.kde.org/Development/Tutorials/Plasma/DataEngines "Мануал для разработчиков").
<!--more-->
**ВНИМАНИЕ:** [НУЖНЫ ПЕРЕВОДЧИКИ!](//github.com/arcan1s/awesome-widgets/issues/14
"Тикет")
**ВНИМАНИЕ:** [НУЖНЫ ПЕРЕВОДЧИКИ!](//github.com/arcan1s/awesome-widgets/issues/14 "Тикет")
**Совместим с Plasma 5!**
@ -61,8 +56,7 @@ Awesome"). Также пакет предоставляет дополнител
### <a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Список изменений
[CHANGELOG-RU](//github.com/arcan1s/awesome-widgets/blob/master/CHANGELOG-RU
"GitHub")
[CHANGELOG-RU](//github.com/arcan1s/awesome-widgets/blob/master/CHANGELOG-RU "GitHub")
<!-- end of info block -->
@ -71,32 +65,26 @@ Awesome"). Также пакет предоставляет дополнител
### <a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Инструкция
* Скачайте [архив](//github.com/arcan1s/awesome-widgets/releases "GitHub") с
актуальной версией исходных файлов.
* Скачайте [архив](//github.com/arcan1s/awesome-widgets/releases "GitHub") с актуальной версией исходных файлов.
* Извлеките из него файлы и установите:
```bash
cd /путь/к/извлеченным/файлам/
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr ../
make
sudo make install
cmake -B build -S sources -DCMAKE_BUILD_TYPE=Release
cmake --build build
cmake --install build
```
**ВНИМАНИЕ:** Для Plasma 5, вероятно, потребуется флаг
`-DKDE_INSTALL_USE_QT_SYS_PATHS=ON`
### <a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Зависимости
Все было протестировано на последних версиях зависимостей.
* plasma-framework
* plasma-workspace
* cmake *(make)*
* extra-cmake-modules *(make)*
* hddtemp **или** smartmontools *(опционально, для контроля за температурой HDD)*
* один из поддерживаемых музыкальных плееров *(опционально, для контроля за
музыкальным плеером)*
* проприетарный видеодрайвер *(опционально, для контроля за GPU)*
* один из поддерживаемых музыкальных плееров *(опционально, для контроля за музыкальным плеером)*
* udev *(опционально, настройки GPU)*
* wireless_tools *(опционально, настройки WiFi)*
<!-- end of install block -->
@ -107,9 +95,7 @@ Awesome"). Также пакет предоставляет дополнител
### <a href="#tips" class="anchor" id="tips"><span class="octicon octicon-link"></span></a>Tips & tricks
Вы можете использовать несколько цветов в тексте. Просто вставьте нужный текст в
html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/issues/9 "GitHub")
для более подробной информации.
Вы можете использовать несколько цветов в тексте. Просто вставьте нужный текст в html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/issues/9 "GitHub") для более подробной информации.
<!-- end of howto block -->
@ -118,19 +104,13 @@ html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/is
### <a href="#deconf" class="anchor" id="deconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine
Вы можете отредактировать настройки DataEngine, которые хранятся в
`/etc/xdg/plasma-dataengine-extsysmon.conf` и
`$HOME/.config/plasma-dataengine-extsysmon.conf`. Раскомментируйте необходимые
строчки и отредактируйте их.
Вы можете отредактировать настройки DataEngine, которые хранятся в `/etc/xdg/plasma-dataengine-extsysmon.conf` и `$HOME/.config/plasma-dataengine-extsysmon.conf`. Раскомментируйте необходимые строчки и отредактируйте их.
### <a href="#deoptions" class="anchor" id="deoptions"><span class="octicon octicon-link"></span></a>Опции DataEngine
| | |
|----------|----------|
| ACPIPATH | Путь к устройствам ACPI. По умолчанию `/sys/class/power_supply/`. |
| GPUDEV | Устанавливает тип GPU. Может быть `nvidia` (для nVidia), `ati` (для ATI Radeon), `disable` или `auto`. По умолчанию `auto`. |
| HDDDEV | Устанавливает блочное устройство для `hddtemp` через запятую или `all` для всех возможных. `disable` отключит монитор температуры HDD. По умолчанию `all`. |
| HDDTEMPCMD | Команда, которая будет запущена для hddtemp. По умолчанию `sudo smartctl -a`. Поддерживаемые приложения - `hddtemp` и `smartmontools`. |
| MPDADDRESS | Адрес MPD хоста. По умолчанию `localhost`. |
| MPDPORT | Адрес MPD хоста. По умолчанию `6600`. |
| PLAYER | Устанавливает музыкальный плеер. Поддерживаемые плееры: mpd и с поддержкой MPRIS/DBus. `disable` отключит данный монитор. |
@ -138,8 +118,7 @@ html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/is
### <a href="#widconf" class="anchor" id="widconf"><span class="octicon octicon-link"></span></a>Настройка виджета
Для настройки внешнего вида Вы должны открыть окно настроек и установить
требуемый формат текста. HTML теги обрабатываются корректно.
Для настройки внешнего вида Вы должны открыть окно настроек и установить требуемый формат текста. HTML теги обрабатываются корректно.
Доступные флаги приведены в таблице ниже.
@ -163,8 +142,9 @@ html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/is
| `$cpucl` | Средняя частота CPU, МГц, `----`. | 1.1.2 |
| `$cpuclN` | Частота CPU для ядра N, МГц, `----`. | 1.7.0 |
| `$tempN` | Температура для датчика N, `----`. Пример: `$temp0` ||
| `$gpu` | Использование GPU, %, `-----`. `aticonfig` или `nvidia-smi` должны быть установлены. | 1.3.2 |
| `$gputemp` | Температура GPU, `----`. `aticonfig` или `nvidia-smi` должны быть установлены. | 1.3.2 |
| `$gpu` | Использование GPU, %, `-----`. `udev` должен быть установлен. | 1.3.2 |
| `$gpuN` | Использование GPU для устройства Ν, %, `-----`. Пример: `$gpuN`. `udev` должен быть установлен. | 4.0.0 |
| `$gputempN` | Температура GPU для устройства N, `----`. Пример: `$gputempN`. `udev` должен быть установлен. | 4.0.0 |
| `$mem` | Использование RAM, %, `-----`. ||
| `$memmb` | Использование RAM, MB, `-----`. | 1.1.1 |
| `$memgb` | Использование RAM, GB, `----`. | 1.7.3 |
@ -190,7 +170,6 @@ html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/is
| `$hddtotgbN` | Размер точки монтирования N, GB, `-----`. Пример: `$hddtotgb0`. | 1.10.0 |
| `$hddrN` | Скорость записи диска N, KB/s, `-----`. Пример: `$hddr0`. | 1.9.0 |
| `$hddwN` | Скорость чтения диска N, KB/s, `-----`. Пример: `$hddw0`. | 1.9.0 |
| `$hddtempN` | Температура HDD с номером N, `----`. Пример `$hddtemp0`. `hddtemp` или `smartmontools` должен быть установлен. | 1.7.0 |
| `$down` | Скорость загрузки активного устройства, KB/s или MB/s, `----`. | 1.7.0 |
| `$downkb` | Скорость загрузки активного устройства, KB/s, `----`. | 3.0.0 |
| `$downunits` | Единицы скорости загрузки активного устройства, `----`. | 3.0.0 |
@ -214,6 +193,14 @@ html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/is
| `$netdev` | Текущее устройство. | 1.1.1 |
| `$bat` | Средний заряд батареи, %, `---`. ||
| `$batN` | Заряд батареи N, %, `---`. | 2.0.3 |
| `$batleft` | Время разряда батареи, с, `---`. | 3.4.2 |
| `$batleftN` | Время разряда батареи N, с, `---`. Пример: `$batleft0`. | 3.4.2 |
| `$batnow` | Текущая емкость батарей, `---`. | 3.4.2 |
| `$batnowN` | Текущая емкость батареи N, `---`. Пример: `$batnow0`. | 3.4.2 |
| `$batrate` | Скорость разряда батареи, 1/с, `-----`. | 3.4.2 |
| `$batrateN` | Скорость разряда батареи N, 1/с, `-----`. Пример: `$batrate0`. | 3.4.2 |
| `$battotal` | Полная емкость всех батарей, `---`. | 3.4.2 |
| `$battotalN` | Полная емкость батареи N, `---`. Пример: `$battotal0`. | 3.4.2 |
| `$ac` | Статус зарядного устройства. Возвращает `(*)`, если устройство подключено, или `( )`, если нет. ||
| `$album` | Альбом текущей песни. Один из поддерживаемых музыкальных плееров должен быть установлен. | 1.5.3 |
| `$dalbum` | Альбом текущей песни с фиксированным количеством символов, показывающийся, как бегущая строка. | 3.0.0 |
@ -244,17 +231,18 @@ html код. Смотри [вопрос](//github.com/arcan1s/awesome-widgets/is
| `$priceN` | Получить цену по тикеру N. Например, `$price0`. | 2.2.2 |
| `$pricechgN` | Абсолютное изменение цены по тикеру N. Например, `$pricechg0`. | 2.2.2 |
| `$percpricechgN` | Изменение цены по тикеру N, %. Например, `$percpricechg0`. | 2.2.2 |
| `$weatherIdN` | Численное ID погоды. Например `$weatherId0`. | 2.4.0 |
| `$weatherN` | Статус погоды. Например `$weather0`. | 2.4.0 |
| `$humidityN` | Влажность, %. Например `$humidity0`. | 2.4.0 |
| `$pressureN` | Давление, бар. Например `$pressure0`. | 2.4.0 |
| `$temperatureN` | Температура. Humidity `$temperature0`. | 2.4.0 |
| `$weatherIdN` | Численное ID погоды. Например, `$weatherId0`. | 2.4.0 |
| `$weatherN` | Статус погоды. Например, `$weather0`. | 2.4.0 |
| `$humidityN` | Влажность, %, `---`. Например, `$humidity0`. | 2.4.0 |
| `$pressureN` | Давление, бар, `-----`. Например, `$pressure0`. | 2.4.0 |
| `$temperatureN` | Температура, `-----`. Например, `$temperature0`. | 2.4.0 |
| `$brightness` | Яркость экрана, `---`. | 3.4.2 |
| `$volume` | Громкость звука, `---`. | 3.4.2 |
| `$ssid` | Текущее WiFi подключение. `wireless_tools` должен быть установлен. | 4.0.0 |
### <a href="#lambda" class="anchor" id="lambda"><span class="octicon octicon-link"></span></a>Лямбда и шаблонные функции
Начиная с версии 3.0.0 основной виджет поддерживает лямбда выражения, которые
рассчитываются в рантайме. Они объявляются использованием конструкции
`{% raw %}${{{% endraw %} {% raw %}}}{% endraw %}`:
Начиная с версии 3.0.0 основной виджет поддерживает лямбда выражения, которые рассчитываются в рантайме. Они объявляются использованием конструкции `{% raw %}${{{% endraw %} {% raw %}}}{% endraw %}`:
```javascript
{% raw %}${{{% endraw %}
@ -266,8 +254,7 @@ three()
{% raw %}}}{% endraw %}
```
Функции внутри будут интерпретированы, как JavaScript, любая переменная из
основного набора поддерживается. Так, функция:
Функции внутри будут интерпретированы, как JavaScript, любая переменная из основного набора поддерживается. Так, функция:
```javascript
{% raw %}${{{% endraw %}
@ -282,8 +269,7 @@ colorCpu()
{% raw %}}}{% endraw %}
```
покажет значение `$cpu` красным, если оно больше 90.0, иначе - покажет цветом
по-умолчанию. Также поддерживаются произвольные вычисления:
покажет значение `$cpu` красным, если оно больше 90.0, иначе - покажет цветом по-умолчанию. Также поддерживаются произвольные вычисления:
```javascript
{% raw %}${{{% endraw %}
@ -291,10 +277,7 @@ $down - $up
{% raw %}}}{% endraw %}
```
покажет разность между скоростями загрузки и отдачи. Другая особенность,
предоставляемая лямбда выражениями - тег `$this`, который вернет последнее
значение данной лямбда функции. Ниже чуть более сложный пример, который покажет
бегущую строку "Артист - Название" с длиной меньшей либо равной 10 символам:
покажет разность между скоростями загрузки и отдачи. Другая особенность, предоставляемая лямбда выражениями - тег `$this`, который вернет последнее значение данной лямбда функции. Ниже чуть более сложный пример, который покажет бегущую строку "Артист - Название" с длиной меньшей либо равной 10 символам:
```javascript
{% raw %}${{{% endraw %}
@ -310,14 +293,9 @@ runningLine()
{% raw %}}}{% endraw %}
```
Таким образом, лямбда выражения могут быть использованы, например, чтобы
показывать произвольное значение, которое будет рассчитано в рантайме, или,
чтобы показать различную информацию, в зависимости от некоторых условий. Однако,
пожалуйста, учитывайте, что подобные вычисления в рантайме могут увеличить
нагрузку на CPU.
Таким образом, лямбда выражения могут быть использованы, например, чтобы показывать произвольное значение, которое будет рассчитано в рантайме, или, чтобы показать различную информацию, в зависимости от некоторых условий. Однако, пожалуйста, учитывайте, что подобные вычисления в рантайме могут увеличить нагрузку на CPU.
Другое дополнение, которое было введено с 3.1.0 - шаблоны. Они работают также,
как и лямбда выражения, однако вычисляются один раз (на старте), например:
Другое дополнение, которое было введено с 3.1.0 - шаблоны. Они работают также, как и лямбда выражения, однако вычисляются один раз (на старте), например:
```javascript
{% raw %}$template{{{% endraw %}
@ -333,14 +311,7 @@ three()
### <a href="#functions" class="anchor" id="functions"><span class="octicon octicon-link"></span></a>Специальные функции
Чтобы улучшить работу лямбда и шаблонных функций с 3.1.0 были введены несколько
внутренних функций. Они имеют следующий синтаксис:
`$aw_function<args>{% raw %}{{{% endraw %}body{% raw %}}}{% endraw %}`, где
аргументы могут быть опциональными. Если вы хотите передать несколько аргументов,
они должны быть разделены запятыми. Если вы хотите передать запятую, как
аргумент, используйте `$,`. Чтобы использовать сдвоенные скобки внутри тела, их
нужно экранировать, используя `$`, например `${`. Функции будут вызваны один раз
при запуске перед всем остальным.
Чтобы улучшить работу лямбда и шаблонных функций с 3.1.0 были введены несколько внутренних функций. Они имеют следующий синтаксис: `$aw_function<args>{% raw %}{{{% endraw %}body{% raw %}}}{% endraw %}`, где аргументы могут быть опциональными. Если вы хотите передать несколько аргументов, они должны быть разделены запятыми. Если вы хотите передать запятую, как аргумент, используйте `$,`. Чтобы использовать сдвоенные скобки внутри тела, их нужно экранировать, используя `$`, например `${`. Функции будут вызваны один раз при запуске перед всем остальным.
| Функция | Описание | Аргументы | Тело |
|---------|----------|-----------|------|
@ -353,39 +324,27 @@ three()
### <a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Расширенные настройки
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и
установить прозрачный. По умолчанию `true`.
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный. По умолчанию `true`.
**Переводить строки:** Переводить или нет строковые теги. По умолчанию `true`.
**Заменить символ перевода строки:** Заменить `\n` на `&#60;br&#62;`. По
умолчанию `false`.
**Заменить символ перевода строки:** Заменить `\n` на `&#60;br&#62;`. По умолчанию `false`.
**Перенос слов:** Включить перенос слов. По умолчанию `false`.
**Включить всплывающие сообщения:** Снимите галочку, если вы не хотите
всплывающих сообщений на системные события. По умолчанию `true`.
**Включить всплывающие сообщения:** Снимите галочку, если вы не хотите всплывающих сообщений на системные события. По умолчанию `true`.
**Проверять обновления:** Проверять или нет обновления при запуске. По умолчанию
`true`.
**Проверять обновления:** Проверять или нет обновления при запуске. По умолчанию`true`.
**Оптимизировать подписку:** Оптимизировать работу с DataEngine. Вероятно, вы не
хотите менять эту опцию, несмотря на тот факт, что одна функция будет недоступна.
По умолчанию `true`.
**Оптимизировать подписку:** Оптимизировать работу с DataEngine. Вероятно, вы не хотите менять эту опцию, несмотря на тот факт, что одна функция будет недоступна. По умолчанию `true`.
**Высота виджета:** Отключит автоматическое определение высоты виджета и
установит ее в данное значение. По умолчанию `0` (автоматически).
**Высота виджета:** Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
**Ширина виджета:** Отключит автоматическое определение ширины виджета и
установит ее в данное значение. По умолчанию `0` (автоматически).
**Ширина виджета:** Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
**Интервал обновления:** Интервал обновления виджета, мс. По умолчанию `1000`.
**Очередь сообщений:** Использовать указанное количество тредов в пуле. `0`
означает идеальное количество тредов. По умолчанию `0`.
**Температурные единицы:** Выберете единицы температуры. Доступные единицы
следующие: Цельсий, Фаренгейт и Кельвин.
**Температурные единицы:** Выберете единицы температуры. Доступные единицы следующие: Цельсий, Фаренгейт и Кельвин.
**Свой формат времени:**
@ -424,51 +383,25 @@ three()
| `$mm` | Минуты аптайма. |
| `$m` | Минуты аптайма без нуля. |
**AC online тег:** Строка, которая будет показана, когда AC онлайн. По умолчанию
`(*)`.
**AC online тег:** Строка, которая будет показана, когда AC онлайн. По умолчанию `(*)`.
**AC offline тег:** Строка, которая будет показана, когда AC оффлайн. По
умолчанию `( )`.
**AC offline тег:** Строка, которая будет показана, когда AC оффлайн. По умолчанию `( )`.
**Включить удаленную телеметрию:** Включить загрузку конфигурации на удаленный
сервер.
**Количество истории:** Общее количество конфигураций, которые будут сохранены
локально
**ID телеметрии:** Уникальный идентификатор клиента для загрузки на удаленный
сервер.
**Количество истории:** Общее количество конфигураций, которые будут сохранены локально
### <a href="#tooltips" class="anchor" id="tooltips"><span class="octicon octicon-link"></span></a>Тултипы
Начиная с версии 1.7.0, поля CPU, частота CPU, память, swap, сеть и батарея
поддерживают графический тултип (всплывающая подсказка). Чтобы включить их,
просто поставьте нужные галочки. Число хранимых значений может быть установлено
во вкладке. Также есть возможность настроить цвета графиков.
Начиная с версии 1.7.0, поля CPU, частота CPU, память, swap, сеть и батарея поддерживают графический тултип (всплывающая подсказка). Чтобы включить их, просто поставьте нужные галочки. Число хранимых значений может быть установлено во вкладке. Также есть возможность настроить цвета графиков.
### <a href="#deguiconf" class="anchor" id="deguiconf"><span class="octicon octicon-link"></span></a>Настройка DataEngine
**Устройства ACPI:** Путь к устройствам ACPI. По умолчанию `/sys/class/power_supply/`.
**Устройство GPU:** Выберете одно из поддерживаемых устройств GPU. `auto`
включит автоматическое определение устройства, `disable` отключит все мониторы
GPU. По умолчанию `auto`.
**Количество символов для плеера:** Количество символов, которые будут показываться в динамических тегах плеера.
**HDD:** Выберете один из HDD для монитора температуры HDD. `all` включит
монитор для всех доступных устройств, `disable` отключит монитор температуры HDD.
По умолчанию `all`.
**Музыкальный плеер:** Выберете один из поддерживаемых музыкальных плееров для соответствующего поля.
**Команда hddtemp:** Введите команду, которая будет запущена для hddtemp
DataEngine. По умолчанию `sudo hddtemp`.
**Количество символов для плеера:** Количество символов, которые будут
показываться в динамических тегах плеера.
**Музыкальный плеер:** Выберете один из поддерживаемых музыкальных плееров для
соответствующего поля.
**MPRIS:** Выберете имя плеера MPRIS. `auto` включит автоматическое определение
плеера. По умолчанию `auto`.
**MPRIS:** Выберете имя плеера MPRIS. `auto` включит автоматическое определение плеера. По умолчанию `auto`.
**Адрес MPD:** Адрес MPD сервера. По умолчанию `localhost`.
@ -476,32 +409,25 @@ DataEngine. По умолчанию `sudo hddtemp`.
### <a href="#desktoppanel" class="anchor" id="desktoppanel"><span class="octicon octicon-link"></span></a>Desktop panel
Начиная с версии 1.11.0 виджеты предоставляют панель для мониторинга за рабочими
столами. И да, он выглядит, как аналогичная панель в Awesome.
Начиная с версии 1.11.0 виджеты предоставляют панель для мониторинга за рабочими столами. И да, он выглядит, как аналогичная панель в Awesome.
### <a href="#dpconf" class="anchor" id="dpconf"><span class="octicon octicon-link"></span></a>Настройка Desktop panel
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и
установить прозрачный. По умолчанию `true`.
**Включить фон:** Снимите галочку, чтобы отключить стандартный фон виджета и установить прозрачный. По умолчанию `true`.
**Вертикальная разметка:** Использовать вертикальную разметку вместо
горизонтальной. По умолчанию `false`.
**Вертикальная разметка:** Использовать вертикальную разметку вместо горизонтальной. По умолчанию `false`.
**Высота виджета:** Отключит автоматическое определение высоты виджета и
установит ее в данное значение. По умолчанию `0` (автоматически).
**Высота виджета:** Отключит автоматическое определение высоты виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
**Ширина виджета:** Отключит автоматическое определение ширины виджета и
установит ее в данное значение. По умолчанию `0` (автоматически).
**Ширина виджета:** Отключит автоматическое определение ширины виджета и установит ее в данное значение. По умолчанию `0` (автоматически).
**Метка** Введите символ (или строку), которая будет показана, если данный
рабочий стол сейчас активен.
**Метка** Введите символ (или строку), которая будет показана, если данный рабочий стол сейчас активен.
**Тип тултипа:** Тип превью, по умолчанию `Окна`.
**Тип тултипа:** Тип превью, по умолчанию `Контуры`.
**Ширина тултипа:** Ширина тултипа в пикселях. По умолчанию `200px`.
**Цвет тултипа:** Цвет, который будет использован в некоторых типах тултипа.
По умолчанию `#ffffff`.
**Цвет тултипа:** Цвет, который будет использован в некоторых типах тултипа. По умолчанию `#ffffff`.
**Теги шаблона**