FindMyFriends v1.0.0

FindMyFriends v1.0.0

Native macOS menu bar app that bridges Apple Find My friend/family locations to Home Assistant via MQTT.

Features

• Multi-person tracking with configurable polling intervals
• MQTT auto-discovery — tracked people appear as device_tracker entities in Home Assistant
• Zone-aware presence — configurable zones determine home/not_home/zone states
• AI-enhanced location (optional) — uses Anthropic's vision API to read precise locations from Find My map screenshots when only neighborhood-level addresses are available
• Sleep scheduling — auto-pause tracking during configured hours
• Live log viewer with filtering and file logging
• Settings export/import for backup and migration

Important: Unsigned App

This app is not code-signed or notarized by Apple. To run it:

1. Download FindMyTracker.app.zip below and unzip it
2. Move FindMyTracker.app to your Applications folder
3. Right-click the app and select Open (do not double-click)
4. Click Open in the Gatekeeper warning dialog
5. Alternatively: go to System Settings > Privacy & Security and click Open Anyway

Required macOS Permissions

Permission	Purpose	How to Grant
Accessibility	Read location data from Find My's UI elements	System Settings > Privacy & Security > Accessibility > Enable FindMyTracker
Automation (Find My)	Send commands to the Find My app via AppleScript	Automatically prompted on first use

Optional Permission

Permission	Purpose	How to Grant
Screen Recording	Capture Find My map for AI-enhanced location (only if enabled)	System Settings > Privacy & Security > Screen Recording > Enable FindMyTracker

Note: Restart the app after granting Accessibility or Screen Recording permissions.

Requirements

• macOS 13.0 (Ventura) or later
• Apple Find My app with shared contacts
• Home Assistant with an MQTT broker
• Anthropic API key (optional, for AI vision feature)

Build from Source

git clone https://github.com/bytePatrol/FindMyFriends.git
cd FindMyFriends
./build-app.sh
open FindMyTracker.app