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-timer-plugin:start [2019/11/11 11:01] – re-organized section layout added TOC kevinbowenpanel-plugins:xfce4-timer-plugin:start [2023/07/02 10:07] (current) – Update Latest Release section kevinbowen
Line 1: Line 1:
-====== Timer ====== +~~NOTOC~~ 
-This is a simple plugin that lets the user run an alarm at a specified time or at the end of a specified countdown period.+====== xfce4-timer-plugin - Timer ====== 
 +Xfce4-timer-plugin is a simple plugin that lets the user run an alarm at a specified time or at the end of a specified countdown period.
  
-  * **[[start#Screenshots|Screenshots]]** +  * **[[#Screenshots|Screenshots]]** 
-  * **[[start#Latest Release|Latest Release]]** +  * **[[#Latest Release|Latest Release]]** 
-  * **[[start#Source Code Repository|Source Code Repository]]** +  * **[[#Source Code Repository|Source Code Repository]]** 
-  * **[[start#Reporting Bugs|Reporting Bugs]]**+  * **[[#Known Issues|Known Issues]]** 
 +  * **[[#Reporting Bugs|Reporting Bugs]]** 
 + 
 +----
  
 ===== Usage ===== ===== Usage =====
-The plugin is quite simple -- it displays a progressbar showing the percentage of the time elapsed. Left-clicking on the plugin area opens a menu of available alarms. After selecting one, the user can start or stop the timer by selecting "start/stop timer" entry in the same menu. New alarms are added through the preferences window. Each alarm is either a countdown or is run at a specified time. By default a simple dialog pops up at the end of the countdown. The user can choose an external command to be run as the alarm and may also choose to have this repeated a specified number of times with a given interval between repetitions.+The plugin consists of a Panel icon and a Properties window. 
 + 
 +==== Panel icon ==== 
 +The icon displays a progress bar showing the percentage of the time 
 +elapsed. The bar changes color when active from silver to blue. 
 +Left-clicking on the icon opens a menu of available alarms. After selecting 
 +one, the user can start or stop the timer by selecting the "start/stop 
 +timer" entry in the same menu. Right-clicking on it provides access to 
 +Properties. 
 + 
 +==== Properties window ===== 
 +The Xfce4 Timer Options window allows users to add, edit, remove and 
 +arrange alarms. 
 + 
 +Each alarm is either a countdown or is run at a specified time. By default 
 +a simple dialog pops up at the end of the countdown. 
 + 
 +The user can choose an external command to be run as the alarm command for 
 +all events, or for just a particular one. An option allows this command to 
 +be repeated a specified number of times with a given interval between 
 +repetitions. Here is an example that uses a simple ping: 
 +<code>play /usr/share/sounds/freedesktop/stereo/completed.oga</code> 
 +A different external command may be used for a specific event by adding it 
 +in the Alarm add/edit window. 
 + 
 +---- 
  
 ===== Screenshots ===== ===== Screenshots =====
Line 35: Line 65:
 ===== Latest Release ===== ===== Latest Release =====
  
-==== 1.7.0 (2018/01/25) ==== +{{rss>https://archive.xfce.org/feeds/project/xfce4-timer-plugin 1 date 2h}}
-[[http://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/1.7/xfce4-timer-plugin-1.7.0.tar.bz2|xfce4-timer-plugin-1.7.0.tar.bz2]]+
  
-**SHA-256 Hash:** 2e4e5343e39926230cc981d5fe56cd58a2f3817d2e9b6089b5673a2e39bf7e9b \\ +[[https://gitlab.xfce.org/panel-plugins/xfce4-timer-plugin/-/blob/master/NEWS|Read the CHANGELOG]] 
-**SHA-1 Hash:** f8f502eaee45843652ec869b730a92064d42e483 \\ + 
-**MD5 Hash:** 32e6a14e80bf9a93db2f2b3bfd7de920+  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/|Download current release]]** (link also contains older versions) 
 + 
 +[[|Back to Top]]
  
 ---- ----
  
 ===== Source Code Repository ===== ===== Source Code Repository =====
-[[https://git.xfce.org/panel-plugins/xfce4-timer-plugin/|]] 
  
-===== Reporting Bugs =====+[[https://gitlab.xfce.org/panel-plugins/xfce4-timer-plugin]]
  
-  * **[[:xfce:xfce4-panel:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs+---- 
 + 
 +===== Known Issues ===== 
 + 
 +The icon may be nearly invisible against some themes. The colors being used 
 +can be adjusted with a code snippet in the css file. For GTK3, the 
 +following code can be used to adjust inactive ("trough") and active 
 +("progress") colors. For example: 
 +<code>#PLUGIN_NAME progress { 
 +background-color: silver; 
 +} 
 + 
 +#PLUGIN_NAME trough { 
 +background-color: red; 
 +} </code> 
 +The actual plugin name, usually something like *xfce4-timer-plugin-2* where 
 +the widget number at the end is particular to individual desktops, can be 
 +found by hovering over its widget on the  Panel Properties > Items tab.
  
 ---- ----
 +
 +===== Reporting Bugs =====
 +  * **[[:panel-plugins:xfce4-timer-plugin:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs
 +
 +
 +
 [[|Back To Top]] [[|Back To Top]]
 +----
 +[[ :xfce:xfce4-panel:start:|Return to Main Xfce4-panel page]]