A small minimal Pomodoro timer running in your terminal.
Project description
PomiTerm 🍅
A minimal, beautiful Pomodoro timer that lives in your terminal.
Built with Rich for a clean UI — live countdown, a live clock, and a random quote to keep you going.
Install
pipx install pomiterm
Usage
pomiterm
Features
- Live countdown with progress bar for work sessions, short breaks, and long breaks
- A cowsay cat displayed during each session
- Ticking clock on the main screen
- Random motivational, wisdom, and silly quotes
- Sound notifications at the end of each session (cross-platform)
- Configurable durations and cycles from the menu
Default Settings
| Setting | Value |
|---|---|
| Work | 25 min |
| Short break | 5 min |
| Long break | 15 min |
| Cycles | 4 |
Requirements
- Python 3.10+
Sound
| Platform | Notification |
|---|---|
| macOS | System sounds via afplay (Glass, Ping, Hero) |
| Windows | System sounds via winsound |
| Linux | Terminal bell |
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pomiterm-0.2.1.tar.gz
(4.9 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pomiterm-0.2.1.tar.gz.
File metadata
- Download URL: pomiterm-0.2.1.tar.gz
- Upload date:
- Size: 4.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
414341842360381175b93ecc696228c152e9594763c5dd97d15fc517a63c40d3
|
|
| MD5 |
9a4cf86cbb8944a662ad1009caa8bf57
|
|
| BLAKE2b-256 |
fb48cd7ede7b41930381904777fa3aaf4b74bd3c7a6ad0fd3e05b87b2f979297
|
File details
Details for the file pomiterm-0.2.1-py3-none-any.whl.
File metadata
- Download URL: pomiterm-0.2.1-py3-none-any.whl
- Upload date:
- Size: 6.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
48033d8e30a40b7f9b456e5c47b2ce5b08fc03e1c8ac7d1ed36127cc4c46543e
|
|
| MD5 |
6117a0394628c9f8f96b7d1044e38d46
|
|
| BLAKE2b-256 |
e2306848ec24754e37df0ccdc56eb48e3dd168fea953d5a160b511d2665726a0
|
