---
hastr: true
layout: project
title: Awesome Widgets
short: awesome-widgets
tags: python, kde, qt, linux, system, awesome
hasgui: true
hasdocs: false
developers:
    - Evgeniy Alekseev
    - Ernesto Avilés Vzqz (Spanish translation)
    - Mermouy (French translation)
    - underr (Brazillian Portuguese translation)
    - Виктор Слободян (Ukrainian translation)
    - Lemueler (Chinese translation)
license: GPLv3
links:
    - Plasmoid page on <a href="http://kde-look.org/content/show.php/Awesome+Widgets?content=157124" title="kde-look">kde-look.org</a>
    - DataEngine page on <a href="http://kde-look.org/content/show.php/Extended+Systemmonitor+DataEngine?content=158773" title="kde-look">kde-look.org</a>
    - Archlinux <a href="https://aur.archlinux.org/packages/kdeplasma-applets-awesome-widgets" title="AUR">AUR package</a>
    - <a href="/en/2014/09/04/migration-to-v2/" title="Migration">Migration to version 2.0</a>
    - <a href="/en/2014/12/19/aw-v21-bells-and-whistles/" title="Scripts and bars">Scripts and bars</a>
---
<!-- info block -->
<h2><a href="#information" class="anchor" id="info"><span class="octicon octicon-link"></span></a>Information</h2>
<p>A collection  of minimalistic Plasmoids written on <code>CPP</code>. It looks like widgets in <a href="http://awesome.naquadah.org/" title="Awesome Homepage">Awesome WM</a>. My plasmoid is highly and easily configurable and does not clutter your KDE system. Also this packages has an additional <a href="http://techbase.kde.org/Development/Tutorials/Plasma/DataEngines" title="Developers tutorial">DataEngine</a> written on <code>CPP</code> (old version was written on <code>Python2</code>).</p>

<p><b>NOTE:</b> <a href="https://github.com/arcan1s/awesome-widgets/issues/14" title="Ticket">LOOKING FOR TRANSLATORS!</a></p>

<h3><a href="#devel" class="anchor" id="devel"><span class="octicon octicon-link"></span></a>Developers and contributors</h3>
<ul>
  {% for devel in page.developers %}
    <li>{{ devel }}</li>
  {% endfor %}
</ul>

<h3><a href="#license" class="anchor" id="license"><span class="octicon octicon-link"></span></a>License</h3>
<ul>
  <li>{{ page.license }}</li>
</ul>

<h3><a href="#changelog" class="anchor" id="changelog"><span class="octicon octicon-link"></span></a>Changelog</h3>
<p><a href="https://github.com/arcan1s/awesome-widgets/blob/master/CHANGELOG" title="GitHub">CHANGELOG</a></p>
<!-- end of info block -->

<!-- install block -->
<h2><a href="#install" class="anchor" id="install"><span class="octicon octicon-link"></span></a>Installation</h2>

<h3><a href="#instruction" class="anchor" id="instruction"><span class="octicon octicon-link"></span></a>Instruction</h3>
<ul>
  <li>Download an <a href="https://github.com/arcan1s/awesome-widgets/releases" title="GitHub">archive</a> with latest version of source files.</li>
  <li>Extract it and install:

