Skip to content
This repository

Pomodoro extension for gnome-shell

README.md

Pomodoro for GNOME

This GNOME utility intends to help manage time according to Pomodoro Technique.

Notice: Until recently it was just an GNOME Shell extension, with latest release it became an app. It was necessary change to make ground for coming features, a todo list for instance. However, it no longer will be possible to distribute it via extensions.gnome.org, we need to figure out packaging and it will take a few months...

Features

  • Countdown timer in the GNOME Shell top panel
  • Screen notifications that can be easily dismissed
  • Hiding other notifications during pomodoro
  • Postponing pomodoro unless there is some activity
  • Option to quickly shorten/lenghten the break
  • Nagging to take a break

Screenshots

Screenshot

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 do nothing but 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

From repositories

Look for packages named gnome-shell-pomodoro or gnome-shell-extension-pomodoro.

From source

  1. Download the right version

    For GNOME 3.10 download from here.

    For GNOME 3.8 download from here.

    For GNOME 3.6 download from here and follow instructions from here.

    For GNOME 3.4 download from here and follow instructions from here.

  2. You may need to install tools and dependencies before building it

    On Ubuntu:

    sudo apt-get install gnome-common intltool valac libglib2.0-dev gobject-introspection libgirepository1.0-dev libgtk-3-dev libclutter-gtk-1.0-dev libgnome-desktop-3-dev libcanberra-dev libgdata-dev libgstreamer1.0-dev libupower-glib-dev fonts-droid
    

    On Fedora:

    sudo yum install gnome-common intltool vala vala-tools glib2-devel gobject-introspection-devel gtk3-devel clutter-gtk-devel gnome-desktop3-devel libcanberra-devel libgdata-devel gstreamer1-devel upower-devel google-droid-sans-fonts
    
  3. Build it and install:

    ./autogen.sh --prefix=/usr
    make
    sudo make install
    
  4. Launch it:

    gnome-pomodoro
    

    It will enable GNOME Shell extension. A new indicator should show up in the top panel. If it doesn't, restart GNOME Shell by hitting Alt + F2 and typing r in command.

From extensions.gnome.org

You can install older version via extensions.gnome.org. We will maintain it until more packages are available.

Advanced settings

If you still want to tinker with settings, you can use dconf-editor or gsettings from commandline. Settings for Pomodoro are in /org/gnome/pomodoro tree.

Change keyboard shortcut

As it's not possible to select a shortcut having a Super key, you need to use the commandline:

gsettings set org.gnome.pomodoro.preferences toggle-timer-key "['<Super>p']"

Reset settings to default

If you ever need to bring the app to original settings or state, you can do it by:

gsettings reset-recursively org.gnome.pomodoro

For more options see gsettings --help

Debugging

If you experience the extension causing problems, please run gnome-shell with an incantation:

DISPLAY=:0 gnome-shell --replace > gnome-shell.log 2>&1

and send us gnome-shell.log file. To comfort you, you can recover from most gnome-shell crashes using the same command.

License

GPL3. See COPYING for details.

Thanks

Thanks to our GitHub contributors.

Changelog

Version 0.10.0

  • Support for GNOME Shell 3.10
  • New layout in preferences dialog
  • Migrate to gsteramer-1.0
  • Updated translations

Version 0.9.1

  • Support for GNOME Shell 3.8
  • Improved long pause scheduling
  • Deactivate screensaver to notify start of pomodoro
  • German translation (thanks @linuxrider)
  • Bug fixes

Version 0.9.0

  • Support for GNOME Shell 3.8
  • Added a preferences dialog
  • Improved timer accuracy
  • Bug fixes

Version 0.8.1

  • Support for GNOME Shell 3.10

Version 0.8

  • Support for GNOME Shell 3.8 (thanks @haaja)
  • Brazilian Portuguese translation (thanks @aleborba)
  • Minor bug fixes

Version 0.7

  • Support for GNOME Shell 3.4 and 3.6
  • Feature: Full screen notifications
  • Feature: Reminders
  • Chinese translation (thanks @mengzhuo)
  • Czech translation (thanks @veverjak)

Version 0.6

  • 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
  • New translation: Persian (thanks @arashm)
  • 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
Something went wrong with that request. Please try again.