Super Simple Command-line Countdown Timer

pip install easy-timer==0.0.4


Easy Timer

Super Simple Command-line Countdown Timer

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


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)