Skip to main content

Terminal program to display countdown timer

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

countdown_cli-2.2.1.tar.gz (8.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

countdown_cli-2.2.1-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file countdown_cli-2.2.1.tar.gz.

File metadata

  • Download URL: countdown_cli-2.2.1.tar.gz
  • Upload date:
  • Size: 8.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for countdown_cli-2.2.1.tar.gz
Algorithm Hash digest
SHA256 06d8b237fd6891bafea2b4d7858218de1d4764623291b9cbc3ea6cc7fe616977
MD5 6e6079d8533089362e9e93ada91723d2
BLAKE2b-256 f8c7b7f78ff97aa9429bd7322cf1daf24d0fec3ff22bfab037ed4d48b5b5a4e9

See more details on using hashes here.

File details

Details for the file countdown_cli-2.2.1-py3-none-any.whl.

File metadata

  • Download URL: countdown_cli-2.2.1-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for countdown_cli-2.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3dd41045a4cbee37c5998651499fd917200280e0370d453e1807e865485e127a
MD5 7ea83930e8259432922d3bdb442c7338
BLAKE2b-256 faa7b2cb3ca759293e81879d668eae55a91470bbb78064f91725623a4f594b91

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page