countdown-pomodoro
A terminal Pomodoro timer with big colored digits, automatic break cycles and
sound cues. A fork of antonmedv/countdown
reworked into a Pomodoro.

Install
go install github.com/Chyste/countdown-pomodoro@latest
Usage
Start a session with the defaults (25m work, 5m short break, 15m long break, 8 pomodoros):
countdown-pomodoro
Set your own durations and session length:
countdown-pomodoro -work 50m -short 10m -long 20m -rounds 6
| Flag |
Meaning |
Default |
-work |
work duration |
25m |
-short |
short break duration |
5m |
-long |
long break duration |
15m |
-rounds |
pomodoros in the whole session |
8 |
How it works
- Work runs, then a break starts on its own. After the break, press
Space to
begin the next work block.
- Every 4th pomodoro the break is a long one.
- The session ends once you finish all your rounds.
- Phases are color-coded: work is red, short break green, long break blue.
- A sound plays at the start of each phase and when the session is done (macOS
afplay).
Key bindings
Space — pause / resume a phase, or start the next work block.
Esc or Ctrl+C — quit.
License
MIT. Original countdown by Anton Medvedev.