timer is a command line interval timer written in Bash.
- Calming, serene alert tone inspired by Buddhist meditation bells
- Set a simple countdown, or specify a set of intervals to time
- Repeat interval sets n times, or indefinitely
In a regular terminal session, remaining time is displayed in the window title.
In a tmux session, remaining time is displayed in the status bar beside the session name.
via Homebrew
$ brew install rlue/utils/timer
- bc
- sox
- libsox-fmt-mp3
Download timer to a directory on your $PATH (e.g., ~/bin, ~/.local/bin, /usr/local/bin) and make it executable:
$ curl -o ~/bin/timer https://raw.githubusercontent.com/rlue/timer/master/bin/timer
$ chmod +x ~/bin/timer$ timer [options] [minutes ...]
-r rounds Repeat timer (n < 0 repeats forever)
-d seconds Delay timer start
-q Suppress command line output
-h Display this message
-v Display version information
Timer duration may be specified in fraction or decimal form; e.g., 90 seconds may be specified as 1.5 or 3/2.
If multiple durations are specified, an alert will be triggered at the end of each interval.
$ timer 30
From Quora:
Let’s say you meditate for 30 minutes. You can set the interval bell to ring after 5 minutes, so you can spend the first 5 minutes settling/relaxing yourself and your mind, and then begin the actual meditation practice when the interval bell rings.
$ timer 5 25
From Wikipedia:
- Decide on the task to be done.
- Set the pomodoro timer (traditionally to 25 minutes).
- Work on the task until the timer rings.
- After the timer rings, put a checkmark on a piece of paper.
- If you have fewer than four checkmarks, take a short break (3–5 minutes), then go to step 2.
- After four pomodoros, take a longer break (15–30 minutes), reset your checkmark count to zero, then go to step 1.
$ timer 25 5 25 5 25 5 25 20
Or to repeat this 135-minute set twice in a row,
$ timer -r2 25 5 25 5 25 5 25 20
© 2017 Ryan Lue. This project is licensed under the terms of the MIT license.

