pomodoro

Command line pomodoro timer, implemented in Go.

Installation

First install Go.

If you just want to install the binary to your current directory and don't care about the source code, run

GOBIN="$(pwd)" go install github.com/carlmjohnson/pomodoro@latest

Usage

Usage of pomodoro:

pomodoro [options] [finish time]

Duration defaults to 25 minutes. Finish may be a duration (e.g. "1h2m3s") or a target time (e.g. "1:00pm" or "13:02:03"). Durations may be expressed as integer minutes (e.g. "15") or time with units (e.g. "1m30s" or "90s").

Chimes system bell at the end of the timer, unless -silence is set.

Screenshots

$ pomodoro -simple
Start timer for 25m0s.

Countdown: 24:43

$ pomodoro -h
Usage of pomodoro:

    pomodoro [options] [duration]

Duration defaults to 25 minutes. Durations may be expressed as integer minutes
(e.g. "15") or time with units (e.g. "1m30s" or "90s").

Chimes system bell at the end of the timer, unless -silence is set.
  -silence
        Don't ring bell after countdown
  -simple
        Display simple countdown

Recommended helper

Noti can be used to bring up a system alert when pomodoro finishes.