Simple commandline tool to use the pomodoro technique
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

README for omodoro


  1. Overview
  2. License
  3. Feedback, questions and contributions
  4. Requirements
  5. Usage
  6. Customization
  7. Todo list

1. Overview

omodoro is, as the name suggests, a tool for using the pomodoro technique.

Currently it provides the following features:

  • display periodic reminders for pomodori and breaks
  • option to pause and continue the cycle
  • option to abort the current pomodori or break and start the next one
  • commandline argument for user-specific pomodoro cycle
  • /home/$USER/.omodoro.conf or APPDATA\omodoro.conf configuration file for user-specific pomodoro cycle
  • runs on any system with Python installed - Linux, Windows and others

2. License

This software is released under the terms of the GNU General Public License v2:

3. Feedback, questions and contributions

There is a git repository available at github:

This software was initiated by Oliver Kraitschy ( Please feel free to send him feedback and questions regarding bugreports, feature requests, improvements, etc. via github or mail at okraits[at]arcor[dot]de.

4. Requirements

omodoro has the following requirements:

  • Python 2 or 3
  • libnotify (on all Systems except Microsoft Windows)

5. Usage

Run the script with python:

python omodoro

When omodoro is running, you can type:

  • p to pause the current pomodoro cycle
  • c to continue the current pomodoro cycle - the end time will be adjusted
  • n to abort the current pomodori or break and start the next one
  • s to get the status of the current cycle
  • t to turn the terminal bell on/off
  • q to quit omodoro

6. Customization

You can adjust the pomodoro cycle to your needs by

  1. editing the variables in the SETTINGS section of the omodoro script

  2. copying the file omodoro.conf.sample as .omodoro.conf into your home directory and modifying it

  3. adding a commandline argument by running omodoro like this:

python omodoro P-L-S-B-T


P	number of pomodori to do in a cycle
L	length of one pomodori in minutes
S	length of a short break in minutes
B	length of a long break in minutes
T	enable/disable the terminal bell to be played at the begin of each pomodoro/break. 1 for on, 0 for off.

Example with the default values:

python omodoro 4-25-5-15-0

7. Todo list

These are things which are planned to be done, at some point in the future.

  • require acknowledgement for next pomodoro/break
  • tk or gtk GUI
  • don't do a pomodoro cycle, just measure work/break times