~~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.

  * **[[#Screenshots|Screenshots]]**
  * **[[#Latest Release|Latest Release]]**
  * **[[#Source Code Repository|Source Code Repository]]**
  * **[[#Known Issues|Known Issues]]**
  * **[[#Reporting Bugs|Reporting Bugs]]**

----

===== Usage =====
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 =====

The plugin window when idle and running:

{{:panel-plugins:timer1.png|:timer1.png}}
{{:panel-plugins:timer4.png|:timer4.png}}

Selecting the alarm and starting the timer:

{{:panel-plugins:timer6.png|:timer6.png}}

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]]

  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-timer-plugin/|Download current release]]** (link also contains older versions)

[[|Back to Top]]

----

===== Source Code Repository =====

[[https://gitlab.xfce.org/panel-plugins/xfce4-timer-plugin]]

----

===== 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]]
----
[[ :xfce:xfce4-panel:start:|Return to Main Xfce4-panel page]]