🍅 PomoBar User Guide

PomoBar is a lightweight, distraction-free Pomodoro timer designed specifically for the macOS menu bar. It helps you stay focused by breaking your work into manageable sessions followed by short breaks.

🚀 Getting Started

Once you launch PomoBar, it lives entirely in your macOS Menu Bar (the top right toolbar).

The Display: You will see a timer icon and a countdown (e.g., 25:00).
Opening the Menu: Click the timer icon to open the control dashboard.

⏱ Starting Your First Session

Start/Stop: Click the large Green “Start” button to begin focusing. The button will turn Red and change to “Stop” while the timer is active.
The Progress Bar: As time passes, the orange bar will shrink, giving you a visual sense of how much work time remains.

🛠 Features & Controls

1. Customizable Durations

You can change your session lengths at any time using the segmented controls:

Work: Choose between 25, 30, 35, or 45 minutes.
Break: Choose between 5, 10, or 15 minutes.

Note: Changing the duration will automatically reset the current timer.

2. Auto-Break System

PomoBar is designed to keep your flow going:

When a Work Session ends, a notification will sound, the icon will turn Green, and your Break Timer will start automatically.
When a Break ends, the app will reset to your chosen Work duration and wait for you to click Start to begin the next cycle.

3. Smart Notifications

You don’t need to keep the menu open. PomoBar will send a macOS System Notification and play a “Glass” chime when:

Your focus session is complete.
Your break is over.

⚙️ Advanced Tips

Memory: PomoBar remembers your settings. If you close the app and reopen it, it will remember your preferred work and break lengths.
Menu Bar Status: The icon pulses slightly when the timer is active, so you can confirm it’s running without even clicking it.
Color Coding: * 🟠 Orange: Focus/Work Mode.
- 🟢 Green: Rest/Break Mode.

❓ Frequently Asked Questions

Q: Why don’t I see the app in my Dock?

A: PomoBar is a “Menu Bar Extra.” It is designed to stay out of your way and only occupies space in the top toolbar to keep your workspace clean.

Q: How do I turn off the sound?

A: PomoBar uses system notification sounds. You can silence it by putting your Mac into “Do Not Disturb” mode or by adjusting notification settings in System Settings > Notifications > PomoBar.

Q: How do I quit the app?

A: Open the PomoBar menu and click the “Quit” link at the very bottom right.

Need help?

Developer: Tim Clark

Company: TC Soft Consulting

Version: 2.1