pomodoro-raccoon 0.2.0

Ein simpler Pomodoro-Timer mit ASCII-Waschbär-Animation

🦝 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

pip install pomodoro-raccoon

Usage

pomodoro-raccoon

Custom durations:

pomodoro-raccoon --work 50 --short-break 10 --long-break 30

Or directly in 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 for the full release history.

License

MIT License — see LICENSE.