Mac Vision Tools

A macOS menu bar app for real-time ML-powered detection with multiple modes.

<p align="center"> <img src="images/emotion.png" alt="Emotion Monitoring" width="260" style="margin-right: 10px;"> <img src="images/standard.png" alt="Standard Detection" width="260" style="margin-right: 10px;"> <img src="images/privacy.png" alt="Privacy Lock" width="260"> </p>

Features

| Mode | Description | Model | |------|-------------|-------| | 🎯 Standard Detection | YOLO object detection | YOLO12n | | 😊 Emotion Vibes | Real-time facial emotion recognition | Emotieff | | 🔒 Privacy Guard | Auto-locks screen when others approach | YOLO12n | | ⏱️ Focus Timer | Pomodoro timer with attention tracking | Native Vision |

Installation

1. Download the latest release from Releases
2. Move MacVisionTools.app to Applications
3. Try to Open
4. Press Open anyway from privacy settings
5. Grant Camera or Screen Recording permission when prompted

Usage

| Control | Options | |---------|---------| | Source | Camera / Screen | | Display | Window / Overlay | | FPS | 10 / 30 / 60 / Max |

Models

| Model | Task | Source | |-------|------|--------| | YOLO12n | Object Detection | Ultralytics | | Emotieff | Emotion Recognition | EmotiEff | | Apple Vision Framework | Face tracking | Apple Documentation |

License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details. For full details on third-party model licenses and acknowledgments, please see CREDITS.md.