Skip to content

focustimerhq/FocusTimer

Repository files navigation

Focus Timer

Focus Timer (formerly gnome-pomodoro) is a time-management application that helps with taking breaks according to Pomodoro Technique. It intends to help maintain concentration and prevent burnout.

Key features:

  • Customizable work session and break lengths
  • Visual and audio notifications
  • Time tracking and statistics
  • GNOME desktop integration
  • Screen overlay during breaks
  • Run custom commands after Pomodoro or break


Get it on Flathub

Screenshots

Timer

Compact timer

Daily stats

Monthly stats

Preferences

Screen overlay


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

Ubuntu / Debian

sudo apt install gnome-shell-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 Liberapay 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.

About

A time management utility for GNOME based on the pomodoro technique!

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors

Languages