timepiece

Crates.iotimepiece
lib.rstimepiece
version0.7.6
sourcesrc
created_at2023-03-31 19:22:33.899943
updated_at2023-12-20 01:38:51.549565
descriptionA command-line all-purpose timepiece
homepage
repositoryhttps://github.com/kyllingene/timepiece
max_upload_size
id826714
size128,856
(Kyllingene)

documentation

README

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!

Commit count: 63

cargo fmt