countdown-cli 2.1.0

Terminal program to display countdown timer

This project is based on a Python Morsels exercise for a command-line countdown timer. If you’re working on that exercise right now, please don’t look at the source code for this. 😉

Wondering how this package works? Don’t look at the source code just yet! Instead, try implementing this package with the Python Morsels “countdown” exercise!

Features

• Full-screen countdown timer, centered in the terminal window

• Responsive timer size based on terminal window width/height

• Command-line interface for Linux/Mac/Windows

• Pause/resume with p, k, Space, or Enter

• Add / remove time with + or -

To start a timer:

countdown 6m30s

Requirements

• Python 3.10+

Installation

You can install countdown-cli via uv from PyPI:

uv tool install countdown-cli

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the MIT license, countdown-cli is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.