Skip to content

Kyllingene/timepiece

Repository files navigation

timepiece (tp)

Your command-line Rolex

Features:

  • Get the current time (tp time), date (tp date), or both (tp now)

    • Keep getting it with tp clock
    • Stop with Escape or Q
    • Lap with Enter or Space
  • Start a stopwatch (tp stopwatch)

    • Stop with Escape or Q
    • Lap with Enter, Space, or L
    • If piped (e.g. sleep 5 | tp stopwatch), times process while relaying stdin
  • Set a timer (tp timer [[[hours:]minutes:]seconds])

    • Cancel with Escape or Q
    • Pause/unpause with Enter or Space
    • Add 5 seconds with Right or A
    • Remove 5 seconds with Left or D
    • Rings using the BEL character
  • Set an alarm (tp alarm hour:minute:second AM|PM)

    • Cancel with Escape or Q
    • Rings using the BEL character
  • Enable desktop notifications with feature flag notify, for:

    • Timers
    • Alarms
    • Piped stopwatches

Installation

The best way to install, if you have cargo installed, is through that:

$ cargo install timepiece # add `--features notify` if you want desktop notifs

Non-features:

  • Background/invisible timers/alarms (make a shim, possibly)
    • This is because there don't seem to be any cross-platform fork libraries
  • Configuration of any sort (edit the source, not to sound like suckless)

If you want this name on crates.io, contact me!