README.md

PomPom

A beautiful terminal-based Pomodoro timer to boost your productivity with focus sessions and breaks.

Feel free to fork & contribute!

Features

• ⏱️ Three timer modes: Focus (25m), Short Break (5m), and Long Break (15m)
• 🔄 Auto-switch between modes after completion
• 🔊 Sound alerts when timers complete
• ⚙️ Fully customizable durations
• 📊 Track completed focus sessions
• 💾 Automatic persistence of settings between sessions
• 🎨 Beautiful, color-coded interface

Installation

npm i -g pompom

Usage

Simply run in your terminal:

pompom

How It Works

PomPom follows the Pomodoro Technique:

1. Work for 25 minutes (Focus mode)
2. Take a 5-minute break (Short Break)
3. Repeat steps 1-2 three more times
4. After 4 focus sessions, take a longer 15-minute break (Long Break)
5. Repeat the cycle

Customization

PomPom stores your settings in ~/.pompom/settings.json. You can also replace the default sound file with your own by placing a sound.wav file in ~/.pompom.

Thanks

• Real thanks to djcows, his Spotify account - djcow's Spotify