README
¶
pomo — Terminal Pomodoro Timer
A simple, customizable Pomodoro timer for your terminal, built with Bubble Tea.
Features
- 🍅 Work and break timer sessions
- 🔗 Task chaining with user confirmation prompts
- 📊 Real-time progress bar visualization
- ⌨️ Keyboard shortcuts to adjust time mid-session
- ⏸️ Pause and resume timer functionality
- 🔔 Cross-platform desktop notifications
- 🎨 Clean, minimal terminal UI
- 🛠️ Custom commands when timers complete
Desktop Notifications
pomo sends native desktop notifications when sessions complete
🔔 View notification examples
Linux (GNOME)
Windows
Note: Actual notification appearance varies by operating system and desktop environment
Usage
Work sessions:
pomo # Default work session (25m)
pomo 30m # Custom duration
Break sessions:
pomo break # Default break (5m)
pomo break 10m # Custom duration
Installation
Install with Go
go install github.com/Bahaaio/pomo@latest
Or, build from source
git clone https://github.com/Bahaaio/pomo
cd pomo
go build .
Alternatively, download pre-built binaries from the releases page.
Configuration
📁 Config file search order
pomo looks for its config file in the following order:
- Current directory:
pomo.yaml(highest priority) - System config directory:
- Linux:
~/.config/pomo/pomo.yaml - macOS:
~/Library/Application Support/pomo/pomo.yaml - Windows:
%APPDATA%\pomo\pomo.yaml
- Linux:
- Built-in defaults if no config file is found
Example pomo.yaml:
askToContinue: true # Ask to start next task after completion
work:
duration: 25m
title: work session
# cross-platform notifications
notification:
enabled: true
title: work finished 🎉
message: time to take a break
icon: ~/my/icon.png
break:
duration: 5m
# will run after the session ends
then:
- [spd-say, "Back to work!"]
Check out pomo.yml for a full example with all options.
Key Bindings
Timer Controls
| Key | Action |
|---|---|
↑ / k |
Increase time by 1 minute |
Space |
Pause/Resume timer |
← / h |
Reset to initial duration |
q / Ctrl+C |
Quit |
Confirmation Dialog
| Key | Action |
|---|---|
y / Y |
Confirm (Yes) |
n / N |
Cancel (No) |
Tab |
Toggle selection |
Enter |
Submit choice |
q / Ctrl+C |
Quit |
License
This project is licensed under the MIT License. See the LICENSE file for details.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package cmd provides the command-line interface for the pomo timer.
|
Package cmd provides the command-line interface for the pomo timer. |
|
Package config loads, stores, and provides default values for work and break tasks.
|
Package config loads, stores, and provides default values for work and break tasks. |
|
Package ui provides the terminal user interface for pomodoro sessions.
|
Package ui provides the terminal user interface for pomodoro sessions. |
|
confirm
Package confirm provides a simple confirmation dialog component
|
Package confirm provides a simple confirmation dialog component |
Click to show internal directories.
Click to hide internal directories.