Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
panel-plugins:xfce4-genmon-plugin:start [2019/11/12 00:23] – removed kevinbowen | panel-plugins:xfce4-genmon-plugin:start [2023/12/25 13:25] (current) – [Advanced Features] updated link toz | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ~~NOTOC~~ | ||
+ | ====== xfce4-genmon-plugin - Genmon ====== | ||
+ | This plugin cyclically spawns the indicated script/ | ||
+ | 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 | ||
+ | * **[[# | ||
+ | * **[[#Latest Release|Latest Release]]** | ||
+ | * **[[#Source Code Repository|Source Code Repository]]** | ||
+ | * **[[# | ||
+ | |||
+ | |||
+ | |||
+ | ===== Important Note about version 4.2.0 ===== | ||
+ | <note important> | ||
+ | |||
+ | ===== Usage ===== | ||
+ | If you want the plugin to display only text (original version), enter the command in the //Command// field of the // | ||
+ | |||
+ | **XML Tags** | ||
+ | |||
+ | If you want the plugin to display a personalized '' | ||
+ | |||
+ | The XML tags which can be used: | ||
+ | * **< | ||
+ | * Displays the "Text to display" | ||
+ | * eg. '' | ||
+ | * Result: {{: | ||
+ | * **< | ||
+ | * If displaying text, this tag will allow for a program/ | ||
+ | * eg. '' | ||
+ | * **< | ||
+ | * Display an image on the plugin using the complete path and name to the image file. | ||
+ | * eg. '' | ||
+ | * Result: {{: | ||
+ | * **< | ||
+ | * If using an image, this tag will allow for a program/ | ||
+ | * eg. '' | ||
+ | * **< | ||
+ | * Display an icon from the current icon theme using only the icon name. | ||
+ | * eg. '' | ||
+ | * Result: {{: | ||
+ | * Note: the < | ||
+ | * image changes with the icon theme | ||
+ | * supports panel' | ||
+ | * supports light/dark symbolic icon auto-colour changes | ||
+ | * **< | ||
+ | * If using an icon, this tag will allow for a program/ | ||
+ | * eg. '' | ||
+ | * **< | ||
+ | * Display specific content in a tooltip. | ||
+ | * eg. '' | ||
+ | * Result: {{: | ||
+ | * Note: | ||
+ | * To hide the tooltip bubble, use an empty tool tag, eg: '' | ||
+ | * The tooltip will not display with a cycle of less than 0.5 (see: [[https:// | ||
+ | * **< | ||
+ | * Display a value-based progress bar on the plugin. | ||
+ | * eg. '' | ||
+ | * Result: {{: | ||
+ | * **< | ||
+ | * This tag will allow the embedding of css tweaks directly into the plugin. | ||
+ | * eg. '' | ||
+ | * Result: {{: | ||
+ | * 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 < | ||
+ | <file sh 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="" | ||
+ | CPULOAD=$(uptime | tr -s " " | cut -d' ' -f9-) | ||
+ | TOPCPU=$(ps aux --no-headers | awk ' | ||
+ | |||
+ | # get memory info | ||
+ | MEMTOT=$(cat / | ||
+ | MEMAVA=$(cat / | ||
+ | MEMUSAGE=$(free | grep Mem | awk ' | ||
+ | MEMUSAGE2=$(echo " | ||
+ | MEMUSED=$(echo " | ||
+ | TOPMEM=$(ps aux --no-headers | awk ' | ||
+ | |||
+ | # get hard drive usage info | ||
+ | HD=$(df -hl / | ||
+ | HDUSED=$(df -hl / | ||
+ | HDSIZE=$(df -hl / | ||
+ | TOPHD=$(df -hl / | ||
+ | |||
+ | # do the genmon | ||
+ | echo "< | ||
+ | echo "< | ||
+ | echo "< | ||
+ | $TOPCPU | ||
+ | |||
+ | -=MEM: $MEMUSED of $MEMUSAGE2=- | ||
+ | $TOPMEM | ||
+ | |||
+ | -=HD usage: $HDUSED of $HDSIZE GB in use=- | ||
+ | $TOPHD</ | ||
+ | |||
+ | exit 0 | ||
+ | </ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | < | ||
+ | |||
+ | Additional genmon scripts can be found in the following online repositories (special thanks to the individual developers for creating them): | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | |||
+ | |||
+ | [[|Back To Top]] | ||
+ | ---- | ||
+ | |||
+ | ===== Advanced Features ===== | ||
+ | **Pango Text Markup Support** | ||
+ | |||
+ | Both the <txt> and < | ||
+ | |||
+ | echo "< | ||
+ | | ||
+ | Result: {{: | ||
+ | |||
+ | 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: | ||
+ | where " | ||
+ | |||
+ | As of version 4.2.0, an " | ||
+ | |||
+ | {{: | ||
+ | |||
+ | **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 (~/ | ||
+ | |||
+ | 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/ | ||
+ | <file genmonTest.sh> | ||
+ | #!/bin/bash | ||
+ | # set Label = Hello | ||
+ | echo "< | ||
+ | echo "< | ||
+ | echo "< | ||
+ | echo "< | ||
+ | </ | ||
+ | |||
+ | Result: {{: | ||
+ | |||
+ | |||
+ | [[|Back To Top]] | ||
+ | ---- | ||
+ | |||
+ | ===== Screenshots ===== | ||
+ | |||
+ | Configuration/ | ||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | About screen: | ||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | [[|Back To Top]] | ||
+ | ---- | ||
+ | |||
+ | ===== Latest Release ===== | ||
+ | |||
+ | {{rss> | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | * **[[https:// | ||
+ | |||
+ | [[|Back to Top]] | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Source code repository ===== | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | ---- | ||
+ | |||
+ | ===== Reporting Bugs ===== | ||
+ | |||
+ | * **[[: | ||
+ | |||
+ | [[|Back To Top]] | ||
+ | ---- | ||
+ | [[ : |