https://github.com/earthboundkid/pomodoro

Command line pomodoro timer
https://github.com/earthboundkid/pomodoro

go pomodoro termbox timer

Last synced: 18 days ago
JSON representation

Command line pomodoro timer

• Host: GitHub
• URL: https://github.com/earthboundkid/pomodoro
• Owner: earthboundkid
• License: mit
• Created: 2016-01-06T20:30:31.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2023-02-10T15:18:50.000Z (almost 2 years ago)
• Last Synced: 2024-10-16T13:39:42.721Z (29 days ago)
• Topics: go, pomodoro, termbox, timer
• Language: Go
• Homepage:
• Size: 86.9 KB
• Stars: 173
• Watchers: 5
• Forks: 22
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# pomodoro

Command line [pomodoro timer](https://en.wikipedia.org/wiki/Pomodoro_Technique), implemented in Go.

## Installation

First install [Go](http://golang.org).

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

```bash

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

```bash

$ 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

```

![screenshot](./screenshot.png)

## Recommended helper

[Noti](https://github.com/variadico/noti) can be used to bring up a system alert when pomodoro finishes.