🍅 tpom - Pomodoro Timer CLI
A simple and elegant Pomodoro timer for the command line, built with Python.
Features
- ⏰ Clean countdown display
- 🔔 Gentle alarm sound notification
- 🚫 Easy cancellation with Ctrl+C
- 🎵 Custom sound file support
- 📦 Easy installation via pip
- 🔇 Silent operation if sound unavailable (no grating fallbacks)
Installation
From PyPI (when published)
pip install tpom
From source
git clone https://github.com/yourusername/tpom.git
cd tpom
pip install -e .
Usage
Basic usage
tpom
# You'll be prompted to enter the duration in minutes
Specify duration directly
tpom --minutes 25
Use custom sound file
tpom --minutes 25 --sound-file /path/to/your/sound.mp3
Get help
tpom --help
Development
Setup development environment
git clone https://github.com/yourusername/tpom.git
cd tpom
pip install -e ".[dev]"
Run tests
pytest
Format code
black src/
Lint code
flake8 src/
mypy src/
License
MIT License - see LICENSE file for details.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1 maintainer
Metadata
1 maintainer
Release files for tpom 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tpom-1.0.0.tar.gz | 412.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tpom-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 824.0 kB
Release files / tpom-1.0.0.tar.gz
| Download URL | tpom-1.0.0.tar.gz |
|---|---|
| Size | 412.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bf654893d2131d003d6e5bbe8e121e81d5b24178188f9ca085b2b1fea0596402
|
|
BLAKE2b-256 checksum How to use checksums |
b5bac3302afa24c112f8ea5959136fd07d6cf21c1dc5b4beaccb2e48122e059e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.1
|
Release files / tpom-1.0.0-py3-none-any.whl
| Download URL | tpom-1.0.0-py3-none-any.whl |
|---|---|
| Size | 412.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e7e9bee827dcce727d5bd475d1bf595bf4a7610265f7532b918a274e4e97f99a
|
|
BLAKE2b-256 checksum How to use checksums |
bba86ac195fabcf42e45ea825c2447d90fbced1bd45dcba811719590a722a1cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.1
|
