Skip to main content

Super Simple Command-line Countdown Timer

PyPI version Build Status Coverage Status License 'Stories in Ready'

Features

Are you sick of fancy timer applications?

Easy Timer provides you a minimalist countdown timer inside your command-line terminal.

When you turn on the spoken countdown, the remaining time is periodically notified by voice. This is useful for studying or working in time without watching a computer screen.

Dependencies

  • say command or its alternatives (for spoken countdown)

  • Python: 2.6 / 2.7 / 3.2 / 3.3 / 3.4 / 3.5

  • six

  • mog-commons

Quickstart

You can now try Easy Timer by typing two command lines.

pip install easy-timer
easy-timer -s 0:10

Installation

  • pip command may need sudo

Operation

Command

Install

pip install easy-timer

Upgrade

pip install --upgrade easy-timer

Uninstall

pip uninstall easy-timer

Check installed version

easy-timer --version

Help

easy-timer -h

Examples

Set a 10-minute timer.

easy-timer 10

Set an 80-minute (= 1 hour 20 minutes) timer.

easy-timer 80

Set a 90-second (= 1 minute 30 seconds) timer.

easy-timer 1:30

Enable the spoken countdown.

easy-timer -s 10
easy-timer --say 10

Specify say options.

easy-timer -s --say-cmd='say -v Karen' 1
easy-timer -s --say-cmd='say -v "Pipe Organ"' 0:10

Set the language to Japanese.

easy-timer -s --say-cmd='say -v Kyoko' --lang=ja 1
LANG=ja_JP.UTF-8 easy-timer -s --say-cmd='say -v Kyoko' 1

Run a timer with caffeinate command to prevent the system from sleeping.

caffeinate -d easy-timer -s 80

When does the timer speak?

By default, the timer speaks on the following timings.

  • Every 10 minutes

  • Last 5 minites and 1 minite

  • Each of final 10 seconds (countdown)

Metadata

Release files for easy-timer 0.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for easy-timer 0.0.4
File Size Uploaded Provenance
easy-timer-0.0.4.tar.gz 5.3 kB Without provenance Details

Release files / easy-timer-0.0.4.tar.gz

Download URL easy-timer-0.0.4.tar.gz
Size 5.3 kB
Tags Source
SHA-256 checksum
How to use checksums
85513f7a61319a310882ea54778af0305520058783a222e74e7fbc858b647738
BLAKE2b-256 checksum
How to use checksums
597c25d382e627c9579ee476d0180d58cdb42b9722687afe65693bcc9e6156b2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for easy-timer 0.0.4

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

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