#stopwatch #alarm #time #command-line #clock

app timepiece

A command-line all-purpose timepiece

9 unstable releases (3 breaking)

0.5.3 May 16, 2023
0.5.2 May 9, 2023
0.5.0 Apr 27, 2023
0.4.0 Apr 20, 2023
0.2.0 Mar 31, 2023

#157 in Date and time

29 downloads per month

MIT license

18KB
456 lines

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 or Space
    • 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 10 seconds with Right or A
    • Remove 10 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

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!

Dependencies

~2–11MB
~98K SLoC