Pomogoro

Pomogoro is a command-line tool to combine todo.txt (or any other text based todo file) and the Pomodoro Technique.

Features

• made to work with todo.txt files but is compatible with any line-based text files
• time tracking history per task per day
• OS notifications (pomodoro finished, break started, break finished)
• option to enable/disable pomodoro style tracking
• configurable pomodoro and break durations
• auto break after one pomodoro is finished

Installation

Option 1: get a binary

Go to Releases and grep the appropriate release for your architecture.

# extract
tar -xvzf <release.tar.gz>
# move the binary to a directory in your $PATH
mv pomogoro ~/.local/bin

Option 2: go get

• golang
• PATH contains path to go/bin/ directory

go get -u github.com/phux/pomogoro

After this you can start pomogoro via

pomogoro --config <absolute/path/to/config.toml>

Configuration

You need to pass an absolute path to a config.toml file via --config /your/path/to/config.toml.

# config.toml
TodoFile = "/absolute/path/to/your/todo.txt" # containing the tasks you want to track
LogFile = "/absolute/path/to/pomogoro.log" # tracking log file
BreakDuration = 5 # in minutes
PomodoroEnabled = true # whether to use pomodoro timer or not
PomodoroDuration = 25 # in minutes
LogIdleTime = true # also log idle times
LogBreakTime = true # also log breaks

Keybindings

Todos

• Jira: Fetch tasks & push time trackings (WIP)
• reduce 1s lag after key press
• cleanup codebase & more tests
• group by todo.txt projects

Built With

• gocui - Terminal UI

License

This project is licensed under the MIT License - see the LICENSE.md file for details