Focus Timer GNOME Shell Extension

Focus Timer is an app based on the Pomodoro Technique that helps you break work into intervals (typically 25 minutes), separated by short breaks. This builds focus and prevents burnout.

Desktop Integration Features:

• Top bar indicator to quickly start, pause, and control your timer
• Notifications showing a live countdown of your session
• Screen overlay active during breaks, designed to be easy to dismiss
• Automatic Do-Not-Disturb mode to reduce interruptions while you focus
• Lock screen widget to check your timer without having to unlock

Note

This extension requires the Focus Timer app to be installed on your system.

Screenshots

Installation

Compatibility: This extension works with GNOME Shell 48+.

From extensions.gnome.org

At this moment the extension is not yet published.

Building from source

Clone the repository:

git clone https://github.com/focustimerhq/gnome-shell-extension-focus-timer.git
cd gnome-shell-extension-focus-timer

Build and install:

meson setup build --prefix=~/.local
ninja -C build
ninja -C build install

Enable it:

gnome-extensions enable focus-timer@focustimerhq.github.io

You need to log out for GNOME Shell to recognise it or to apply updates. The indicator will show up when you run the Focus Timer app. If still can't see it, check Troubleshooting section.

From .zip bundle

Only install files from a trusted source.

gnome-extensions install --force focus-timer@focustimerhq.github.io.zip

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 extension, please consider leaving a review on GNOME Extensions (once published).

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.