Metadata-Version: 2.3
Name: t-pomo
Version: 0.3.0
Summary: A simple Pomodoro timer with ASCII art display that runs on terminal.
License: MIT
Author: uuboyscy
Author-email: uuboyscy@uuboyscy.dev
Requires-Python: >=3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: art (>=6.4,<7.0)
Project-URL: Homepage, https://github.com/uuboyscy/t-pomo
Project-URL: Issues, https://github.com/uuboyscy/t-pomo/issues
Description-Content-Type: text/markdown

# t-pomo
t-pomo is a lightweight Pomodoro timer designed for the terminal. The "t" stands for terminal, and "pomo" is short for Pomodoro, a time management technique that boosts productivity by alternating focused work sessions with short breaks.

## 🛠 Installation
Ensure you have Python installed (>=3.9), then install the package using pip:
```
pip install t-pomo
```

## 📌 Usage
Run the Pomodoro timer with:
```
t-pomo
```

You'll be prompted to enter:
1. Work duration (default: 25 minutes)
2. Break duration (default: 5 minutes)
3. Number of Pomodoro loops (default: 1)

Example:

```
Enter working time in minutes [25]: 30
Enter break time in minutes [5]: 10
Enter countdown loop time [1]: 4
```
This starts a 30-minute work session followed by a 10-minute break, repeating 4 times.

## 🖼 Preview
The timer features an ASCII-style countdown that visually represents the progress using 🍅 tomato icons. Each icon corresponds to a percentage of the session completed, making it easy to track how much time has passed at a glance.
![timer_display_sample_work](https://github.com/uuboyscy/t-pomo/raw/main/timer_display_sample_work.png)
![timer_display_sample_break](https://github.com/uuboyscy/t-pomo/raw/main/timer_display_sample_break.png)

