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!
- 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, orEnter - Add / remove time with
+or-
To start a timer:
countdown 6m30s
- Python 3.10+
You can install countdown-cli via uv from PyPI:
uv tool install countdown-cliContributions are very welcome. To learn more, see the Contributor Guide.
Distributed under the terms of the MIT license, countdown-cli is free and open source software.
If you encounter any problems, please file an issue along with a detailed description.