Pomodoro extension for GNOME Shell

This GNOME Shell extension intends to help manage time according to Pomodoro Technique.

Features

• Countdown timer in the GNOME Shell top panel
• Full screen notifications that can be easily dismissed
• Reminders to nag you about taking a break
• Sets your IM (Empathy) status to busy
• Hides any notifications until the start of break

What is the pomodoro technique?

The Pomodoro Technique is a time and focus management method which improves productivity and quality of work. The name comes from a kitchen timer, which can be used to keep track of time. In short, you are supposed to focus on work for around 25 minutes and then have a well deserved break in which you should relax. This cycle repeats once it reaches 4th break – then you should take a longer break (have a walk or something). It's that simple. It improves your focus, physical health and mental agility depending on how you spend your breaks and how strictly you follow the routine.

You can read more on pomodoro technique here.

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.

Installation

Web based (recommended)

https://extensions.gnome.org/extension/53/pomodoro/

Archlinux

Get from AUR

Gentoo

Available at Maciej's overlay here. Instructions here.

Direct from source

1. Get zipball

   • for GNOME Shell 3.4
   • for GNOME Shell 3.6
   • Unstable – our master branch

2. Build it and install

    ./autogen.sh --prefix=/usr
    make zip
    unzip _build/gnome-shell-pomodoro.0.6.zip -d ~/.local/share/gnome-shell/extensions/[email protected]
   

   To install it system-wide, you could do

    ./autogen.sh --prefix=/usr
    sudo make install
   

   …and after a successful installation remove the local extension

    rm -R ~/.local/share/gnome-shell/extensions/[email protected]
   

3. Enable the extension using gnome-tweak-tool (Shell Extensions → Pomodoro) or via following commandline:

    gsettings get org.gnome.shell enabled-extensions
    gsettings set org.gnome.shell enabled-extensions [<values from get above>, [email protected]]
   

4. Press Alt + F2, and r in command to restart GNOME Shell

Usage

• Use toggle switch (or Ctrl+Alt+P) to toggle timer on/off
• You can configure behavior of the extension in Options menu

For a list of configurable options, please refer wiki

License

GPL3. See COPYING for details.

Thanks

Thanks to our GitHub contributors.

Changelog

Unstable

• Czech translation
• Support for GNOME Shell 3.4 and 3.6
• Full screen notifications
• Added reminders

Version 0.6

• New translation: Persian (thanks @arashm)
• Feature: Support for GNOME Shell 3.4
• Breaking change: Dropped support for older gnome-shell versions due to incompatible APIs
• Feature: Support for "Away from desk" mode
• Feature: Ability to change IM presence status based on pomodoro activity
• Fixed issues #38, #39, #41, #42, #45 and more

Version 0.5

• Bunch of cleanups, user interface awesomeness [Issue #37, Patch from @kamilprusko]
• Config options are changed to more meaningful names [above patch]

Version 0.4

• Sound notification at end of a pomodoro break [Issue #26, Patch from @kamilprusko]
• System wide config file support [Patch from @mgrela]
• Support to skip breaks in case of persistent message [Patch from @amanbh]

• Some minor bug fixes, and keybinder3 requirement is now optional