pomodoro

A simple terminal-based pomodoro timer

The point of pomodoro timers is to help you focus and save time. Unfortunately, I found myself wasting time with other tools. To fix that, I spent a few minutes making a simple timer for use in the terminal.

Usage

Here are some common ways to use the timer:

Start a 25 minute timer:

pomodoro

Start a short (5 minute) break:

pomodoro -s

Start a short (20 minute) break:

pomodoro -l

Start a 3 minute timer for tea:

pomodoro -c 3m

Start a 1 hour, 2 minute, 3 second timer:

pomodoro -c 1h2m3s

If you want to see more details, here's all options at the time of writing:

• -c time, --custom time: start a custom timer (time in minutes)
• -h, --help: show the help text
• -l, --long: starts the timer for 20 minutes
• -s, --short: starts the timer for 5 minutes

Remember: you can always run pomodoro --help to get the latest list of options available.

Install

You can install using Homebrew or manually build from source:

Install with Homebrew

Running this in your terminal adds my tap and installs the package:

brew tap blakek/blakek && brew install blakek/blakek/pomodoro

Build from Source

First, either clone this repo or download a zip file.

Then, in a terminal open to this project's directory, build with Go:

$ go build

Updating

If you installed using Homebrew, you can use the normal brew upgrade process.

The easiest way to update from a source build is to pull the latest changes (e.g. git pull) and re-run the install directions. If you keep the repository, you can occasionally run git pull && go build to build using the latest changes.

License

MIT