Skip to main content

PyPI Status Python Version License

Tests Codecov

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. 😉

an adorable snake taking a bite out of a cookie with the words Python Morsels next to it (Python Morsels logo)

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

32:53 shown in large letters in center of an xterm window (black background with white text)

14:57 shown in large letters in center of terminal window (light background with darker text)

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)

Source distribution for countdown-cli 2.2.1
File Size Uploaded
countdown_cli-2.2.1.tar.gz 8.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for countdown-cli 2.2.1
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

2.2.1 This release

2 release files

2.1.0

2 release files

2.0.0

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.3.0

2 release files

0.2.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page