timer-cli-rs 1.0.0

A super lightweight command-line countdown timer.
timer-cli-rs-1.0.0 is not a library.

Timer CLI

Description

A simple command-line countdown timer written in Rust.

Features

  • Accepts human-friendly duration formats (e.g., 10s, 5m, 2h, 1d, 10 seconds).
  • Defaults to 10 seconds if no duration is provided.
  • Caps maximum duration at 10 years.
  • Displays time remaining in HH:MM:SS.
  • Clears and updates the line dynamically.
  • Handles most errors gracefully.

Usage

timer <duration>

Duration format

  • 10s, 30sec, 45seconds
  • 500ms, 1500msec
  • 5m, 2min, 10minutes
  • 1h, 2hr, 3hours
  • 1d, 2days

If no duration is provided, defaults to 10 seconds. Maximum supported duration: 10 years. Ignores whitespace between time and duration (5 s).

Examples

timer 10s     # 10 seconds
timer 5m      # 5 minutes
timer 2h      # 2 hours
timer 1d      # 1 day

Build

git clone https://github.com/Andrew-McCall/timer-cli-rs.git
cd timer-cli-rs
cargo build --release
./target/release/timer 30s

License

MIT License Copyright (c) 2025 Andrew McCall