pomiterm 0.1.0

A small minimal Pomodoro timer running in your terminal.

PomiTerm 🍅

A terminal-based Pomodoro timer built with Python and Rich.

Features

• Pomodoro timer with work sessions, short breaks, and long breaks
• Live countdown display in the terminal
• Distinct sounds for each timer type (macOS)
• Configurable settings (durations, cycles)

Requirements

• Python 3.x
• macOS (sound playback uses afplay)

pip install rich questionary

Usage

python main.py

Or as a global terminal command:

chmod +x main.py
ln -s $(pwd)/main.py /usr/local/bin/pomiterm
pomiterm

Default Settings

Setting	Value
Work	25 min
Short break	5 min
Long break	15 min
Cycles	4

Settings can be changed from the main menu under Settings.