/urtimer

A simple countdown timer using urwid

Primary LanguagePythonMIT LicenseMIT

urtimer

A simple countdown timer and stopwatch using urwid.

It looks like:

+---------------------------------------------------------+
|                                                         |
|                                                         |
|     ▄▀▀▀▄ ▄▀▀▀▄   ▄▀▀▀▄ █▀▀▀▀   ▄▀▀▀▄ ▄▀▀▀▄   ▄▀▀▀▄     |
|     █   █ █   █ ▀ █   █ █     ▀ █   █ █   █   █   █     |
|     █   █ █   █ ▄ █   █ ▀▀▀▀▄ ▄ █   █ █   █   █   █     |
|     █   █ █   █   █   █     █   █   █ █   █   █   █     |
|      ▀▀▀   ▀▀▀     ▀▀▀  ▀▀▀▀     ▀▀▀   ▀▀▀  ▀  ▀▀▀      |
|                                                         |
|                                                         |
+---------------------------------------------------------+

You can also watch a demonstration clip.

Contents

Features

  • Modes
    • Countdown timer
    • Stopwatch (-S or --stopwatch)
  • Support sleep-like suffixes like "d", "h", "m", and "s".
  • Support countdown date (-d or --date) like "noon" or "tomorrow 1 am"
  • Window title updating

Installation

You can install urtimer via pip:

pip install urtimer

Controls

Keys

Z/A:decrease/increase hour
X/S:decrease/increase minute
C/D:decrease/increase second
Space:start/pause timer
Q:quit the program

Mouse

Left-button:start/pause timer

Dependencies

urwid
the UI library
parsedatetime

only required for -d or --date option.

pip install parsedatetime

Issues and Contributions

Feel free to open an issue in issue tracker for bugs, feature requests, or pull requests.

Copyright

urtimer is licensed under the MIT License, see COPYING.

Resources