Installing the `timer` executable

Assuming you have Rust/Cargo installed, run this command in a terminal:

cargo install timer-cli-rs

It will make the timer command available in your PATH if you've allowed the PATH to be modified when installing Rust. cargo uninstall timer-cli-rs uninstalls.

Back to the crate overview.

Readme

Command-Line Timer

Description

A simple command-line countdown timer written in Rust.

Features

Accepts human-friendly duration formats (e.g. 10s, 5m, 2h, 1d).
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.
Can execute command on completion.

Usage

timer <duration> <*command>

*command is optional

Duration format

10s, 30sec, 60seconds
5m, 2min, 10minutes
1h, 2hr, 3hours
1d, 2days

If no duration is provided, defaults to 10 seconds.
Maximum supported duration: 10 years.

Install

cargo install timer-cli-rs

Build

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

Examples

timer 10s   'echo "10 seconds"'  
timer 5m    'echo "5 minutes"'  
timer 2h    'echo "2 hours'  
timer 1d    'echo "1 day"'

Installing the timer executable

Installing the `timer` executable