https://github.com/patsuckow/pomodorotimer
Console Pomodoro timer with playing the melody of the signal or with the generation of an end time signal. Displays a push notification on Linux and Mac OS X.
https://github.com/patsuckow/pomodorotimer
cli countdown countdown-timer eta freelance freelancer-time pomodoro pomodoro-technique pomodoro-timer pomodoro-timer-music pomodorotimer productivity productivity-timer productivity-tools stopwatch time-management time-management-tools timer timer-counter tomato
Last synced: about 1 month ago
JSON representation
Console Pomodoro timer with playing the melody of the signal or with the generation of an end time signal. Displays a push notification on Linux and Mac OS X.
- Host: GitHub
- URL: https://github.com/patsuckow/pomodorotimer
- Owner: patsuckow
- License: gpl-3.0
- Created: 2019-12-29T20:32:38.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2025-09-15T19:33:25.000Z (8 months ago)
- Last Synced: 2026-01-03T04:59:05.727Z (4 months ago)
- Topics: cli, countdown, countdown-timer, eta, freelance, freelancer-time, pomodoro, pomodoro-technique, pomodoro-timer, pomodoro-timer-music, pomodorotimer, productivity, productivity-timer, productivity-tools, stopwatch, time-management, time-management-tools, timer, timer-counter, tomato
- Language: Python
- Homepage: https://pypi.org/project/pomodorotimer/
- Size: 273 KB
- Stars: 21
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- Funding: .github/FUNDING.yml
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
README
# pomodorotimer (CLI Pomodoro Timer)
Console Pomodoro timer with playing the melody of the signal or with the
generation of an end time signal. Displays a push notification on Linux and
Mac OS X.
**Support**: [](https://www.paypal.me/patsuckow) or [](https://www.buymeacoffee.com/patsuckow)
# Pomodoro Technique:
Pomodoro Technique - [see](https://en.wikipedia.org/wiki/Pomodoro_Technique)
We will use the traditional Pomodoro scheme:
### It is important:
**According to the principle of the Pomodoro technique - if you are
distracted while doing work, then you must interrupt the current time
and start a new Pomodoro. And this means that you need to write time in to
the database only after the specified time has passed and not earlier.**
**If you follow this principle, the Pomodoro Technique will be for you exactly
the tool for which it was invented, namely, not to calculate the time of your
work and breaks in work, but to make you concentrate on continuous and
concentrated execution of works during one Pomodoro, i.e. within 25 minutes.**
---
We call the program from any directory in the console and set the countdown
time:
When the time ends, a sound signal will be played, push notification will be
displayed and it is proposed to enter a new countdown time. And also, it will
display the time that is OUT, in the form of a colored time bar, where:
- red color - working time (25 minutes)
- green color - time for a short or long break (5, 15 or 30 minutes)
The type of push notification depends on your OS and the type of graphical
shell used, for example:
## How to install:
#### From PyPI:
pip install pomodorotimer
#### From sources:
Alternatively you can install **pomodorotimer** from sources directory:
git clone https://github.com/patsuckow/pomodorotimer
cd pomodorotimer
pip install -r requirements.txt
pip install .
cd ..
rm -rf pomodorotimer
## How run **pomodorotimer**:
```
pomodoro
```
## Work with statistics Pomodoro`s:
Get statistics today:
```
pomodoro --statistic=today
```
We get something like this in the browser window:
All-Time Statistics:
```
pomodoro --statistic=all
```
We get something like this in the browser window:
Delete (clear) statistics for today:
```
pomodoro --statistic=delete-today
```
Delete (clear) all statistics:
```
pomodoro --statistic=delete-all
```
## Requirements:
See in requirements.txt
**pomodorotimer** works with python 3.10.13 or higher.
## How uninstall **pomodorotimer** ðŸ˜:
```
pip uninstall pomodorotimer
```
## Licence:
## Authors:
**Alexey Patsukov 🇷🇺** - [GitHub profile](https://github.com/patsuckow)
### Submit issues
If you spotted something weird in application behavior or want to propose a
feature you are welcome.
### Write code
If you are eager to participate in application development and to work on an
existing issue (whether it should
be a bugfix or a feature implementation), fork, write code, and make a pull
request right from the forked project page.
### Spread the word
If you have some tips and tricks or any other words that you think might be of
interest for the others — publish it
wherever you find convenient.
Read also:
- https://francescocirillo.com
- https://habr.com/ru/post/446996/
- http://career-philol.ru/page/adaptive/id341091/blog/3189767/