Super Simple Command-line Countdown Timer
Project description
Super Simple Command-line Countdown Timer
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
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.