.TH GTEATIME 1 "May 2026" "gteatime 1.0.2" "User Commands"

NAME
gteatime - lightweight GTK3 system-tray tea and coffee timer

SYNOPSIS
gteatime

DESCRIPTION
gteatime is a small GTK 3 desktop timer for tea and coffee presets inspired by kteatime. It runs as a tray application and tries to use StatusNotifierItem over D-Bus when available, falling back to the XEmbed system tray protocol on X11.

Left click on the tray icon opens the configuration window. Right click opens the preset menu. Closing the window hides it while the application continues to run in the tray.

When a timer is active, the tray tooltip shows the remaining time. When the timer finishes, a desktop notification is shown.

OPTIONS
This program currently has no command-line options.

FILES

/usr/bin/gteatime
    Program executable.

/usr/share/applications/gteatime.desktop
    Desktop entry.

/usr/share/icons/hicolor/scalable/apps/gteatime.svg
    Main application icon.

/usr/share/icons/hicolor/scalable/apps/gteatime-on.svg
    Main application systray icon when timer is on.

/usr/share/icons/hicolor/scalable/apps/gteatime-off.svg
    Main application systray icon when timer is off.

REQUIREMENTS
The desktop environment must provide either a StatusNotifierItem watcher or an X11 system tray manager.

SEE ALSO
kteatime(1)

AUTHOR
J. A. Corbal <jacorbal@gmail.com>

LICENSE
MIT License.