LinuxCommandLibrary

termdown

Terminal countdown timer and stopwatch

TLDR

Countdown timer

$ termdown [5m]
copy
Countdown to time
$ termdown [14:30]
copy
With title
$ termdown -t "[Break time]" [10m]
copy
Blink at end
$ termdown -b [5m]
copy
Play sound at end
$ termdown -v [alarm.wav] [5m]
copy
Critical time warning
$ termdown -c [30] [5m]
copy

SYNOPSIS

termdown [-t title] [-b] [-v file] [options] time

DESCRIPTION

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 play a sound file when it reaches zero, blink the display, and show a custom title. A critical threshold option changes the display color when time is running low. The -s flag switches to stopwatch mode, counting upward instead of down.

PARAMETERS

-t TITLE

Title text.
-b
Blink at zero.
-v FILE
Sound file.
-c SEC
Critical threshold.
-f FONT
Figlet font.
-s
Stopwatch mode.

CAVEATS

Terminal display only. Figlet fonts optional. No background running.

HISTORY

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

SEE ALSO

timer(1), figlet(1), watch(1)

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community