FollowMyFriends v1.0

FollowMyFriends v1.0

Initial release of FollowMyFriends — a native macOS app that bridges Apple Find My friend locations to Home Assistant via MQTT.

Installation

1. Download FollowMyFriends-1.0.dmg
2. Open the DMG and drag FollowMyFriends to your Applications folder
3. Launch the app and follow the first-time setup guide in the README

What's included

• Full decryption pipeline — AES-256-CBC-XOR decryption of Apple's Find My SQLite database
• WAL watcher — kqueue-based file system monitor that reacts instantly when findmylocateagent writes new location data (~20 min intervals)
• MQTT auto-discovery — device trackers appear in Home Assistant automatically, no YAML required
• Configurable polling — min/max intervals with optional randomisation and night mode
• Find My invisible launch — opens Find My in the background to trigger server polls without stealing focus
• GPS fix freshness logging — per-person indicator showing exactly how fresh Apple's location data is
• Keychain storage — MQTT credentials stored securely, never in plaintext

Requirements

• macOS 14.0 Sonoma or later
• Apple Find My with at least one friend sharing their location
• 32-byte AES key extracted from findmylocateagent (one-time setup — see README)
• MQTT broker on your local network