termdown

termdown [-t text] [-b] [-v voice] [options] time

termdown displays countdown timers and stopwatches in the terminal using large figlet-style text for high visibility. It accepts time in various formats including seconds, minutes (e.g., 5m), hours (e.g., 1h30m), or a specific target time (e.g., 14:30).The timer can use text-to-speech (via espeak or macOS say) for spoken countdown, blink the display, and show a custom title. A critical threshold option changes the display color when time is running low. If no TIME is given, it operates in stopwatch mode and counts upward.

-t TEXT, --text TEXT

Text to display at end of countdown.

Blink at zero.

Spoken countdown using text-to-speech (requires espeak on Linux or say on macOS).

Draw final N seconds in red and announce individually with --voice (defaults to 3).

Figlet font name or path to OTF/TTF file.

Don't show seconds until critical threshold.

Use colon-separated time format.

Don't ring terminal bell at end of countdown.

Text to display on top of countdown/stopwatch.

Quit N seconds after countdown reaches zero.

File to write current remaining/elapsed time to.

Run CMD every second during countdown.

Don't use ASCII art for display.

Terminal display only. Figlet fonts are optional but recommended for large visible text. The --voice option requires espeak on Linux or say on macOS.

termdown was created as a terminal countdown timer with large figlet-style display for visibility.

figlet(1), watch(1), sleep(1)