Skip to main content

Super Simple Command-line Countdown Timer

Project description

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)

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

easy-timer-0.0.4.tar.gz (5.3 kB view details)

Uploaded Source

File details

Details for the file easy-timer-0.0.4.tar.gz.

File metadata

  • Download URL: easy-timer-0.0.4.tar.gz
  • Upload date:
  • Size: 5.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for easy-timer-0.0.4.tar.gz
Algorithm Hash digest
SHA256 85513f7a61319a310882ea54778af0305520058783a222e74e7fbc858b647738
MD5 f485a18905c43f8d36bd5283048a4a28
BLAKE2b-256 597c25d382e627c9579ee476d0180d58cdb42b9722687afe65693bcc9e6156b2

See more details on using hashes here.

Supported by

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