Xfce Wiki

Sub domains
 

Differences

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

Link to this comparison view

Next revision		Previous revision
panel-plugins:xfce4-timer-plugin:start [2019/11/09 11:12] – created kevinbowenpanel-plugins:xfce4-timer-plugin:start [2023/07/02 10:07] (current) – Update Latest Release section kevinbowen
Line 1: Line 1:
-====== Timer ======+~~NOTOC~~ 
 +====== 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.
  
-===== About ===== +  * **[[#Screenshots|Screenshots]]** 
-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.+  * **[[#Latest Release|Latest Release]]** 
 +  * **[[#Source Code Repository|Source Code Repository]]** 
 +  * **[[#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.
  
-===== Screenshots =====+==== 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.
  
-The plugin window when idle and running:+==== Properties window ===== 
 +The Xfce4 Timer Options window allows users to add, edit, remove and 
 +arrange alarms.
  
-{{:projects:panel-plugins:timer1.png|:timer1.png}} +Each alarm is either a countdown or is run at a specified time. By default 
-{{:projects:panel-plugins:timer4.png|:timer4.png}}+a simple dialog pops up at the end of the countdown.
  
-Selecting the alarm and starting the timer:+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.
  
-{{:projects:panel-plugins:timer6.png|:timer6.png}}+----
  
-Plugin preferences window and the alarm add/edit window: 
  
-{{:projects:panel-plugins:timer2.png|:timer2.png}} +===== Screenshots =====
-{{:projects:panel-plugins:timer3.png|:timer3.png}}+
  
-The alarm window:+The plugin window when idle and running:
  
-{{:projects:panel-plugins:timer5.png|:timer5.png}}+{{:panel-plugins:timer1.png|:timer1.png}} 
 +{{:panel-plugins:timer4.png|:timer4.png}}
  
 +Selecting the alarm and starting the timer:
  
-===== Releases ===== +{{:panel-plugins:timer6.png|:timer6.png}}
- +
- This plugin requires XFCE >= 4.6.+
  
 +Plugin preferences window and the alarm add/edit window:
  
 +{{:panel-plugins:timer2.png|:timer2.png}}
 +{{:panel-plugins:timer3.png|:timer3.png}}
  
 +The alarm window:
  
 +{{:panel-plugins:timer5.png|:timer5.png}}
  
 +[[|Back To Top]]
 +----
  
 +===== Latest Release =====
  
 +{{rss>https://archive.xfce.org/feeds/project/xfce4-timer-plugin 1 date 2h}}
  
 +[[https://gitlab.xfce.org/panel-plugins/xfce4-timer-plugin/-/blob/master/NEWS|Read the CHANGELOG]]
  
-==== For Xfce >=4.6 ====+  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/|Download current release]]** (link also contains older versions)
  
 +[[|Back to Top]]
  
-[[http://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/1.0/xfce4-timer-plugin-1.0.0.tar.bz2|xfce4-timer-plugin-1.0.0.tar.bz2]]+----
  
-Older versions:+===== Source Code Repository =====
  
-[[http://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/0.6/xfce4-timer-plugin-0.6.4.tar.bz2|xfce4-timer-plugin-0.6.4.tar.bz2]]+[[https://gitlab.xfce.org/panel-plugins/xfce4-timer-plugin]]
  
-[[http://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/0.6/xfce4-timer-plugin-0.6.3.tar.bz2|xfce4-timer-plugin-0.6.3.tar.bz2]]+----
  
-[[http://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/0.6/xfce4-timer-plugin-0.6.2.tar.bz2|xfce4-timer-plugin-0.6.2.tar.bz2]]+===== Known Issues =====
  
-[[http://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/0.6/xfce4-timer-plugin-0.6.1.tar.bz2|xfce4-timer-plugin-0.6.1.tar.bz2]]+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; 
 +}
  
-[[http://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/0.6/xfce4-timer-plugin-0.6.tar.bz2|xfce4-timer-plugin-0.6.tar.bz2]]+#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.
  
-[[http://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/0.5/xfce4-timer-plugin-0.5.1.tar.bz2|xfce4-timer-plugin-0.5.1.tar.bz2]]+----
  
-[[http://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/0.5/xfce4-timer-plugin-0.5.tar.bz2|xfce4-timer-plugin-0.5.tar.bz2]] +===== Reporting Bugs ===== 
-===== Dependencies =====+  * **[[:panel-plugins:xfce4-timer-plugin:bugs|Reporting Bugs]]** -- Open bug reports and how to report new bugs
  
-This plugin does not have any external dependencies.  
  
-===== Authors ==== 
  
-- Kemal Ilgar Eroğlu+[[|Back To Top]] 
 +---- 
 +[[ :xfce:xfce4-panel:start:|Return to Main Xfce4-panel page]]