py-text-monitor

Minimalistic Plasmoid script that looks like widgets in Awesome WM

General information
Installation guide
How to use
Configuration
GUI
Screenshots
Links

Report a bug

Information

A minimalistic Plasmoid script written on Python2. It looks like widgets in Awesome WM. My plasmoid is highly and easily configurable and does not clutter your KDE system. Also this packages has an additional DataEngine written on CPP (old version was written on Python2).

NOTE: LOOKING FOR TRANSLATORS!

Developers and contributors

License

Changelog

CHANGELOG

Installation

Instruction

Dependencies

I want note that all were tested on latest version of dependencies.

How to use

Open your Plasma widgetes and select Py Text Monitor.

Configuration

DataEngine configuration

You may edit DataEngine configuration. It is /usr/share/config/extsysmon.conf or $HOME/.kde4/share/config/extsysmon.conf depending on the type of installation. Uncomment needed line and edit it.

DataEngine options

CUSTOM

Custom command to run. Default is wget -qO- http://ifconfig.me/ip.

GPUDEV

Set GPU device. May be nvidia (for nVidia), ati (for ATI Radeon), ignore or auto. Default is auto.

HDDDEV

Set block device for hddtemp comma separated or use all. Default is all.

MPDADDRESS

MPD host address. Default is localhost.

MPDPORT

MPD host port. Default is 6600.

PKGCMD

Commands to run for package manager, comma separated.

PKGNULL

Number of null lines for commands, comma separated.

Widget configuration

For edited output you must open Settings window and setup output format in lines. Label order will changed if you change slider position. HTML tags in label work normally.
NOTE You do not may set to show $cpu in swap label for example. $cpu will work only in cpu label.

Available flags are in the table below.
NOTE The numbering of all arrays in variables starts at 0.

Time label $time

Time in default format. For example, fri Nov 6 04:48:01 2013.

$isotime

Time in ISO format.

$shorttime

Time in short locale format.

$longtime

Time in long locale format.

$custom

Will enable custom time format.

Uptime label $uptime

System uptime, ---d--h--m.

$custom

Will enable custom uptime format.

CPU label $cpu

Total load CPU, %, -----.

$cpuN

Load CPU for core N, %, -----.

CPU clock label $cpucl

Average CPU clock, MHz, ----.

$cpuclN

CPU clock for core N, MHz, ----.

Temperature label $tempN

Temperature for device N, °C, ----. For example, $temp0.

GPU label $gpu

GPU usage, %, -----. aticonfig or nvidia-smi must be installed.

GPU temperature label $gputemp

GPU temperature, °C, ----. aticonfig or nvidia-smi must be installed.

Memory label $mem

Memory usage, %, -----.

$memmb

Memory usage, MB, -----.

$memgb

Memory usage, GB, ----.

Swap label $swap

Swap usage, %, -----.

$swapmb

Swap usage, MB, -----.

$swapgb

Swap usage, GB, ----.

HDD usage label $hddN

Usage for mount point N, %, -----. For example $hdd0.

HDD temperature label $hddtempN

Temperature for HDD N, °C, ----. For example $hddtemp0. hddtemp must be installed.

Network label $down

Download speed, KB/s, ----.

$up

Upload speed, KB/s, ----.

$netdev

Current network device.

Battery label $bat

Battery charge, %, ---.

$ac

Status of AC device. Returns (*) if AC device is online or ( ) if offline.

Music player label $album

Current song album. One of supported music players must be installed.

$artist

Current song artist. One of supported music players must be installed.

$progress

Current song progress. One of supported music players must be installed.

$time

Current song duration. One of supported music players must be installed.

$title

Current song title. One of supported music players must be installed.

Process label $ps

List of running processes comma separated.

$pscount

Number of running processes.

$pstotal

Total number of processes.

Package manager label $pkgcountN

Number of packages, which available to upgrade for command N.

Custom label $custom

Get output from custom command.

Advanced settings

Custom time format:

$dddd

Weekday in long format.

$ddd

Weekday in short format.

$dd

Day.

$d

Day without zero.

$MMMM

Month in long format.

$MMM

Month in short format.

$MM

Month.

$M

Month without zero.

$yyyy

Year.

$yy

Year in short format.

$hh

Hours.

$h

Hours without zero.

$mm

Minutes.

$m

Minutes without zero.

$ss

Seconds.

$s

Seconds without zero.

Custom uptime format:

$dd

Uptime days.

$d

Uptime days without zero.

$hh

Uptime hours.

$h

Uptime hours without zero.

$mm

Uptime minutes.

$m

Uptime minutes without zero.

Temperature devices: List of devices, which will be observed in temperature label (combo box items come from sensors). List widget is editable, delete key will remove current item.

Mount points: List of mount points, which will be observed in HDD label (combo box items come from mount). List widget is editable, delete key will remove current item.

HDDs: List of hard disk devices, which will be observed in HDD temperature label (combo box items come from find). List widget is editable, delete key will remove current item.

Network directory: Path to directory, which contains network devices information. Default is /sys/class/net. It is required for auto select of network device.

Network device: Use specified device as active. Combo box items come from network directory. This option will disable auto select network device.

Battery device: File with battery information. The file (/sys/class/power_supply/BAT0/capacity by default) should contain only battery charge in percent.

AC online tag: Line which will be shown when AC is online. Default is (*).

AC offline tag: Line which will be shown when AC is offline. Default is ( ).

AC device: File with AC information. The file (/sys/class/power_supply/AC/online by default) should contain 1 if AC is online.

Music player: Select one of supported music playes for player label.

Tooltips

Since version 1.7.0 CPU, CPU clock, memory, swap and network labels 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.

DataEngine settings

Custom command: NOTE this label may cause the computer freeze. A command, which will be run for custom label. For example, wget -qO- http://ifconfig.me/ip will return external IP.

GPU device: Select one of supported GPU devices. auto will enable auto selection. Default is auto.

HDD: Select one of HDDs for HDD temperature monitor. all will enable monitor for all devices. Default is all.

MPD address: Address of MPD server. Default is localhost.

MPD port: Port of MPD server. Default is 6600.

Package manager: List of commands, which will be run. Number of null lines is a number of unneeded lines. Defaults are:

Distro

Command

Number

Arch

pacman -Qu 0

Debian

apt-show-versions -u -b 0

Ubuntu

aptitude search '~U' 0

Fedora

yum list updates 3

FreeBSD

pkg_version -I -l '<' 0

Mandriva

urpmq --auto-select 0

Graphical user interface

Screenshots

Widget (clickable):

Configuration window:





Tooltips:

Links