Pomodoro Timer
A simple focus timer that runs in your terminal. It follows the "Pomodoro" technique: work for 25 minutes, take a 5 minute break, repeat. While it runs you'll see a countdown and a progress bar, and your terminal beeps when each focus session or break is over.
It's a single Python file with nothing extra to install.
What you need
- Python 3.7 or newer (already on most Macs and Linux computers; on Windows, get it from python.org).
How to start it
- Download
pomodoro.py. - Open a terminal (on Windows: Command Prompt or PowerShell) in the folder where you saved it.
- Run:
python3 pomodoro.pyOn Windows, use python pomodoro.py (or py pomodoro.py) instead.
The timer keeps going (focus, break, focus, break...) until you press Ctrl+C. When you stop, it tells you how many focus sessions you finished.
Options
You can change the times if you want:
| Option | What it does | Example |
|---|---|---|
--focus MINUTES | Length of each focus session (default 25) | --focus 50 |
--break MINUTES | Length of each break (default 5) | --break 10 |
--rounds N | Stop after N focus sessions (default: keep going) | --rounds 4 |
--quiet | Don't beep | --quiet |
For example, four rounds of 50 minutes work with 10 minute breaks:
python3 pomodoro.py --focus 50 --break 10 --rounds 4Run python3 pomodoro.py --help to see all options.
Not hearing a beep?
The beep is the terminal's built-in "bell". Some terminals have it turned off or show a visual flash instead. Check your terminal's settings for "bell" or "audible bell" if you'd like to hear it.