countdown-tui-0.1.3 is not a library.

Countdown TUI

A terminal countdown timer with big digital display, written in Rust.

This is a 100% feature-compatible Rust implementation of antonmedv/countdown.

Install

cargo install countdown-tui

Usage

Specify duration in format 1h2m3s or a target time: 02:15pm, 14:15.

countdown-tui 25s
countdown-tui 11:32

Add a command with && to run after the countdown.

countdown-tui 1m30s && echo "Time's up!"

Count up from zero.

countdown-tui -u 30s

Announce (via macOS say command) last 10 seconds.

countdown-tui -s 10s

Display a title below the countdown timer.

countdown-tui -t "Coffee Break" 30s

Key bindings

Space: Pause/Resume the countdown
Esc or Ctrl+C: Stop the countdown

Options

A terminal countdown timer with big digital display

Usage: countdown-tui [OPTIONS] <DURATION>

Arguments:
  <DURATION>  Duration or target time (e.g., 25s, 1m30s, 14:15, 02:30PM)

Options:
  -u, --up            Count up from zero
  -s, --say           Announce the time left (macOS only)  
  -t, --title <TEXT>  Display title below the countdown
  -h, --help          Print help

Examples:
  countdown-tui 25s
  countdown-tui -t "Coffee Break" 14:15
  countdown-tui 02:15PM
  countdown-tui -u 30s
  countdown-tui -s 10s

Features

⏱️ Large ASCII art digital display
🕐 Duration format: 25s, 1m30s, 1h2m3s
🕒 Time format: 14:15, 02:30PM, 10:00AM
⏯️ Pause/resume with spacebar
🔄 Count up or count down modes
🔊 Voice announcements (macOS)
📺 Responsive terminal display
🎨 Beautiful Unicode box drawing characters

Requirements

Terminal with Unicode support
macOS (for --say voice announcements)

License

MIT

fx – terminal JSON viewer
walk – terminal file manager
howto – terminal command LLM helper
countdown – original Go implementation

countdown-tui 0.1.3