urtimer

A simple countdown timer and stopwatch using urwid.

It looks like:

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

You can also watch a demonstration clip.

Contents

• Features
• Installation
• Controls
  • Keys
  • Mouse
• Dependencies
• Issues and Contributions
• Copyright
• Resources

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

• PyPI
• Website