Terminal-based Pomodoro timer with TUI and sound notifications
Project description
pomo-tui
A terminal-based Pomodoro timer with a real-time ASCII digital clock.
Designed for developers who want to stay focused without leaving the terminal.
✨ Features
- Real-time ASCII digital clock display
- Pomodoro workflow (WORK / BREAK cycles)
- Color-coded phases
- 🔴 WORK (Red)
- 🔵 BREAK (Blue)
- Keyboard control
p: pause / resume
- Sound notification on phase change
- Fully terminal-based (no GUI)
🚀 Installation
pip install pomo-tui
🎯 Usage
pomo
pomo --work 25 --break 5 --cycles 4
| Option | Description | Default |
|---|---|---|
--work |
Work duration (minutes) | 25 |
--break |
Break duration (minutes) | 5 |
--cycles |
Number of cycles | 4 |
| Key | Action |
|---|---|
p |
Pause / Resume |
Ctrl + C |
Quit |
🛠️ Development Setup
git clone https://github.com/newbie1223/pomodoro-cli.git cd pomodoro-cli
python3 -m venv .venv source .venv/bin/activate pip install -e .
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
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 pomo_tui-0.1.1.tar.gz.
File metadata
- Download URL: pomo_tui-0.1.1.tar.gz
- Upload date:
- Size: 4.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
32a43e84b57c999c0fecc848c8bc6747081686ccdd803313da2bdd01efebb0ae
|
|
| MD5 |
deb88626eccbf05bffe473fd236b5c76
|
|
| BLAKE2b-256 |
46024e4823330c886adfd1405e26ffaa0b362494f27569d3efb2b84d7e3462e0
|
File details
Details for the file pomo_tui-0.1.1-py3-none-any.whl.
File metadata
- Download URL: pomo_tui-0.1.1-py3-none-any.whl
- Upload date:
- Size: 5.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
68fa0b7aa1745b921fcefcd0c0e9c5d98c3cd0bd968b147ed167db65a583030c
|
|
| MD5 |
4a2782369f2794b7feddfc97a14a031b
|
|
| BLAKE2b-256 |
eb64f1252b3e002bafd0726a00d73cde953999a78c06c9c2d1c004b36fce796c
|