timewatch

Crates.iotimewatch
lib.rstimewatch
version0.1.1
created_at2025-05-07 20:24:35.749154+00
updated_at2025-05-26 18:59:31.397911+00
descriptionA terminal based stopwatch with optional messages
homepage
repositoryhttps://github.com/Foxicution/timewatch
max_upload_size
id1664430
size162,489
Paulius Lapienis (Foxicution)

documentation

README

timewatch

A terminal-based countdown timer with adaptive layout.

screenshot

Features

  • Displays time in large ASCII digits
  • Optional message bellow the target
  • Automatically chooses horizontal or vertical layout based on terminal size
  • Adapts to terminal resizes
  • Can exit early with q, ESC or Ctrc+C
  • Can pause the timer using SPACE
  • Accepts hh:mm:ss, mm:ss or just ss time format

Installation

cargo install timewatch

Usage examples

# Reminder to take a break
timewatch 1:00:00 "Break in:"
# Pomodoro
timewatch 25:00 "Pomodoro Session"
# Combine with sounds (or other commands)
timewatch 10 && play ding.wav

Can stop the timewatch anytime using q, ESC or Ctrl+C. Can pause it using SPACE.

Contributing

PRs and Issues are welcome!

License

MIT

Commit count: 16

cargo fmt