Skip to content
A pomodoro timer for Gnome Shell
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


Gnomodoro is a Gnome Shell extension that implements a timer that helps the user to put into practice the Pomodoro Technique.

The Pomodoro Technique is a time management method developed by Francesco Cirillo in the late 1980s. The technique uses a timer to break down periods of work into 25-minute intervals called 'Pomodori' (from the Italian word for 'tomatoes') separated by breaks.

There are five basic steps to implementing the technique:

  • Decide on the task to be done
  • Set the pomodoro (timer) to 25 minutes
  • Work on the task until the timer rings
  • Take a short break (3 to 5 minutes)
  • Every four pomodori take a longer break (15 to 30 minutes)

Source: Wikipedia


From the Gnome Extensions site

  1. Gnomodoro is available here for automatic installation:

From the sources

  1. Download or clone this repository (or one of its tags)

  2. Build and install by running make install

  3. Restart Gnome Shell using ALT-F2 and then r

  4. Enable the extension by using the gnome-tweak-tool (in the Shell extensions tab)


  • Once enabled, Gnomodoro will appear in the top bar:

Pomodoro indicator

  • By activating the pomodoro mode you will enter in the loop described earlier. First you will have to define a task to work on:

Pomodoro indicator

  • Then a 25 minutes pomodoro starts:

Pomodoro indicator

  • At the end of the pomodoro, a message will tell you to take a break:

Pomodoro indicator

  • A 5-minute break starts immediately after:

Pomodoro indicator

  • At the end of the break, another pomodoro will be started by asking what the next task will be.

  • After having completed 4 pomodori in a row, there will be a longer break of 15 minutes.

  • At any time you can disable the pomodoro mode by using the menu.


Thanks to Ashish Saini for the pomodoro icon.


  • Version 1.0

    Initial release

You can’t perform that action at this time.