decafe-timer 0.7.0

CLI coffee cooldown timer with a shrinking ASCII bar.

decafe-timer

A lightweight CLI cooldown timer for coffee breaks and caffeine tracking. It was created for people who worry about taking too much caffeine and becoming dependent on it.

Installation

pipx install decafe-timer

Usage

Basics

decafe-timer 45m          # start a new timer, print one snapshot
decafe-timer 3h/5h        # start with 3h remaining out of a 5h total
decafe-timer              # resume the latest timer, one snapshot
decafe-timer run 45m      # start a new timer and watch it count down
decafe-timer run          # resume the live UI for an active timer
decafe-timer clear        # clear the current timer (shows ---)

Options

decafe-timer --one-line        # use the single-line ASCII layout
decafe-timer --graph-only      # snapshot with the ASCII bar only
decafe-timer --bar-style blocks        # use the classic block bar
decafe-timer --bar-style counting-rod  # use the counting rod bar
decafe-timer --color=always    # force ANSI colors on
decafe-timer --color=never     # force ANSI colors off
decafe-timer --run 45m         # alias for `run` (start live countdown)
decafe-timer --run             # alias for `run` (resume live countdown)
decafe-timer --clear           # alias for `clear` (shows ---)
decafe-timer 0                 # clear using a zero duration
decafe-timer --version         # show the current version

License

decafe-timer is distributed under the terms of the MIT license.