t-pomo 0.3.0

A simple Pomodoro timer with ASCII art display that runs on terminal.

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.