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.
Release files for countdown-cli 2.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| countdown_cli-2.2.1.tar.gz | 8.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| countdown_cli-2.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 18.0 kB
Release files / countdown_cli-2.2.1.tar.gz
| Download URL | countdown_cli-2.2.1.tar.gz |
|---|---|
| Size | 8.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
06d8b237fd6891bafea2b4d7858218de1d4764623291b9cbc3ea6cc7fe616977
|
|
BLAKE2b-256 checksum How to use checksums |
f8c7b7f78ff97aa9429bd7322cf1daf24d0fec3ff22bfab037ed4d48b5b5a4e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Release files / countdown_cli-2.2.1-py3-none-any.whl
| Download URL | countdown_cli-2.2.1-py3-none-any.whl |
|---|---|
| Size | 10.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3dd41045a4cbee37c5998651499fd917200280e0370d453e1807e865485e127a
|
|
BLAKE2b-256 checksum How to use checksums |
faa7b2cb3ca759293e81879d668eae55a91470bbb78064f91725623a4f594b91
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|