Focus Timer

Focus Timer (formerly gnome-pomodoro) is a time-management app built around the Pomodoro Technique, helping you maintain focus and prevent burnout through structured work and break intervals.

Key features:

• Customizable work session and break lengths
• Screen overlay during breaks
• System tray icon
• Hotkeys (global shortcuts)
• Daily, weekly, and monthly statistics
• Extensible via custom shell commands, D-Bus, and CLI
• GNOME Shell extension for deeper desktop integration

Screenshots

Installation

Flatpak (recommended)

To get latest releases we recommend installing the app from Flathub.

Installing from CLI:

flatpak install flathub io.github.focustimerhq.FocusTimer
flatpak run io.github.focustimerhq.FocusTimer

To migrate data from the old gnome-pomodoro app, copy file ~/.local/share/gnome-pomodoro/database.sqlite to ~/.var/app/io.github.focustimerhq.FocusTimer/data/focus-timer/database.sqlite.

The version on Flathub doesn't have the ability to run custom scripts, shown as Automation panel in the Preferences window.

Distributions

Find a community-maintained package in your distro repos:

Fedora

sudo dnf install gnome-pomodoro

Arch Linux

Install gnome-shell-pomodoro from the AUR.

OpenSUSE

sudo zypper install gnome-pomodoro

Building from source

To build the application from source, you will need meson, ninja, and the necessary development headers (GLib, GTK+, etc.).

Clone the repository:

git clone https://github.com/focustimerhq/FocusTimer.git focus-timer
cd focus-timer

Build and install:

meson setup build --prefix=/usr
ninja -C build
sudo ninja -C build install

Run:

focus-timer

The app will try to migrate data from the old gnome-pomodoro app at first run.

If you decide to uninstall it. Run: sudo ninja -C build uninstall.

Support & Feedback

• Issues & Bug Reports: Check the Troubleshooting on how to check logs. Report it on our issue tracker.
• Feature Requests: Open a feature request on GitHub.
• Questions & Discussions: Join our Discussions page for help and general chat.
• Reviews: If you enjoy the app, please leave a review in the software centre you use.

Contributing

We welcome contributions! Please refer to CONTRIBUTING.md for details on setting up your development environment, coding guidelines, and translation instructions.

Donations

If you'd like to support the development of Focus Timer, you can use GitHub, Liberapay, Ko-Fi or PayPal. Thank you!

License

This software is licensed under the GPL 3.

This project is not affiliated with, authorized by, sponsored by, or otherwise approved by GNOME Foundation and/or the Pomodoro Technique®. The GNOME logo and GNOME name are registered trademarks or trademarks of GNOME Foundation in the United States or other countries. The Pomodoro Technique® and Pomodoro™ are registered trademarks of Francesco Cirillo.