#clock #tui #command-line #interface #utilities #stopwatch #timer

bin+lib clock-cli

Clock utilities (stopwatch, timer) on the command line with TUI (text user interface)

8 releases

0.1.1 Oct 10, 2020
0.1.0 Oct 10, 2020
0.0.7 Oct 8, 2020
0.0.4 Sep 29, 2020

#20 in #stopwatch

GPL-3.0 license

365KB
471 lines

clock-cli-rs

Command line clock utilities, with TUI interfaces, implemented in Rust. Currently, these features are implemented:

  • Stopwatch
    • start/pause/stop: ✅
    • lap time (similar to iOS's stopwatch's behaviour): ✅
    • report of all pause/start/lap instances (moments): WIP
  • (Countdown) Timer
    • basics: ✅

Installation

If you are a Rustacean 🦀️, just cargo install clock-cli.

Other installation methods: WIP

Usage

Stopwatch:

simply run:

clock
  • Press Space to pause/resume.
  • Press l to lap. Mouse-scroll or press arrow keys to view more.
  • Press return to finish.

Countdown Timer:

Specify the duration (in natual language) to run a countdown.

Examples:

clock 3 minutes
clock 4h3m
clock 1 day
  • Press Space to pause/resume.
  • Press return to cancel.

Compatibility

Currently only works on Linux and MacOS.

Acknowledgement

The TUI is based on the cursive crate made by Alexandre Bury (@glycos), who also helped me a lot during the development of this crate (see glycose/cursive/#503)

Dependencies

~7–32MB
~473K SLoC