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.0.tar.gz (171.3 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.0-py3-none-any.whl (10.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: countdown_cli-2.2.0.tar.gz
  • Upload date:
  • Size: 171.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for countdown_cli-2.2.0.tar.gz
Algorithm Hash digest
SHA256 3494c94e427c1c4b39c99bcddcb4146ddbb4eca3fb741b424dd282b7262f9c4c
MD5 84234f59bf1cc99dde10e94da805ad34
BLAKE2b-256 134fa6097247af14fa7b4cb70607961f3f3cd557a59674e96a1399acdf16b8fd

See more details on using hashes here.

File details

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

File metadata

  • Download URL: countdown_cli-2.2.0-py3-none-any.whl
  • Upload date:
  • Size: 10.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.10 {"installer":{"name":"uv","version":"0.10.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"22.04","id":"jammy","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for countdown_cli-2.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 adfec8cb20b4a0aa744b268df7284de8d58085b9507bf31a8b96b6b45a74a948
MD5 ab298f027fb231816f7d33f2eef81a0a
BLAKE2b-256 46ddb5b2dbb06e98eaea0f85c5b079340985d8d0a8744e16725f0e73320e66c7

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