countdown-pomodoro

command module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 14, 2026 License: MIT Imports: 8 Imported by: 0

README

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.

demo

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.

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL