Xfce Wiki

Sub domains
 

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
panel-plugins:xfce4-genmon-plugin:start [2023/04/19 21:42] – [xfce4-genmon-plugin - Genmon] tozpanel-plugins:xfce4-genmon-plugin:start [2023/12/25 13:25] (current) – [Advanced Features] updated link toz
Line 5: Line 5:
  
   * **[[#Usage|Usage]]**   * **[[#Usage|Usage]]**
-    * **[[#XML Tags|XML Tags]]** +    * XML Tags 
-    * **[[#Example Script (system stats)|Example Script]]**+    * Example Script
   * **[[#Advanced Features|Advanced Features]]**    * **[[#Advanced Features|Advanced Features]]** 
-    * **[[#Pango Text Markup Support|Pango Text Markup Support]]** +    * Pango Text Markup Support 
-    * **[[#Refreshing the plugin|Refreshing the plugin]]** +    * Refreshing the plugin 
-    * **[[#Enhanced Gtk3 CSS Styling Capabilities|Enhanced Gtk3 CSS Styling Capabilities]]**+    * Enhanced Gtk3 CSS Styling Capabilities
   * **[[#Screenshots|Screenshots]]**   * **[[#Screenshots|Screenshots]]**
   * **[[#Latest Release|Latest Release]]**   * **[[#Latest Release|Latest Release]]**
Line 49: Line 49:
     * Note: the <icon> tag allows the following functionality:     * Note: the <icon> tag allows the following functionality:
       * image changes with the icon theme       * image changes with the icon theme
-      * supports panel's Adjust Icon Size Automatically functionality+      * supports panel's 'Adjust Icon Size Automatically' functionality
       * supports light/dark symbolic icon auto-colour changes       * supports light/dark symbolic icon auto-colour changes
     * **<iconclick>The command to be executed when clicking on the icon</click>**       * **<iconclick>The command to be executed when clicking on the icon</click>**  
Line 60: Line 60:
     * Note:     * Note:
       * To hide the tooltip bubble, use an empty tool tag, eg: ''echo "<tool></tool>"''       * 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>**   * **<bar>Percentage to display in the bar</bar>**
     * Display a value-based progress bar on the plugin.     * Display a value-based progress bar on the plugin.
Line 66: Line 67:
   * **<css>embedded CSS tweaks</css>**   * **<css>embedded CSS tweaks</css>**
     * This tag will allow the embedding of css tweaks directly into the plugin.     * 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} .genmon_label { color: lightblue; }</css>"''+    * eg. ''echo "<css>.genmon_valuebutton { background-color:green; color: yellow; padding: 5px;}</css>"''
     * Result: {{:panel-plugins:xfce4-genmon-plugin:css.png?50|}}     * Result: {{:panel-plugins:xfce4-genmon-plugin:css.png?50|}}
     * More information on css and css tweaking of the plugin in the **Advanced Features** section below.     * More information on css and css tweaking of the plugin in the **Advanced Features** section below.
Line 101: Line 102:
  
 # do the genmon # do the genmon
-echo "<icon>$ICON</icon>" +echo "<icon>$ICON</icon><iconclick>xfce4-taskmanager</iconclick>" 
-echo "<txt> $CPU | $MEMUSAGE | $HD </txt>" +echo "<txt> $CPU | $MEMUSAGE | $HD </txt><txtclick>xfce4-taskmanager</txtclick>"
-echo "<txtclick>xfce4-taskmanager</txtclick>"+
 echo "<tool>-=CPU $CPULOAD=- echo "<tool>-=CPU $CPULOAD=-
 $TOPCPU $TOPCPU
Line 119: Line 119:
  
 <note>More scripts are available at: [[https://gitlab.xfce.org/panel-plugins/xfce4-genmon-plugin/-/tree/master/scripts]].</note> <note>More scripts are available at: [[https://gitlab.xfce.org/panel-plugins/xfce4-genmon-plugin/-/tree/master/scripts]].</note>
 +
 +Additional genmon scripts can be found in the following online repositories (special thanks to the individual developers for creating them):
 +  * [[https://github.com/xtonousou/xfce4-genmon-scripts]]
 +  * [[https://github.com/almaceleste/xfce4-genmon-scripts]]
 +  * [[https://github.com/levimake/xfce4-genmon-panel-scripts]]
 +  * [[https://codeberg.org/jn/genmon-scripts]]
 +
  
 [[|Back To Top]] [[|Back To Top]]
Line 126: Line 133:
 **Pango Text Markup Support** **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> tag within the <txt></txt> or <tool></tool> tags. For example, to display the output in bold red, you could use something like:+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>"   echo "<txt><span weight='Bold' fgcolor='Red'><i>Test</i></span></txt>"
Line 136: Line 143:
 **Refreshing the plugin** **Refreshing the plugin**
  
-The xfce4-genmon-plugin supports xfce4-panel plugin-event functionality to remotely force the plugin to refresh. To refresh the plugin, issue the command:+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       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. 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, there is also now an "Update Now" menu item on the plugin right-click menu to immediately update the plugin (this does not reset the timer):+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):
  
 {{:panel-plugins:xfce4-genmon-plugin:updatenowmenu.png?150|}} {{:panel-plugins:xfce4-genmon-plugin:updatenowmenu.png?150|}}
Line 147: Line 154:
 **Enhanced Gtk3 CSS Styling Capabilities** **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 (~/.config/gtk-3.0/gtk.css). For more information, see: [[https://git.xfce.org/panel-plugins/xfce4-genmon-plugin/tree/CSS%20Styling.txt]].+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]].
  
-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:+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:
 <file genmonTest.sh> <file genmonTest.sh>
 #!/bin/bash #!/bin/bash
Line 175: Line 182:
  
 {{:panel-plugins:xfce4-genmon-plugin:genmon-about.png?350|}} {{:panel-plugins:xfce4-genmon-plugin:genmon-about.png?350|}}
- 
- 
-{{:panel-plugins:xfce4-genmon-plugin.png|:panel-plugins:xfce4-genmon-plugin.png}} 
- 
-In ^this^ example, the plugin is used to (from left to right): 
-  - display the date 
-  - mount/unmount an USB disk with 1 click 
-  - 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 
  
  
Line 192: Line 188:
  
 ===== Latest Release ===== ===== Latest Release =====
-{{rss>https://archive.xfce.org/feeds/project/xfce4-genmon-plugin 1 date description 2h}} 
  
-  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-genmon-plugin/|Previous Releases]]**+{{rss>https://archive.xfce.org/feeds/project/xfce4-genmon-plugin 1 date 2h}} 
 + 
 +[[https://gitlab.xfce.org/panel-plugins/xfce4-genmon-plugin/-/blob/master/NEWS|Read the CHANGELOG]] 
 + 
 +  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-genmon-plugin/|Download current release]]** (link also contains older versions)
  
 [[|Back to Top]] [[|Back to Top]]
  
 ---- ----
 +
 ===== Source code repository ===== ===== Source code repository =====
 +
 [[https://gitlab.xfce.org/panel-plugins/xfce4-genmon-plugin]] [[https://gitlab.xfce.org/panel-plugins/xfce4-genmon-plugin]]
 +
 ---- ----
 +
 ===== Reporting Bugs ===== ===== Reporting Bugs =====
 +
   * **[[:panel-plugins:xfce4-genmon-plugin:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs   * **[[:panel-plugins:xfce4-genmon-plugin:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs