How kenhtaymay/openhaystack works
OpenHaystack is a macOS application and firmware suite for creating Bluetooth tracking accessories and viewing their latest Find My locations. The main workflow configures an accessory and its key, deploys its public key to hardware, then uses authenticated report retrieval and private-key decryption to display locations. The README also documents firmware-based beaconing and a cross-platform mobile app. Edges are limited to documented README flows or source-index references; firmware-to-Apple discovery and mobile runtime internals are not sampled.
Main entry points: AccessoryController.swift Accessory controller · FindMyController.swift Report retrieval · Accessory.swift Accessory and keys · OpenHaystackMainView.swift Main interface
Components 20
Accessory management
- Main interface
OpenHaystack/OpenHaystack/HaystackApp/Views/OpenHaystackMainView.swift - Accessory controller
OpenHaystack/OpenHaystack/HaystackApp/AccessoryController.swift - Accessory and keys
OpenHaystack/OpenHaystack/HaystackApp/Model/Accessory.swift - Private key store
OpenHaystack/OpenHaystack/HaystackApp/KeychainController.swift - File operations
OpenHaystack/OpenHaystack/HaystackApp/FileManager.swift
Find My reports
- Mail plugin manager
OpenHaystack/OpenHaystack/HaystackApp/Mail Plugin/MailPluginManager.swift - Apple Mail plugin
OpenHaystack/OpenHaystackMail/OpenHaystackPluginService.h - Account authentication
OpenHaystack/OpenHaystack/AnisetteDataManager.swift - Report retrieval
OpenHaystack/OpenHaystack/FindMy/FindMyController.swift - Report decryption
OpenHaystack/OpenHaystack/FindMy/DecryptReports.swift - Location map
OpenHaystack/OpenHaystack/HaystackApp/Views/AccessoryMapView.swift
Hardware deployment
- micro:bit deployment
OpenHaystack/OpenHaystack/HaystackApp/MicrobitController.swift - ESP32 deployment
OpenHaystack/OpenHaystack/HaystackApp/ESP32Controller.swift - nRF deployment
OpenHaystack/OpenHaystack/HaystackApp/NRFController.swift - micro:bit firmware
Firmware/Microbit_v1/offline-finding/main.c - ESP32 firmware
Firmware/ESP32/main/openhaystack_main.c - Linux HCI beacon
Firmware/Linux_HCI/HCI.py
Mobile app
- OpenHaystack Mobile
openhaystack-mobile
Other components
- Accessory owner
- Apple Find My service
Connections 27
- Accessory owner → Main interface: manages accessories
- Main interface → Accessory controller: uses
OpenHaystack/OpenHaystack/HaystackApp/Views/OpenHaystackMainView.swift - Accessory controller → Accessory and keys: creates and updates
OpenHaystack/OpenHaystack/HaystackApp/AccessoryController.swift - Accessory controller → Private key store: stores keys
OpenHaystack/OpenHaystack/HaystackApp/AccessoryController.swift - Accessory controller → Report retrieval: requests reports
OpenHaystack/OpenHaystack/HaystackApp/AccessoryController.swift - Accessory and keys → Private key store: keeps private key
OpenHaystack/OpenHaystack/HaystackApp/KeychainController.swift - Main interface → Mail plugin manager: manages plugin
OpenHaystack/OpenHaystack/HaystackApp/Views/OpenHaystackMainView.swift - Mail plugin manager → File operations: copies plugin files
OpenHaystack/OpenHaystack/HaystackApp/Mail Plugin/MailPluginManager.swift - Apple Mail plugin → Account authentication: provides account data
- Account authentication → Apple Mail plugin: requests authentication data
OpenHaystack/OpenHaystack/AnisetteDataManager.swift - Account authentication → Report retrieval: supplies search token
- Report retrieval → Apple Find My service: queries reports
- Report retrieval → Report decryption: decrypts reports
OpenHaystack/OpenHaystack/FindMy/FindMyController.swift - Main interface → Location map: displays locations
OpenHaystack/OpenHaystack/HaystackApp/Views/OpenHaystackMainView.swift - Report retrieval → Location map: provides latest locations
- Accessory controller → micro:bit deployment: deploys accessory
- Accessory controller → ESP32 deployment: deploys accessory
- Accessory controller → nRF deployment: deploys accessory
- micro:bit deployment → micro:bit firmware: writes firmware
OpenHaystack/OpenHaystack/HaystackApp/MicrobitController.swift - micro:bit deployment → Accessory and keys: patches public key
OpenHaystack/OpenHaystack/HaystackApp/MicrobitController.swift - ESP32 deployment → Accessory and keys: uses accessory key
OpenHaystack/OpenHaystack/HaystackApp/ESP32Controller.swift - ESP32 deployment → ESP32 firmware: deploys firmware
- Accessory and keys → nRF deployment: provides accessory data
OpenHaystack/OpenHaystack/HaystackApp/NRFController.swift - micro:bit firmware → Apple Find My service: broadcasts BLE beacon
- ESP32 firmware → Apple Find My service: broadcasts BLE beacon
- Linux HCI beacon → Apple Find My service: broadcasts BLE beacon
- Accessory owner → OpenHaystack Mobile: uses mobile app