Take a Break

A simple and elegant macOS menubar Pomodoro timer application that helps you maintain focus and take regular breaks.

Features

• Menubar Integration: Timer countdown displayed directly in your menubar
• Customizable Work Sessions: Set your preferred work duration (default: 20 minutes)
• Fullscreen Break Reminders: Immersive break screens to ensure you actually take a break
• Configurable Break Duration: Customize how long your break reminders stay on screen
• Personal Break Messages: Set custom motivational messages for your breaks
• Elegant UI: Clean, minimal interface with circular progress indicator
• Native macOS Design: Built with AppKit for seamless macOS integration

Installation

1. Clone this repository
2. Open menubarApp.xcodeproj in Xcode
3. Build and run the project (⌘+R)
4. The app will appear in your menubar

Usage

• Start Timer: The timer starts automatically when you launch the app
• View Progress: Click the menubar icon to see detailed progress and controls
• Pause/Resume: Use the pause button in the popover
• Reset Timer: Click the reset button to restart your work session
• Force Break: Use the "Break" option from the menu
• Customize Settings: Access preferences to personalize your experience

Preferences

Customize your experience through the Preferences window:

• Show Time in Menubar: Toggle timer display in menubar
• Work Time: Set your preferred work session duration
• Break Time: Configure how long break reminders stay visible
• Break Message: Personalize your break reminder text
• Break Screen Color: Choose your break screen background color

Keyboard Shortcuts

• ⌘+Q: Quit the application (when popover is focused)

Requirements

• macOS 10.15 or later
• Xcode 12.0 or later (for building from source)

License

This project is open source. Feel free to modify and distribute as needed.

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.