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 [2020/12/24 21:07] – [Usage] toz | panel-plugins:xfce4-genmon-plugin [2021/03/18 14:43] (current) – removed kevinbowen | ||
---|---|---|---|
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 image, a bar, a button and a personalized tooltip. | ||
- | |||
- | * **[[# | ||
- | * **[[#Latest Release|Latest Release]]** | ||
- | * **[[#Source Code Repository|Source Code Repository]]** | ||
- | * **[[# | ||
- | |||
- | |||
- | ===== 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: | ||
- | * ''< | ||
- | * ''< | ||
- | * ''< | ||
- | * ''< | ||
- | * ''< | ||
- | * ''< | ||
- | * ''< | ||
- | * ''< | ||
- | |||
- | The < | ||
- | * image changes with the icon theme | ||
- | * supports panel' | ||
- | * supports light/dark symbolic icon auto-colour changes | ||
- | |||
- | If None of the tags are detected in the result of the command, the plugin returns to its original behaviour (displaying the result of the command). | ||
- | |||
- | **Example Script (cpu temperature)** | ||
- | |||
- | Here's a simple example of a plugin displaying the Temp of the CPU in the panel | ||
- | (with an icon) and the Freq in a Tooltip: | ||
- | <file sh cuptemp.sh> | ||
- | #!/bin/bash | ||
- | echo "< | ||
- | declare -i cpuFreq | ||
- | cpuFreq=$(cat / | ||
- | if [ $cpuFreq -ge 1000 ] | ||
- | then | ||
- | cpu=$(echo $cpuFreq | cut -c1).$(echo $cpuFreq | cut -c2)GHz | ||
- | else | ||
- | cpu=${cpuFreq}MHz | ||
- | fi | ||
- | echo "< | ||
- | echo "< | ||
- | </ | ||
- | |||
- | PS: Depending on your configuration, | ||
- | |||
- | **Another Example Script (keyboard leds)** | ||
- | |||
- | Here's a another simple example of a plugin displaying the keyboard LED states of the caps, num and scroll lock keys: | ||
- | <file sh kbdleds.sh> | ||
- | #!/bin/bash | ||
- | # genmon script to display status of keyboard LEDS | ||
- | # genmon properties: | ||
- | # | ||
- | # Label = optional Label preceeding output | ||
- | # | ||
- | # Font = the font to use - monospace fonts keep the widget from resizing | ||
- | |||
- | # configuration | ||
- | FG=" | ||
- | OBC=" | ||
- | |||
- | # code | ||
- | STATE=($(xset q | grep Caps\ Lock | awk ' | ||
- | CAPS=$([[ ${STATE[0]} == " | ||
- | NUM=$([[ ${STATE[1]} == " | ||
- | SCROLL=$([[ ${STATE[2]} == " | ||
- | |||
- | # genmon | ||
- | echo "< | ||
- | echo "< | ||
- | echo "NUM = ${STATE[1]}" | ||
- | echo " | ||
- | |||
- | exit 0 | ||
- | </ | ||
- | |||
- | More scripts are available at: [[http:// | ||
- | |||
- | **Pango Markups in the <txt> tag** | ||
- | |||
- | Both the <txt> and < | ||
- | |||
- | echo "< | ||
- | |||
- | Refer to the previous link for information on all of the properties that can be set. | ||
- | |||
- | **Refreshing the plugin** | ||
- | |||
- | The xfce4-genmon-plugin now supports xfce4-panel plugin-event functionality. Currently it only supports the " | ||
- | |||
- | To refresh the plugin, issue the command: | ||
- | |||
- | xfce4-panel --plugin-event=genmon-X: | ||
- | where " | ||
- | |||
- | |||
- | **Enhanced Gtk3 CSS Styling Capabilities** | ||
- | |||
- | 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 (~/ | ||
- | |||
- | // | ||
- | |||
- | |||
- | [[|Back To Top]] | ||
- | ---- | ||
- | |||
- | ===== Screenshots ===== | ||
- | {{: | ||
- | |||
- | In this example, the plugin is used to (from left to right): | ||
- | - display the date | ||
- | - mount/ | ||
- | - display the CPU temperature (and the frequency in the tooltip) | ||
- | - display the HD temperature | ||
- | - display the state of the 2 batteries of my laptop | ||
- | - display the WIFI quality | ||
- | |||
- | |||
- | |||
- | {{: | ||
- | |||
- | In this example, we see the gmail checker script in action: | ||
- | - plugin display shows icon indicating state of new emails available | ||
- | - tooltip shows number of new messages, sender/ | ||
- | - clicking on the icon launches your email program | ||
- | |||
- | |||
- | |||
- | {{: | ||
- | |||
- | In this example, we see the sysstat script in action: | ||
- | - plugin display shows optional icon and 3 readings (cpu, memory, hard drive usage) | ||
- | - tooltip shows top 5 cpu and memory uses and hard drive space usage | ||
- | - clicking on the text output launches xfce4-taskmanager (//ver. 3.99 or greater//) | ||
- | |||
- | |||
- | |||
- | {{: | ||
- | |||
- | In this example, we see the google calendar checker script in action: | ||
- | - plugin display shows icon indicating state of new upcoming appointments | ||
- | - tooltip shows a listing of upcoming appointments | ||
- | - clicking on the icon opens google calendar in your browser | ||
- | |||
- | |||
- | |||
- | {{: | ||
- | {{: | ||
- | |||
- | In this example, we see the twit (Twitter Timeline Notifier) script in action: | ||
- | - plugin display shows icon indicating state of new tweets in your timeline | ||
- | - libnotify notifications will be sent with new tweets | ||
- | - tool tip will show new and optionally recent tweets | ||
- | - clicking on the plugin icon can either execute a program, display a yad dialog with all recent tweets (above image), or compose and send a tweet. | ||
- | |||
- | Most of the scripts are available in the plugin archive. | ||
- | |||
- | [[|Back To Top]] | ||
- | ---- | ||
- | |||
- | ===== Latest Release ===== | ||
- | ==== 4.1.0 (2020/ | ||
- | [[https:// | ||
- | |||
- | **SHA-256 Hash**: d1256b4b47545c7bdb16842b21eaf3ac167be443e8f2f1093cf4209e65c84e7d \\ | ||
- | **SHA-1 Hash**: 4d477c99b06f9786e5b30a96d0d015f141ff041c | ||
- | |||
- | ---- | ||
- | ===== Release History ===== | ||
- | ==== 4.1.0 (2020/ | ||
- | * Add basic GitLab pipeline | ||
- | * Updated README file | ||
- | * Add DBG anchors | ||
- | * Add < | ||
- | * Make Save translatable | ||
- | * Fix config values sometimes going to default | ||
- | * Fix label sometimes re-appearing | ||
- | * Enable multi-row support | ||
- | * Remove unused variables and code | ||
- | * Fix indentation | ||
- | * Catch some edge cases | ||
- | * Set tmp variable default values | ||
- | * Fix period spinner display when cancelled | ||
- | * Fix label toggle display when cancelled | ||
- | * Fix font display when cancelled | ||
- | * Support new libxfce4ui API | ||
- | * Change close to save | ||
- | * Closing config window cancels changes | ||
- | * Change layout of config dialog | ||
- | * Make tooltips translatable | ||
- | * Update support URLs to docs.xfce.org | ||
- | * Allow compilation with panel 4.15 | ||
- | * Replace deprecated xfce_create_panel_button | ||
- | ==== 4.0.1 (2017/ | ||
- | * Allow pango markup in tooltip as well | ||
- | * Added some extra sample scripts (twit, google calendar, sysstat) | ||
- | * Enhanced CSS styling capabilites (see 'CSS Styling.txt' | ||
- | * Fix progressbar wrong direction | ||
- | |||
- | ==== 4.0.0 (2017/ | ||
- | * Fix PangoFontDescription not being able to display initial default string | ||
- | |||
- | ==== 3.99 (2016/ | ||
- | * Port to Gtk3 | ||
- | * Fix font styling to work with Gtk 3.22 | ||
- | * Add support for " | ||
- | * Fix default tooltip does not work (bug #11284) | ||
- | * Add < | ||
- | |||
- | ==== 3.4 (2012/ | ||
- | * Port from libxfcegui4 to libxfce4ui | ||
- | * Install as a shared library rather than an executable | ||
- | * No longer uses troublesome fixed-length text buffers | ||
- | * Bug fixes | ||
- | |||
- | ===== Recent Changes ===== | ||
- | {{rss> | ||
- | |||
- | ===== Getting it ===== | ||
- | The normal (and best) way to get this plugin is to use the package manager or port system of your operating system. | ||
- | |||
- | If it isn't available there, or if you want a different version, you can download it in source form from [[http:// | ||
- | |||
- | ---- | ||
- | ===== Source code repository ===== | ||
- | [[https:// | ||
- | ---- | ||
- | ===== Reporting Bugs ===== | ||
- | * **[[: | ||
- | |||
- | [[|Back To Top]] | ||
- | ---- | ||
- | [[ : |