/termdown

Countdown timer and stopwatch in your terminal

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

termdown demo

Usage: termdown [OPTIONS] [TIMESPEC]

  Starts a countdown to or from TIMESPEC. Example values for TIMESPEC:
  10, '1h 5m 30s', '12:00', '2020-01-01', '2020-01-01 14:00 UTC'.

  If TIMESPEC is not given, termdown will operate in stopwatch mode
  and count forward.

  Hotkeys:
      R       Reset
      SPACE   Pause (will delay absolute TIMESPEC)
      Q       Quit

Options:
  -a, --alt-format    Use colon-separated time format
  -b, --blink         Flash terminal at end of countdown
  -c, --critical N    Draw final N seconds in red (defaults to 3)
  -f, --font FONT     Choose from http://www.figlet.org/examples.html
  -q, --quit-after N  Quit N seconds after countdown (use with -b or -t) or
                      terminate stopwatch after N seconds
  -s, --no-seconds    Don't show seconds until last minute
  -t, --text TEXT     Text to display at end of countdown
  -T, --title TEXT    Text to display on top of countdown/stopwatch
  -v, --voice VOICE   Mac OS X only: spoken countdown (starting at 10), choose
                      VOICE from `say -v '?'`
  --no-figlet         Don't use ASCII art for display
  --no-text-magic     Don't try to replace non-ASCII characters (use with -t)
  --version           Show version and exit
  --help              Show this message and exit
pip install termdown

PyPI downloads   PyPI version   Python 2.7   Python 3.x   PyPI license