Smart 20-20-20 reminders for macOS. Lives in your menu bar. Triggers TV static when it's time to rest.
Download · Website · Report Bug · Request Feature
Staring at screens all day causes digital eye strain — headaches, dry eyes, blurred vision. The 20-20-20 rule (every 20 min, look 20 feet away for 20 seconds) is clinically proven to help, but reminders are easy to dismiss.
EyeBreak takes a different approach: when break time comes, your screen fills with TV static. No countdown to stare at, no pretty animation. Just a boring screen that makes you look away naturally.
|
|
| Menu Bar | Settings | Break Overlay |
|---|---|---|
 |
 |
 |
- Download the latest DMG
- Open the DMG and drag EyeBreak to
/Applications - Right-click the app → Open (first time only — due to macOS security)
brew install --cask eyebreakgit clone https://github.com/MayadahAA/EyeBreak.git
cd EyeBreak
make run| Requirement | Version |
|---|---|
| macOS | 13 (Ventura) or later |
| Swift | 5.9+ (for building) |
| Disk | ~1 MB |
- Launch — an eye icon appears in your menu bar
- Click to view the timer, stats, and settings
- Work normally — EyeBreak runs quietly in the background
- Break time — your screen fills with TV static for 20 seconds
- Press ESC anytime to skip a break
EyeBreak uses an Open Core model. The free version in this repo is fully functional and open source. Pro features are distributed as signed DMG builds.
EyeBreak/
├── Sources/EyeBreak/ # Core app (free, open source)
│ ├── EyeBreakApp.swift # Entry point
│ ├── TimerManager.swift # Timer + stats engine
│ ├── SettingsManager.swift # UserDefaults + login item
│ ├── NotificationManager.swift # macOS notifications
│ ├── BreakOverlayWindow.swift # TV static NSPanel
│ ├── MenuBarView.swift # SwiftUI popover
│ ├── Strings.swift # AR + EN localization
│ ├── ProManager.swift # Pro stub (free build)
│ └── UpdateManager.swift # GitHub Releases checker
├── Resources/Info.plist # App bundle metadata
├── scripts/ # Build + release tooling
├── website/ # Landing page (GitHub Pages)
└── docs/ # Documentation + screenshots
Tech stack: Swift 5.9 · SwiftUI · AppKit · UserNotifications · ServiceManagement · Combine · Swift Package Manager
Zero external dependencies.
# Build release
make
# Build + launch
make run
# Install to /Applications
make install
# Demo mode (10-second timer for testing)
open build/EyeBreak.app --args --demo
# Create distribution DMG
bash scripts/create-dmg.sh- v1.0 — Initial release: menu bar app, TV static, AR/EN
- v1.1 — Pro features: weekly stats, custom sounds, Pomodoro
- v1.2 — Homebrew Cask distribution
- v1.3 — Apple Notarization (no security warnings)
- v2.0 — iOS companion app (Shortcut integration)
See CHANGELOG.md for version history.
Contributions welcome! Please read CONTRIBUTING.md first.
Quick guide:
- Fork the repo
- Create a feature branch (
git checkout -b feat/amazing-feature) - Commit (
git commit -m 'feat: add amazing feature') - Push (
git push origin feat/amazing-feature) - Open a Pull Request
- Found a bug? Open an issue
- Feature idea? Request it
- Like the project? Sponsor development · Star on GitHub
EyeBreak is released under the MIT License.
Built with ❤️ by MayadahAA
Made using Claude Code · Inspired by the 20-20-20 rule