xfce4-genmon-plugin - Generic Monitor Plugin
This plugin cyclically spawns the indicated script/program, captures its output (stdout) and displays the resulting string into the panel. The string can also contain markup to displayed an formatted text, image/icon, a bar, a button, and a personalized tooltip.
-
- XML Tags
- Example Script
-
- Pango Text Markup Support
- Refreshing the plugin
- Enhanced Gtk3 CSS Styling Capabilities
Important Note about version 4.2.0
Screenshots
Usage
- Right-click on the added plugin, select Properties to open the settings window.
If you want the plugin to display only text (original version), enter the command in the Command field of the Properties section of the plugin. Otherwise, xml tags are used to display content on the plugin.
XML Tags
If you want the plugin to display a personalized Text
, Image
, Icon
, Tooltip
or Bar
, you should develop (or get) a script returning a XML string, and enter the path of this script in the Command field of the Property section of the plugin.
The XML tags which can be used:
- <txt>Text to display</txt>
- Displays the “Text to display” directly on the plugin.
- eg.
echo “<txt>Hello World!</txt>”
- <txtclick>The command to be executed when clicking on the text</txtclick>
- If displaying text, this tag will allow for a program/script to be run when the text is clicked.
- eg.
echo “<txt>File Manager</txt><txtclick>thunar</txtclick>”
- <img>Path to the image to display</img>
- Display an image on the plugin using the complete path and name to the image file.
- eg.
echo “<img>/usr/share/pixmaps/xfce4_xicon.png</img>”
- <click>The command to be executed when clicking on the image</click>
- If using an image, this tag will allow for a program/script to be run when the image is clicked.
- eg.
echo “<img>/usr/share/pixmaps/xfce4_xicon.png</img><click>xfce4-about</click>”
- <icon>Themed icon to be displayed</icon>
- Display an icon from the current icon theme using only the icon name.
- eg.
echo “<icon>org.xfce.mousepad</icon>”
- Note: the <icon> tag allows the following functionality:
- image changes with the icon theme
- supports panel's 'Adjust Icon Size Automatically' functionality
- supports light/dark symbolic icon auto-colour changes
- <iconclick>The command to be executed when clicking on the icon</click>
- If using an icon, this tag will allow for a program/script to run when the icon is clicked.
- eg.
echo “<icon>org.xfce.mousepad</icon><iconclick>mousepad</iconclick>”
- <tool>Tooltip text</tool>
- Display specific content in a tooltip.
- eg.
echo “<tool>My custom tooltip text</tool>”
- Note:
- To hide the tooltip bubble, use an empty tool tag, eg:
echo “<tool></tool>”
- The tooltip will not display with a cycle of less than 0.5 (see: https://gitlab.gnome.org/GNOME/gtk/-/issues/826)
- <bar>Percentage to display in the bar</bar>
- Display a value-based progress bar on the plugin.
- eg.
echo “<bar>42</bar>”
(this will show a progress bar at 42%)
- <css>embedded CSS tweaks</css>
- This tag will allow the embedding of css tweaks directly into the plugin.
- eg.
echo “<css>.genmon_valuebutton { background-color:green; color: yellow; padding: 5px;}</css>”
- More information on css and css tweaking of the plugin in the Advanced Features section below.
If None of the tags are detected in the result of the command, the plugin reverts to its original behavior (displaying the result of the command).
Example Script (system stats)
Here is an example of a genmon plugin displaying basic system stats (cpu, memory, harddrive usage) using the <icon>, <txt>, <txtclick> and <tool> xml tags:
- systemstats.sh
#!/bin/sh ICON=utilities-system-monitor PARTITION=sda2 # get CPU info CPU=$(cat <(grep 'cpu ' /proc/stat) <(sleep 1 && grep 'cpu ' /proc/stat) | awk -v RS="" '{printf("%02d", ($13-$2+$15-$4)*100/($13-$2+$15-$4+$16-$5))}') CPULOAD=$(uptime | tr -s " " | cut -d' ' -f9-) TOPCPU=$(ps aux --no-headers | awk '{print $3 " " $11}' | sort -rn | head -n 5) # get memory info MEMTOT=$(cat /proc/meminfo | grep MemTotal | awk '{printf ("% 0.1f", $2/1024000)}') MEMAVA=$(cat /proc/meminfo | grep MemAvailable | awk '{printf ("%0.1f", $2/1024000)}') MEMUSAGE=$(free | grep Mem | awk '{printf("%02d", $3/$2 * 100.0)}') MEMUSAGE2=$(echo "$MEMTOT GB in use") MEMUSED=$(echo "scale=2;($MEMTOT - $MEMAVA)" | bc) TOPMEM=$(ps aux --no-headers | awk '{print $4 " " $11}' | sort -rn | head -n 5) # get hard drive usage info HD=$(df -hl /dev/$PARTITION | grep $PARTITION | awk '{printf ("%02d", $5)}' | sed -e 's/%//') HDUSED=$(df -hl /dev/$PARTITION | grep $PARTITION | awk '{print $3}' | sed -e 's/G//') HDSIZE=$(df -hl /dev/$PARTITION | grep $PARTITION | awk '{print $2}' | sed -e 's/G//') TOPHD=$(df -hl /dev/$PARTITION | tail -1) # do the genmon echo "<icon>$ICON</icon><iconclick>xfce4-taskmanager</iconclick>" echo "<txt> $CPU | $MEMUSAGE | $HD </txt><txtclick>xfce4-taskmanager</txtclick>" echo "<tool>-=CPU $CPULOAD=- $TOPCPU -=MEM: $MEMUSED of $MEMUSAGE2=- $TOPMEM -=HD usage: $HDUSED of $HDSIZE GB in use=- $TOPHD</tool>" exit 0
Genmon syststats.sh Script Example |
---|
Additional genmon scripts can be found in the following online repositories (special thanks to the individual developers for creating them):
Advanced Features
Pango Text Markup Support
Both the <txt> and <tool> tags support Pango Markups. See: https://docs.gtk.org/Pango/pango_markup.html. With Pango markups, you can change text attributes like font colour, weight, size, etc, in your output string. To do so, use the <span></span> (or any convenience) tag within the <txt></txt> or <tool></tool> tags. For example, to display the output in bold red and italic, you could use something like:
echo "<txt><span weight='Bold' fgcolor='Red'><i>Test</i></span></txt>"
Result:
Genmon Pango Markup Support Example |
---|
Refer to the previous link for information on all of the properties that can be set.
Refreshing the plugin
As of version 3.99, the xfce4-genmon-plugin supports xfce4-panel plugin-event functionality to remotely force the plugin to refresh. To refresh the plugin, issue the command:
xfce4-panel --plugin-event=genmon-X:refresh:bool:true
where “genmon-X” is the widget name of the particular genmon instance. To get this name, go to the panel properties screen and on the Items tab, hover your mouse over the genmon plugin to get it's internal name.
As of version 4.2.0, an “Update Now” menu item was added to the plugin right-click menu to immediately update the plugin (this does not reset the timer):
Genmon 'Update Now' Menu Item |
---|
Enhanced Gtk3 CSS Styling Capabilities
As of version 4.0.1, CSS styling capabilities have been enhanced by providing style classes for all elements of the plugin that can be styled via themes or individual overrides (~/.config/gtk-3.0/gtk.css). For more information, see: https://gitlab.xfce.org/panel-plugins/xfce4-genmon-plugin/-/blob/master/CSS%20Styling.txt.
And as of version 4.2.0, this plugin also supports CSS tags (special thanks to @stergem) that allow you to tweak the plugin css directly from within the command/script using <css></css> tags. For example:
#!/bin/bash # set Label = Hello echo "<txt>There</txt>" echo "<txtclick>mousepad</txtclick>" echo "<css>.genmon_valuebutton {background-color:red; color:yellow} .genmon_label {color:green}</css>" echo "<tool>Hello there</tool>"
Latest Release
- xfce4-genmon-plugin 4.2.0 released (2023/04/17 01:24)
- Download current release (older versions of this component are also available here)
Source code repository
Reporting Bugs
- Reporting Bugs – List of currently open bugs and instructions on how to submit new bug reports