EyeBreak v1.0.0 - Initial Release
👁️ EyeBreak v1.0.0 - Your Eyes Deserve a Break
A minimalistic macOS menu bar app that helps reduce digital eye strain by following the 20-20-20 rule.
📥 Installation (3 Easy Steps)
- Download
EyeBreak-v1.0.0.dmgfrom Assets below ⬇️ - Open the DMG file and drag the app to Applications folder
- Right-click the app → Select "Open" → Click "Open" again
That's it! Look for the 👁️ icon in your menu bar!
Why right-click? macOS requires this for unsigned apps on first launch only.
✨ What's Included
- 🎯 Menu Bar Integration - Quiet and unobtrusive
- ⏰ Smart 20-20-20 Timer - Scientifically-backed eye care
- 🌫️ Screen Blur - Gentle break enforcement (optional)
- 🔔 Break Notifications - 30-second warnings
- 😴 Auto Idle Detection - Pauses when you're away
- 📊 Daily Statistics - Track your eye health habits
- 🍅 Pomodoro Mode - 25/5 work/break cycles
- 🔒 100% Private - Zero data collection, works offline
🔐 Required Permissions
EyeBreak will request:
-
Notifications (Recommended)
- For break reminders
- Enable in: System Settings → Notifications → EyeBreak
-
Screen Recording (Optional, for Blur Mode)
- Enables screen blur during breaks
- Enable in: System Settings → Privacy & Security → Screen Recording
- Without this, app uses "Notification Only" mode
📚 Documentation
- 📖 Quick Start Guide
- ❓ FAQ
- 🏗️ Architecture
- 🐛 Report Issues
📋 System Requirements
- macOS: 14.0 (Sonoma) or later
- Architecture: Apple Silicon (M1/M2/M3) or Intel
- Storage: ~3 MB
- RAM: Minimal (~20 MB)
🚀 Quick Start
- Look for the eye icon 👁️ in your menu bar (top-right)
- Click it and select "Start Timer"
- Work for 20 minutes
- Take a 20-second break when prompted
- Your eyes will thank you! 😊
🙏 Support
- 🐛 Report a Bug
- 💡 Request a Feature
- 📧 Email: chansocheatsok2001@gmail.com
📜 License
MIT License - Free and open source
Remember: Every 20 minutes, look 20 feet away for 20 seconds! 👁️✨
Full Changelog: https://github.com/cheat2001/eyebreak/blob/main/CHANGELOG.md