Skip to content
Countdown timer and stopwatch in your terminal
Python
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
AUTHORS added the a function to count laps Jun 26, 2016
CHANGELOG.md release 1.16.0 :shipit: Jul 25, 2019
LICENSE add LICENSE May 30, 2014
README.md update README for new hotkey Jul 25, 2019
setup.cfg 1.0 :shipit: Jun 2, 2014
setup.py release 1.16.0 :shipit: Jul 25, 2019
termdown.gif add README May 30, 2014
termdown.py release 1.16.0 :shipit: Jul 25, 2019

README.md

termdown demo

Usage: termdown [OPTIONS] [TIME]

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

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

  Hotkeys:
      L       Lap (stopwatch mode only)
      R       Reset
      SPACE   Pause (will delay absolute TIME)
      +       Plus (will add 10 seconds)
      Q       Quit

Options:
  -a, --alt-format         Use colon-separated time format
  -b, --blink              Flash terminal at end of countdown
  -B, --no-bell            Don't ring terminal bell at end of countdown
  -c, --critical N         Draw final N seconds in red and announce them
                           individually with --voice or --exec-cmd (defaults
                           to 3)
  -f, --font FONT          Choose from http://www.figlet.org/examples.html
  -p, --voice-prefix TEXT  Add TEXT to the beginning of --voice and --exec
                           annunciations (except per-second ones)
  -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 (except for last minute of
                           countdown and first minute of stopwatch)
  -t, --text TEXT          Text to display at end of countdown
  -T, --title TEXT         Text to display on top of countdown/stopwatch
  -W, --no-window-title    Don't update terminal title with remaining/elapsed
                           time
  -v, --voice VOICE        Spoken countdown (at fixed intervals with per-
                           second annunciations starting at --critical;
                           requires `espeak` on Linux or `say` on macOS;
                           choose VOICE from `say -v '?'` or `espeak
                           --voices`)
  -o, --outfile PATH       File to write current remaining/elapsed time to
  --exec-cmd CMD           Runs CMD every second. '{0}' and '{1}' in CMD will
                           be replaced with the remaining/elapsed number of
                           seconds and a more sparse annunciation as in
                           --voice, respectively. For example, to get a
                           callout at five seconds only, use: --exec-cmd "if [
                           '{0}' == '5' ]; then say -v Alex {1}; fi"
  --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
  -z, --time               Show current time instead of countdown/stopwatch
  -Z, --time-format TEXT   Format for --time (defaults to "%H:%M:%S", ignores
                           --no-seconds)
  --help                   Show this message and exit
pip install termdown

PyPI version   Python 2.7   Python 3.x   PyPI license

You can’t perform that action at this time.