Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Super Simple Command-line Countdown Timer

Project Description

Super Simple Command-line Countdown Timer


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.


  • say command or its alternatives (for spoken countdown)
  • Python: 2.6 / 2.7 / 3.2 / 3.3 / 3.4 / 3.5
  • six
  • mog-commons


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

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


  • 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


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)

Release History

This version
History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(5.3 kB) Copy SHA256 Hash SHA256
Source None Sep 10, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate