🐾 Blipsy — A Pomodoro Timer That Stares Into Your Soul

Blipsy is a terminal-based Pomodoro timer with an animated ASCII cat who silently judges your every move.
Because staring into a void cat's eyes makes you more productive.

✨ Features

• ⏳ Focus & break cycles (Pomodoro-style)
• 🐱 ASCII animation that blinks while you work
• 🎨 Customizable durations & messages
• 🧘 Quiet mode for terminal monks (--no-art)
• 🔔 Bell when time’s up
• 📊 Progress bar using rich to answer “how much longer?”
• ⏯ Pausing functionality

📥 Installation

There are now 2 ways to run this project - one uses the poetry to install dependencies.

Note: The first method requires you to be in the same directory as the blipsy.py file every time you run the program.

Method 1 (manual)

# Clone the repo
git clone https://github.com/meoowe/blipsy
cd blipsy

# Install dependencies
pip install rich typer keyboard

# Run it
python blipsy.py run

Method 2 (poetry)

git clone https://github.com/meoowe/blipsy.git # Clone repo
cd blipsy
poetry sync # Install dependencies
blipsy run # You can run this from anywhere!

🧪 Usage

Blipsy uses Typer, so it comes with built-in help:

python blipsy.py --help

🎯 Real Pomodoro Mode

python blipsy.py run

• 4 cycles
• 25 minutes work
• 5 minute short breaks
• 15 minute long break

You can customize all of this:

python blipsy.py run --cycles 2 --focus-secs 1200 --short-break-secs 300 --long-break-secs 900

🐾 Demo Mode

Want to test the animation without waiting 25 minutes?

python blipsy.py demo

😶 Quiet Mode (No Animation)

python blipsy.py run --no-art

Pause Shortcut

By default, the Shortcut to pause is Ctrl+Shift+p. It can be changed with the option --pause-hotkey.

python blipsy.py run --pause-hotkey alt+a

🌟 Like it?

If Blipsy helped you do literally anything — drop a ⭐ on the repo.
Or tell a friend. Or post a screenshot.