Metadata-Version: 2.4
Name: pomodoro-raccoon
Version: 0.2.0
Summary: Ein simpler Pomodoro-Timer mit ASCII-Waschbär-Animation
Home-page: https://github.com/event173/pomodoro-racoon
Author: Nick Witmar
Author-email: nickwitmar@gmail.com
Project-URL: Bug Reports, https://github.com/event173/pomodoro-racoon/issues
Project-URL: Source, https://github.com/event173/pomodoro-racoon
Keywords: pomodoro timer productivity ascii animation raccoon
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Office/Business :: Scheduling
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# 🦝 Pomodoro Raccoon 🍅

A cute CLI Pomodoro timer with ASCII raccoon animations to keep you productive!

## Features

- 🍅 **Pomodoro sessions** with short (5 min) and long (25 min) breaks
- 🔄 **Session tracking** — counts your Pomodoros and automatically offers a long break after every 4 sessions
- 🦝 **ASCII raccoon animations** that switch every 5 seconds
- 🎨 **Coloured progress bar** with phase-based colours
- ⏱ **Live countdown** displayed alongside the animation
- ⌨️ **Press Enter** to end a session early or skip a break — no Ctrl+C needed
- 🔔 **Desktop notifications** when a session or break ends (Linux & macOS)
- 🔊 **Sound alerts** on session start and end (Linux & Windows)
- ⚙️ **Configurable durations** via CLI arguments

## Installation

```bash
pip install pomodoro-raccoon
```

## Usage

```bash
pomodoro-raccoon
```

Custom durations:
```bash
pomodoro-raccoon --work 50 --short-break 10 --long-break 30
```

Or directly in Python:
```python
from pomodoro_raccoon import run
run()
```

## CLI Options

| Option | Default | Description |
|---|---|---|
| `--work MIN` | 25 | Work session duration in minutes |
| `--short-break MIN` | 5 | Short break duration in minutes |
| `--long-break MIN` | 25 | Long break duration in minutes |

## Preview

```
       🍅
     (\_/)
     ( •_•)
     / >🍵   Focusing...

  Session 1
  [████████████████--------------] 53%
  ⏱  11:44 remaining
  💬 Keep it up, champ! 🦝💪

  [Press Enter to end session early]
```

## Changelog

See [CHANGELOG.md](CHANGELOG.md) for the full release history.

## License

MIT License — see [LICENSE](LICENSE).
