mirror of
https://github.com/arcan1s/arcanis.me.git
synced 2025-04-24 15:27:17 +00:00
676 lines
24 KiB
HTML
676 lines
24 KiB
HTML
---
|
|
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="http://software.opensuse.org/package/plasma5-awesome-widgets" title="openSUSE">openSUSE package</a> (thanks to Kott)
|
|
- <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>
|
|
<p><b>PLASMA 5 COMPATIBLE!</b></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=/usr ../
|
|
make
|
|
sudo make install
|
|
{% endhighlight %}
|
|
|
|
<b>NOTE:</b> on Plasma 5 it may require <code>-DKDE_INSTALL_USE_QT_SYS_PATHS=ON</code> flag
|
|
</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 (<i>if KDE4 is used</i>) <b>or</b> plasma-framework (<i>if KF5 is used</i>)</li>
|
|
<li>lm_sensors (<i>KDE4 build only</i>)</li>
|
|
<li>automoc4 (<i>if KDE4 is used</i>) <b>or</b> extra-cmake-modules (<i>if KF5 is used</i>) <i>(make)</i></li>
|
|
<li>cmake <i>(make)</i></li>
|
|
<li>hddtemp <b>or</b> smartmontools <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><i><font color="#FF0000">KDE4</font></i> 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>/etc/xdg/plasma-dataengine-extsysmon.conf</code> and <code>$HOME/.config/plasma-dataengine-extsysmon.conf</code>. 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>. Supported applications are <code>hddtemp</code> and <code>smartmontools</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>PLAYER</th>
|
|
<td>Set music player. Supported players are mpd and MPRIS/DBus supported. <code>disable</code> will disable this monitor.</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="3">Load average</th>
|
|
<td><code>$la1</code></td>
|
|
<td>Load average over 1 min, <code>-----</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$la5</code></td>
|
|
<td>Load average over 5 min, <code>-----</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$la15</code></td>
|
|
<td>Load average over 15 min, <code>-----</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<th rowspan="2">CPU</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">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="5">Network</th>
|
|
<td><code>$down</code></td>
|
|
<td>Download speed for active device, KB/s, <code>----</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$downN</code></td>
|
|
<td>Download speed for device N, KB/s, <code>----</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$up</code></td>
|
|
<td>Upload speed for active device, KB/s, <code>----</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$upN</code></td>
|
|
<td>Upload speed for device N, 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>
|
|
<tr>
|
|
<th rowspan="9">Quotes</th>
|
|
<td><code>$askN</code></td>
|
|
<td>Get ask for ticker N. For example <code>$ask0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$askchgN</code></td>
|
|
<td>Get absolute ask change for ticker N. For example <code>$askchg0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$percaskchgN</code></td>
|
|
<td>Get ask change for ticker N, %. For example <code>$percaskchg0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$bidN</code></td>
|
|
<td>Get bid for ticker N. For example <code>$bid0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$bidchgN</code></td>
|
|
<td>Get absolute bid change for ticker N, %. For example <code>$bidchg0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$percbidchgN</code></td>
|
|
<td>Get bid change for ticker N. For example <code>$percbidchg0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$priceN</code></td>
|
|
<td>Get price for ticker N. For example <code>$price0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$pricechgN</code></td>
|
|
<td>Get absolute price change for ticker N. For example <code>$pricechg0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$percaskchgN</code></td>
|
|
<td>Get price change for ticker N, %. For example <code>$percpricechg0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<th rowspan="5">Weather</th>
|
|
<td><code>$weatherIdN</code></td>
|
|
<td>Numerical weather ID. For example <code>$weatherId0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$weatherN</code></td>
|
|
<td>UTF symbol for weather ID. For example <code>$weather0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$humidityN</code></td>
|
|
<td>Humidity, %. For example <code>$humidity0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$pressureN</code></td>
|
|
<td>Pressure, bars. For example <code>$pressure0</code>.</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>$temperatureN</code></td>
|
|
<td>Temperature. For example <code>$temperature0</code>.</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 want popup messages on system events.</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><i><font color="#FF0000">KDE4</font></i> <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><i><font color="#FF0000">KDE4</font></i> <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><i><font color="#FF0000">KDE4</font></i> <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><i><font color="#FF0000">KDE4</font></i> <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><i><font color="#FF0000">KDE4</font></i> <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>Music player:</b> Select one of supported music players 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. Shows spaces in other way.</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><i><font color="#FF0000">KDE4</font> (see <a href="http://mail.kde.org/pipermail/plasma-devel/2015-February/039027.html" title="Mailing list">this thread</a>)</i> <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>
|