Skip to content

README.md

Latest commit

 

History

History
43 lines (30 loc) · 844 Bytes

README.md

File metadata and controls

43 lines (30 loc) · 844 Bytes
Raw

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