Xfce Wiki

Sub domains

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.


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:

play /usr/share/sounds/freedesktop/stereo/completed.oga

A different external command may be used for a specific event by adding it in the Alarm add/edit window.


The plugin window when idle and running:

:timer1.png :timer4.png

Selecting the alarm and starting the timer:


Plugin preferences window and the alarm add/edit window:

:timer2.png :timer3.png

The alarm window:


Back To Top

Latest Release

  • xfce4-timer-plugin 1.7.2 released (2023/04/18 18:01)
    xfce4-timer-plugin 1.7.2 is now available for download from
    What is xfce4-timer-plugin?
    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.
    Release notes for 1.7.2
    - Update copyright year and bug report address
    - always keep the dialog window above
    - Allow to start any timer on timeout
    - Remove dead code generating a warning
    - Remove wrong function call
    - Do not quit the main loop on "free-data"
    - build: Add GLib requirement
    - build: Fix autotools warnings
    - Update configure.ac.in
    - Use "logo-icon-name" instead of "logo" in about dialog
    - build: Fix intltool lock file problem during make distcheck
    - Update COPYING
    - Delete "xfce4" from various strings
    - Replace GTimeVal with GDateTime
    - Context menu option to add new timer and pause/stop icons (!11)
    - Fix missing translation macro for Time's up dialog
    - Fix compilation warnings
    - autoconf: Some updates
    - Update `.gitignore`
    - Request automatic widget length
    - Properly save settings for many plugin instances
    - Create README.md. Update configure.ac.in
    - Translation Updates:
      Albanian, Arabic, Basque, Belarusian, Bulgarian, Catalan, Chinese
      (China), Chinese (Taiwan), Croatian, Czech, Danish, Dutch, Eastern
      Armenian, English (Australia), English (United Kingdom), Estonian,
      Finnish, French, Galician, German, Greek, Hebrew, Hungarian,
      Icelandic, Indonesian, Interlingue, Italian, Japanese, Korean,
      Lithuanian, Malay, Norwegian Bokmål, Occitan (post 1500), Persian
      (Iran), Polish, Portuguese, Portuguese (Brazil), Russian, Serbian,
      Slovak, Slovenian, Spanish, Swedish, Thai, Turkish, Ukrainian, Uyghur

Back to Top

Source Code Repository

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:

#PLUGIN_NAME progress {
background-color: silver;

#PLUGIN_NAME trough {
background-color: red;

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

Back To Top

Return to Main Xfce4-panel page