{% highlight bash %}
cd /where/is/applet/
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --localprefix` ../
make
make install
{% endhighlight %}

For global installation type:

{% highlight bash %}
cd /where/is/applet/
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=`kde4-config --prefix` ../
make
sudo make install
{% endhighlight %}

  </li>
</ul>

<h3><a href="#dependencies" class="anchor" id="dependencies"><span class="octicon octicon-link"></span></a>Dependencies</h3>
<p>I want note that all were tested on latest version of dependencies.</p>
<ul>
  <li>kdebase-workspace</li>
  <li>lm_sensors</li>
  <li>automoc4 <i>(make)</i></li>
  <li>cmake <i>(make)</i></li>
  <li>hddtemp <i>(optional, for HDD temperature monitor)</i></li>
  <li>one of supported music player <i>(optional, for music player monitor)</i></li>
  <li>proprietary video driver <i>(optional, for GPU monitor)</i></li>
</ul>
<!-- end of install block -->

<!-- howto block -->
<h2><a href="#howto" class="anchor" id="howto"><span class="octicon octicon-link"></span></a>How to use</h2>
<p>Open your Plasma widgets and select <code>Awesome Widget</code>.</p>

<h3><a href="#tips" class="anchor" id="tips"><span class="octicon octicon-link"></span></a>Tips & tricks</h3>
<p>You may use different colors for labels. Just put label text into html code. See <a href="https://github.com/arcan1s/awesome-widgets/issues/9" title="GitHub">issue</a> for more details.</p>

<p>Numbering of elements of temperature, HDD usage, HDD speed, HDD temperature refers to elements order from second tab (<i>Advanced settings</i>). You should select an item to the required listWidget first. And the first selected element in the listWidget will be <code>$tag0</code>. See <a href="https://github.com/arcan1s/awesome-widgets/issues/17" title="GitHub">issue</a> for more details.</p>
<!-- end of howto block -->

<!-- config block -->
<h2><a href="#config" class="anchor" id="config"><span class="octicon octicon-link"></span></a>Configuration</h2>

<h3><a href="#deconf" class="anchor" id="deconf"><span class="octicon octicon-link"></span></a>DataEngine configuration</h3>
<p>You may edit DataEngine configuration. It is <code>/usr/share/config/extsysmon.conf</code> or <code>$HOME/.kde4/share/config/extsysmon.conf</code> depending on the type of installation. Uncomment needed line and edit it.</p>

<h4><a href="#deoptions" class="anchor" id="deoptions"><span class="octicon octicon-link"></span></a>DataEngine options</h4>
<table>
  <tr>
    <th>ACPIPATH</th>
    <td>Path to ACPI devices. Default is <code>/sys/class/power_supply/</code>.</td>
  </tr>
  <tr>
    <th>GPUDEV</th>
    <td>Set GPU device. May be <code>nvidia</code> (for nVidia), <code>ati</code> (for ATI Radeon), <code>disable</code> or <code>auto</code>. Default is <code>auto</code>.</td>
  </tr>
  <tr>
    <th>HDDDEV</th>
    <td>Set block device for <code>hddtemp</code> comma separated or use <code>all</code>. <code>disable</code> will disable HDD temperature monitor. Default is <code>all</code>.</td>
  </tr>
  <tr>
    <th>HDDTEMPCMD</th>
    <td>A command which will be run for hddtemp DataEngine. Default is <code>sudo hddtemp</code>.</td>
  </tr>
  <tr>
    <th>MPDADDRESS</th>
    <td>MPD host address. Default is <code>localhost</code>.</td>
  </tr>
  <tr>
    <th>MPDPORT</th>
    <td>MPD host port. Default is <code>6600</code>.</td>
  </tr>
  <tr>
    <th>PKGCMD</th>
    <td>Commands to run for package manager, comma separated.</td>
  </tr>
  <tr>
    <th>PKGNULL</th>
    <td>Number of null lines for commands, comma separated.</td>
  </tr>
  <tr>
    <th>PLAYER</th>
    <td>Set music player. Supported players are amarok, clementine, mpd, qmmp.</td>
  </tr>
</table>

<h3><a href="#widconf" class="anchor" id="widconf"><span class="octicon octicon-link"></span></a>Widget configuration</h3>
<p>For edited output you must open Settings window and setup output format. HTML tags work normally.</p>

<p>Available flags are in the table below.<br>
<b>NOTE</b> The numbering of all arrays in variables starts at 0.</p>
<table>
  <tr>
    <th rowspan="5">Time</th>
    <td><code>$time</code></td>
    <td>Time in default format. For example, <code>fri Nov 6 04:48:01 2013</code>.</td>
  </tr>
  <tr>
    <td><code>$isotime</code></td>
    <td>Time in ISO format.</td>
  </tr>
  <tr>
    <td><code>$shorttime</code></td>
    <td>Time in short locale format.</td>
  </tr>
  <tr>
    <td><code>$longtime</code></td>
    <td>Time in long locale format.</td>
  </tr>
  <tr>
    <td><code>$ctime</code></td>
    <td>Will enable custom time format.</td>
  </tr>
  <tr>
    <th rowspan="2">Uptime</th>
    <td><code>$uptime</code></td>
    <td>System uptime, <code>---d--h--m</code>.</td>
  </tr>
  <tr>
    <td><code>$cuptime</code></td>
    <td>Will enable custom uptime format.</td>
  </tr>
  <tr>
    <th rowspan="2">CPU label</th>
    <td><code>$cpu</code></td>
    <td>Total load CPU, %, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$cpuN</code></td>
    <td>Load CPU for core N, %, <code>-----</code>.</td>
  </tr>
  <tr>
    <th rowspan="2">CPU clock</th>
    <td><code>$cpucl</code></td>
    <td>Average CPU clock, MHz, <code>----</code>.</td>
  </tr>
  <tr>
    <td><code>$cpuclN</code></td>
    <td>CPU clock for core N, MHz, <code>----</code>.</td>
  </tr>
  <tr>
    <th rowspan="1">Temperature</th>
    <td><code>$tempN</code></td>
    <td>Temperature for device N, <code>----</code>. For example, <code>$temp0</code>.</td>
  </tr>
  <tr>
    <th rowspan="1">Fan</th>
    <td><code>$fanN</code></td>
    <td>Fan speed for device N, <code>----</code>. For example, <code>$fan0</code>.</td>
  </tr>
  <tr>
    <th rowspan="1">GPU</th>
    <td><code>$gpu</code></td>
    <td>GPU usage, %, <code>-----</code>. <code>aticonfig</code> or <code>nvidia-smi</code> must be installed.</td>
  </tr>
  <tr>
    <th rowspan="1">GPU temperature</th>
    <td><code>$gputemp</code></td>
    <td>GPU temperature, <code>----</code>. <code>aticonfig</code> or <code>nvidia-smi</code> must be installed.</td>
  </tr>
  <tr>
    <th rowspan="9">Memory</th>
    <td><code>$mem</code></td>
    <td>Memory usage, %, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$memmb</code></td>
    <td>Memory usage, MB, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$memgb</code></td>
    <td>Memory usage, GB, <code>----</code>.</td>
  </tr>
  <tr>
    <td><code>$memfreemb</code></td>
    <td>Free memory, MB, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$memfreegb</code></td>
    <td>Free memory, GB, <code>----</code>.</td>
  </tr>
  <tr>
    <td><code>$memtotmb</code></td>
    <td>RAM, MB, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$memtotgb</code></td>
    <td>RAM, GB, <code>----</code>.</td>
  </tr>
  <tr>
    <td><code>$memusedmb</code></td>
    <td>Used and cached memory, MB, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$memusedgb</code></td>
    <td>Used and cached memory, GB, <code>----</code>.</td>
  </tr>
  <tr>
    <th rowspan="7">Swap</th>
    <td><code>$swap</code></td>
    <td>Swap usage, %, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$swapmb</code></td>
    <td>Swap usage, MB, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$swapgb</code></td>
    <td>Swap usage, GB, <code>----</code>.</td>
  </tr>
  <tr>
    <td><code>$swapfreemb</code></td>
    <td>Free swap, MB, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$swapfreegb</code></td>
    <td>Free swap, GB, <code>----</code>.</td>
  </tr>
  <tr>
    <td><code>$swaptotmb</code></td>
    <td>Swap, MB, <code>-----</code>.</td>
  </tr>
  <tr>
    <td><code>$swaptotgb</code></td>
    <td>Swap, GB, <code>----</code>.</td>
  </tr>
  <tr>
    <th rowspan="7">HDD usage</th>
    <td><code>$hddN</code></td>
    <td>Usage for mount point N, %, <code>-----</code>. For example <code>$hdd0</code>.</td>
  </tr>
  <tr>
    <td><code>$hddmbN</code></td>
    <td>Usage for mount point N, MB, <code>-----</code>. For example <code>$hddmb0</code>.</td>
  </tr>
  <tr>
    <td><code>$hddgbN</code></td>
    <td>Usage for mount point N, GB, <code>-----</code>. For example <code>$hddgb0</code>.</td>
  </tr>
  <tr>
    <td><code>$hddfreembN</code></td>
    <td>Free space for mount point N, MB, <code>-----</code>. For example <code>$hddfreemb0</code>.</td>
  </tr>
  <tr>
    <td><code>$hddfreegbN</code></td>
    <td>Free space for mount point N, GB, <code>-----</code>. For example <code>$hddfreegb0</code>.</td>
  </tr>
  <tr>
    <td><code>$hddtotmbN</code></td>
    <td>Total size of mount point N, MB, <code>-----</code>. For example <code>$hddtotmb0</code>.</td>
  </tr>
  <tr>
    <td><code>$hddtotgbN</code></td>
    <td>Total size of mount point N, GB, <code>-----</code>. For example <code>$hddtotgb0</code>.</td>
  </tr>
  <tr>
    <th rowspan="2">HDD speed</th>
    <td><code>$hddrN</code></td>
    <td>Read speed of disk N, KB/s, <code>-----</code>. For example <code>$hddr0</code>.</td>
  </tr>
  <tr>
    <td><code>$hddwN</code></td>
    <td>Write speed of disk N, KB/s, <code>-----</code>. For example <code>$hddw0</code>.</td>
  </tr>
  <tr>
    <th rowspan="1">HDD temperature</th>
    <td><code>$hddtempN</code></td>
    <td>Temperature for HDD N, <code>----</code>. For example <code>$hddtemp0</code>. <code>hddtemp</code> must be installed.</td>
  </tr>
  <tr>
    <th rowspan="3">Network</th>
    <td><code>$down</code></td>
    <td>Download speed, KB/s, <code>----</code>.</td>
  </tr>
  <tr>
    <td><code>$up</code></td>
    <td>Upload speed, KB/s, <code>----</code>.</td>
  </tr>
  <tr>
    <td><code>$netdev</code></td>
    <td>Current network device.</td>
  </tr>
  <tr>
    <th rowspan="3">Battery</th>
    <td><code>$bat</code></td>
    <td>Average battery charge, %, <code>---</code>.</td>
  </tr>
  <tr>
    <td><code>$batN</code></td>
    <td>Battery N charge, %, <code>---</code>.</td>
  </tr>
  <tr>
    <td><code>$ac</code></td>
    <td>Status of AC device. Returns <code>(*)</code> if AC device is online or <code>( )</code> if offline.</td>
  </tr>
  <tr>
    <th rowspan="5">Music player</th>
    <td><code>$album</code></td>
    <td>Current song album. One of supported music players must be installed.</td>
  </tr>
  <tr>
    <td><code>$artist</code></td>
    <td>Current song artist. One of supported music players must be installed.</td>
  </tr>
  <tr>
    <td><code>$duration</code></td>
    <td>Current song duration. One of supported music players must be installed.</td>
  </tr>
  <tr>
    <td><code>$progress</code></td>
    <td>Current song progress. One of supported music players must be installed.</td>
  </tr>
  <tr>
    <td><code>$title</code></td>
    <td>Current song title. One of supported music players must be installed.</td>
  </tr>
  <tr>
    <th rowspan="3">Process</th>
    <td><code>$ps</code></td>
    <td>List of running processes comma separated.</td>
  </tr>
  <tr>
    <td><code>$pscount</code></td>
    <td>Number of running processes.</td>
  </tr>
  <tr>
    <td><code>$pstotal</code></td>
    <td>Total number of processes.</td>
  </tr>
  <tr>
    <th rowspan="1">Package manager</th>
    <td><code>$pkgcountN</code></td>
    <td>Number of packages, which available to upgrade for command N.</td>
  </tr>
  <tr>
    <th rowspan="1">Custom</th>
    <td><code>$customN</code></td>
    <td>Get output from custom command N. For example <code>$custom0</code>.</td>
  </tr>
  <tr>
    <th rowspan="3">Desktop</th>
    <td><code>$desktop</code></td>
    <td>Name of the current desktop.</td>
  </tr>
  <tr>
    <td><code>$ndesktop</code></td>
    <td>Number of the current desktop.</td>
  </tr>
  <tr>
    <td><code>$tdesktops</code></td>
    <td>Total number of desktops.</td>
  </tr>
</table>

<h4><a href="#advanced" class="anchor" id="advanced"><span class="octicon octicon-link"></span></a>Advanced settings</h4>
<p><b>Enable background:</b> Uncheck to disable default background and set transparent one.</p>

<p><b>Enable popup:</b> Uncheck box if you do not use popup messages.</p>

<p><b>Custom time format:</b></p>
<table>
  <tr>
    <td><code>$dddd</code></td>
    <td>Weekday in long format.</td>
  </tr>
  <tr>
    <td><code>$ddd</code></td>
    <td>Weekday in short format.</td>
  </tr>
  <tr>
    <td><code>$dd</code></td>
    <td>Day.</td>
  </tr>
  <tr>
    <td><code>$d</code></td>
    <td>Day without zero.</td>
  </tr>
  <tr>
    <td><code>$MMMM</code></td>
    <td>Month in long format.</td>
  </tr>
  <tr>
    <td><code>$MMM</code></td>
    <td>Month in short format.</td>
  </tr>
  <tr>
    <td><code>$MM</code></td>
    <td>Month.</td>
  </tr>
  <tr>
    <td><code>$M</code></td>
    <td>Month without zero.</td>
  </tr>
  <tr>
    <td><code>$yyyy</code></td>
    <td>Year.</td>
  </tr>
  <tr>
    <td><code>$yy</code></td>
    <td>Year in short format.</td>
  </tr>
  <tr>
    <td><code>$hh</code></td>
    <td>Hours.</td>
  </tr>
  <tr>
    <td><code>$h</code></td>
    <td>Hours without zero.</td>
  </tr>
  <tr>
    <td><code>$mm</code></td>
    <td>Minutes.</td>
  </tr>
  <tr>
    <td><code>$m</code></td>
    <td>Minutes without zero.</td>
  </tr>
  <tr>
    <td><code>$ss</code></td>
    <td>Seconds.</td>
  </tr>
  <tr>
    <td><code>$s</code></td>
    <td>Seconds without zero.</td>
  </tr>
</table>

<p><b>Custom uptime format:</b></p>
<table>
  <tr>
    <td><code>$dd</code></td>
    <td>Uptime days.</td>
  </tr>
  <tr>
    <td><code>$d</code></td>
    <td>Uptime days without zero.</td>
  </tr>
  <tr>
    <td><code>$hh</code></td>
    <td>Uptime hours.</td>
  </tr>
  <tr>
    <td><code>$h</code></td>
    <td>Uptime hours without zero.</td>
  </tr>
  <tr>
    <td><code>$mm</code></td>
    <td>Uptime minutes.</td>
  </tr>
  <tr>
    <td><code>$m</code></td>
    <td>Uptime minutes without zero.</td>
  </tr>
</table>

<p><b>Temperature units:</b> Select units for temperature. Available units are Celsius, Farenheit, Kelvin, Reaumur, cm^-1, kJ/mol, kcal/mol.</p>

<p><b>Temperature devices:</b> List of devices, which will be observed in temperature label (combo box items come from <code>sensors</code>). List widget is editable.</p>

<p><b>Mount points:</b> List of mount points, which will be observed in HDD label (combo box items come from <code>mount</code>). List widget is editable.</p>

<p><b>HDDs (speed):</b> List of hard disk devices, which will be observed in HDD speed label (combo box items come from DataEngine). List widget is editable.</p>

<p><b>HDDs (temperature):</b> List of hard disk devices, which will be observed in HDD temperature label (combo box items come from <code>find</code>). List widget is editable.</p>

<p><b>Network device:</b> Use specified device as active. This option will disable auto select network device.</p>

<p><b>AC online tag:</b> Line which will be shown when AC is online. Default is <code>(*)</code>.</p>

<p><b>AC offline tag:</b> Line which will be shown when AC is offline. Default is <code>( )</code>.</p>

<p><b>Check updates:</b> Check updates on load. Default is <code>true</code>.</p>

<h4><a href="#tooltips" class="anchor" id="tooltips"><span class="octicon octicon-link"></span></a>Tooltips</h4>
<p>Since version 1.7.0 CPU, CPU clock, memory, swap, network and battery support graphical tooltip. To enable them just make the needed checkboxes a fully checked. The number of stored values can be set in the tab. Colors of graphs are configurable too.</p>

<h4><a href="#deguiconf" class="anchor" id="deguiconf"><span class="octicon octicon-link"></span></a>DataEngine settings</h4>
<p><b>ACPI path:</b> Path to ACPI devices. The file <code>/sys/class/power_supply/</code>.</p>

<p><b>GPU device:</b> Select one of supported GPU devices. <code>auto</code> will enable auto selection, <code>disable</code> will disable all GPU monitors. Default is <code>auto</code>.</p>

<p><b>HDD:</b> Select one of HDDs for HDD temperature monitor. <code>all</code> will enable monitor for all devices, <code>disable</code> will disable HDD temperature monitor. Default is <code>all</code>.</p>

<p><b>hddtemp cmd:</b> Type a command which will be run for hddtemp DataEngine. Default is <code>sudo hddtemp</code>.</p>

<p><b>MPD address:</b> Address of MPD server. Default is <code>localhost</code>.</p>

<p><b>MPD port:</b> Port of MPD server. Default is <code>6600</code>.</p>

<p><b>MPRIS:</b> Select MPRIS player name. <code>auto</code> will enable auto selection. Default is <code>auto</code>.</p>

<p><b>Package manager:</b> List of commands, which will be run. Number of null lines is a number of unneeded lines. Defaults are:</p>
<table>
  <tr>
    <th>Distro</th>
    <th>Command</th>
    <th>Number</th>
  </tr>
  <tr>
    <td>Arch</td>
    <td><code>pacman -Qu</code></td>
    <td><code>0</code></td>
  </tr>
  <tr>
    <td>Debian</td>
    <td><code>apt-show-versions -u -b</code></td>
    <td><code>0</code></td>
  </tr>
  <tr>
    <td>Ubuntu</td>
    <td><code>aptitude search '~U'</code></td>
    <td><code>0</code></td>
  </tr>
  <tr>
    <td>Fedora</td>
    <td><code>yum list updates</code></td>
    <td><code>3</code></td>
  </tr>
  <tr>
    <td>FreeBSD</td>
    <td><code>pkg_version -I -l '&lt;'</code></td>
    <td><code>0</code></td>
  </tr>
  <tr>
    <td>Mandriva</td>
    <td><code>urpmq --auto-select</code></td>
    <td><code>0</code></td>
  </tr>
</table>

<p><b>Music player:</b> Select one of supported music playes for player label.</p>

<h3><a href="#desktoppanel" class="anchor" id="desktoppanel"><span class="octicon octicon-link"></span></a>Desktop Panel</h3>
<p>Since version 1.11.0 it provides a minimalistic panel for monitoring on desktops written on <code>C++</code>. And yes, it looks like the same panel in Awesome.</p>

<h4><a href="#dpconf" class="anchor" id="dpconf"><span class="octicon octicon-link"></span></a>Desktop panel configuration</h4>
<p><b>Enable background: </b> Uncheck to disable default background and set transparent one.</p>

<p><b>Vertical layout:</b> Use vertical layout instead of horizontal one.</p>

<p><b>Enable tooltip:</b> Check to enable preview on selected destkop. Default is <code>true</code>. Also you show specify type of preview, default is <code>Windows</code>.</p>

<p><b>Tooltip width:</b> Using tooltip width in px. Default is <code>200px</code>.</p>

<p><b>Color of window borders:</b> Color of window contours which are used in "Contours preview". Default is <code>#ffffff</code>.</p>

<p><b>Mark:</b> Type symbol (or string) which will be shown if this desktop is active now.</p>

<p><b>Pattern tags</b></p>
<table>
  <tr>
    <td><code>$mark</code></td>
    <td>Show mark if this desktop is active.</td>
  </tr>
  <tr>
    <td><code>$fullmark</code></td>
    <td>The same as <code>$mark</code>, but shows empty space too.</td>
  </tr>
  <tr>
    <td><code>$name</code></td>
    <td>Name of the desktop.</td>
  </tr>
  <tr>
    <td><code>$number</code></td>
    <td>Number of the desktop.</td>
  </tr>
  <tr>
    <td><code>$total</code></td>
    <td>Total number of desktops.</td>
  </tr>
</table>

<p><b>Panel toggle:</b> Select panels which will be set hidden on hotkey.</p>
<!-- end of config block -->

<!-- gui block -->
<h2><a href="#gui" class="anchor" id="gui"><span class="octicon octicon-link"></span></a>Graphical user interface</h2>

<h2><a href="#screenshots" class="anchor" id="screenshots"><span class="octicon octicon-link"></span></a>Screenshots</h2>
<div class="thumbnails">
  {% assign scrdesc = "Widget (clickable)" %}
  {% assign scrname = "awesomewidgets_widget" %}
  {% include prj_scr.html %}
  {% assign scrdesc = "Configuration window" %}
  {% assign scrname = "awesomewidgets_config_01" %}
  {% include prj_scr.html %}
  {% assign scrdesc = "Configuration window" %}
  {% assign scrname = "awesomewidgets_config_02" %}
  {% include prj_scr.html %}
  {% assign scrdesc = "Configuration window" %}
  {% assign scrname = "awesomewidgets_config_03" %}
  {% include prj_scr.html %}
  {% assign scrdesc = "Configuration window" %}
  {% assign scrname = "awesomewidgets_config_04" %}
  {% include prj_scr.html %}
  {% assign scrdesc = "Configuration window" %}
  {% assign scrname = "awesomewidgets_config_05" %}
  {% include prj_scr.html %}
  {% assign scrdesc = "Tooltips" %}
  {% assign scrname = "awesomewidgets_tooltips" %}
  {% include prj_scr.html %}
</div>