Skip to content

vvmk/timer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 

Repository files navigation

timer – a Pomodoro/Interval Timer

timer is a command line interval timer written in Bash.

Features

  • 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

tmux-Aware Interface

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.

Installation

macOS

via Homebrew

$ brew install rlue/utils/timer

Linux

Dependencies

  • 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

Usage

Synopsis

$ 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.

Examples

Simple timer (30m)

$ timer 30

Meditation timer

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

Pomodoro technique

From Wikipedia:

  1. Decide on the task to be done.
  2. Set the pomodoro timer (traditionally to 25 minutes).
  3. Work on the task until the timer rings.
  4. After the timer rings, put a checkmark on a piece of paper.
  5. If you have fewer than four checkmarks, take a short break (3–5 minutes), then go to step 2.
  6. 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

License

© 2017 Ryan Lue. This project is licensed under the terms of the MIT license.

About

A pomodoro/interval timer for the command line

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Shell 100.0%