🛡️ SafeAway - Your Intelligent Mac Security Guardian

中文文档 | English

🎯 What is SafeAway?

SafeAway is your smart macOS security monitoring companion that keeps a watchful eye on your Mac when you're away. Think of it as a digital security guard that never sleeps!

Ever worried about someone snooping around your computer while you grab a coffee? Or concerned about unauthorized access to your Mac when you're not around? SafeAway has got your back! 🦸‍♂️

🚀 Key Features That Make You Feel Secure

🎥 Smart Camera Surveillance

• Automatic photo capture when screen wakes or unlocks
• Human detection using advanced Vision AI technology
• Motion detection to catch any suspicious activity
• Customizable capture intervals (from 5 seconds to 5 minutes)

📱 Instant Telegram Notifications

• Real-time alerts sent directly to your phone
• Photo and video evidence delivered instantly
• Smart queue management for reliable delivery
• Encrypted bot token storage in macOS Keychain

🧠 Intelligent Detection System

• AI-powered human recognition with adjustable confidence levels
• Motion sensitivity controls to reduce false positives
• Smart filtering to avoid notification spam
• Background operation with minimal system impact

🔐 Privacy-First Design

• Local processing - no cloud dependency for core features
• Secure credential storage using macOS Keychain
• Permission management with clear user controls
• No tracking, no analytics - your security is YOUR business

⚡ System Event Monitoring

• Screen lock/unlock detection
• Sleep/wake monitoring
• System state tracking
• Automatic monitoring toggle based on your preferences

🎬 How It Works

1. Set It Up 🔧

   • Grant camera and screen recording permissions
   • Configure your Telegram bot token and chat ID
   • Adjust detection sensitivity to your liking

2. Activate Monitoring ▶️

   • Click the shield icon in your menu bar
   • Choose "Start Monitoring"
   • SafeAway begins watching for suspicious activity

3. Stay Informed 📲

   • Receive instant Telegram notifications
   • Review captured photos and videos
   • Take action if needed

4. Peace of Mind 😌

   • Work from cafes without worry
   • Leave your desk knowing your Mac is protected
   • Sleep better knowing SafeAway is on guard

🛠️ Installation & Setup

Requirements

• macOS 13.0 (Ventura) or later
• Built-in or external camera
• Telegram account (for notifications)
• ~50MB disk space

Quick Start

1. Download SafeAway from Releases
2. Move to Applications folder
3. Launch SafeAway - look for the shield icon in your menu bar
4. Grant Permissions:
   • Camera access for capturing photos/videos
   • Screen recording for motion detection
   • Microphone (optional) for video with audio
5. Configure Telegram (optional but recommended):
   • Create a bot via @BotFather
   • Get your chat ID
   • Enter credentials in SafeAway settings

🎮 Usage Tips & Tricks

Pro Tips for Maximum Security

• 🎯 Optimal Placement: Position your Mac to capture the room entrance
• ⏰ Smart Scheduling: Enable auto-start for immediate protection
• 🔧 Fine-Tuning: Adjust detection sensitivity based on your environment
• 📸 Test Mode: Use "Test Capture" to verify camera angles
• 🔕 Quiet Hours: Configure capture intervals to balance security and storage

Common Use Cases

• ☕ Coffee Shop Security: Monitor your Mac while ordering
• 🏢 Office Protection: Guard against coworker pranks
• 🏠 Home Security: Turn your Mac into a security camera
• 👶 Baby Monitor: Keep an eye on your little ones
• 🐕 Pet Surveillance: See what your furry friends do when alone

🔧 Advanced Configuration

Detection Settings

• Human Detection Confidence: 0.1 (sensitive) to 1.0 (strict)
• Motion Sensitivity: Adjustable threshold for movement detection
• Capture Quality: Balance between file size and image clarity

Privacy Options

• Local Storage Only: Disable Telegram for complete offline operation
• Auto-Delete: Configure automatic cleanup of old captures
• Selective Monitoring: Choose which events trigger captures

🤝 Contributing

We love contributions! Whether it's:

• 🐛 Bug reports
• 💡 Feature suggestions
• 🌐 Translations
• 📝 Documentation improvements
• 🎨 UI/UX enhancements

Check our Contributing Guidelines to get started!

📊 System Impact

SafeAway is designed to be lightweight and efficient:

• CPU Usage: < 5% during monitoring
• Memory: ~30-50MB RAM
• Battery Impact: Minimal when using built-in camera
• Storage: Configurable capture retention

🔒 Security & Privacy

Your security is our priority:

• ✅ Open source for transparency
• ✅ Local processing by default
• ✅ Encrypted credential storage
• ✅ No telemetry or tracking
• ✅ Regular security updates

🏷️ Keywords for Fellow Security Enthusiasts

macOS security Mac surveillance computer monitoring theft prevention privacy protection AI detection motion detection human recognition Telegram integration Swift application macOS Ventura macOS Sonoma security camera webcam monitoring screen unlock detection unauthorized access prevention digital security workplace security laptop protection Vision framework AVFoundation macOS development security software anti-theft surveillance app Mac safety computer guardian intrusion detection

📜 License

SafeAway is released under the MIT License. See LICENSE for details.

🙏 Acknowledgments

• Apple's Vision framework for AI capabilities
• The Swift community for amazing tools
• Our users for trusting SafeAway with their security
• Coffee ☕ for keeping us awake during development

📞 Support & Contact

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: love@yrzhe.space
• 🐦 Twitter: @yrzhe_top

---

Built with ❤️ for Mac users who value their privacy and security

Stay Safe, Stay Away from prying eyes! 🛡️