# seemoo-lab/openhaystack **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/seemoo-lab-openhaystack).** 13,048 stars · 653 forks · Swift · AGPL-3.0 ## Links - GitHub: https://github.com/seemoo-lab/openhaystack - Homepage: https://owlink.org - awesome-repositories: https://awesome-repositories.com/repository/seemoo-lab-openhaystack.md ## Topics `airtag` `apple` `bluetooth` `find-my` `location-tracker` `macos` `microbit` `offline-finding` `reverse-engineering` ## Description OpenHaystack is a software framework for creating and tracking custom Bluetooth beacons using the Apple Find My crowdsourced location network. It provides a system for generating encrypted cryptographic keys and flashing firmware onto embedded hardware to broadcast trackable Bluetooth signals. The project enables the retrieval and decryption of geographic coordinates for remote hardware using private keys to recover device movement history. It also includes a location proxy that fetches network reports from the Apple ecosystem and serves that data to remote applications. The toolset covers cryptographic identity management, firmware deployment via USB, and the visualization of device locations on a map. It further provides capabilities for extracting private advertisement keys to decrypt associated location data. ## Tags ### Hardware & IoT - [Apple Find My Network Integration](https://awesome-repositories.com/f/hardware-iot/apple-find-my-network-integration.md) — Creates custom Bluetooth beacons that leverage the Apple Find My network for global device tracking. - [Bluetooth Tracking Systems](https://awesome-repositories.com/f/hardware-iot/bluetooth-tracking-systems.md) — Decrypts location history and maps geographic coordinates of registered Bluetooth accessories. - [Crowdsourced Device Tracking](https://awesome-repositories.com/f/hardware-iot/crowdsourced-device-tracking.md) — Retrieves and decrypts geographic coordinates for remote hardware using a distributed network of receivers. - [Find My Network Frameworks](https://awesome-repositories.com/f/hardware-iot/find-my-network-frameworks.md) — Provides a software suite for creating and tracking custom Bluetooth beacons via the Apple Find My network. - [Firmware Deployment Tools](https://awesome-repositories.com/f/hardware-iot/firmware-deployment-tools.md) — Supports flashing beaconing software and public keys onto embedded hardware via USB or scripts. ([source](https://github.com/seemoo-lab/openhaystack/blob/main/README.md)) ### Part of an Awesome List - [Beacon Generators](https://awesome-repositories.com/f/awesome-lists/devtools/beacon-development-libraries/beacon-generators.md) — Enables the creation of encrypted key pairs and firmware to transform devices into trackable beacons. ([source](https://github.com/seemoo-lab/openhaystack/blob/main/README.md)) - [Beacon Firmware](https://awesome-repositories.com/f/awesome-lists/devtools/beacon-discovery-and-management/beacon-firmware.md) — Flashes custom firmware onto Bluetooth devices to broadcast tracking signals. - [Bluetooth Low Energy Tools](https://awesome-repositories.com/f/awesome-lists/devtools/bluetooth-low-energy-tools.md) — Provides a system for generating cryptographic keys and flashing firmware for BLE beacons. - [Beacon Discovery and Management](https://awesome-repositories.com/f/awesome-lists/devtools/beacon-discovery-and-management.md) — Flashing encrypted firmware and public keys onto embedded hardware for wireless location broadcasting. ### Networking & Communication - [Bluetooth Connectivity](https://awesome-repositories.com/f/networking-communication/bluetooth-connectivity.md) — Enables hardware to broadcast Bluetooth signals for discovery by a global crowdsourced network. ([source](https://github.com/seemoo-lab/openhaystack/blob/main/Firmware/ESP32)) - [BLE Advertisements](https://awesome-repositories.com/f/networking-communication/low-power-signaling/ble-advertisements.md) — Implements low-level Bluetooth Low Energy advertisements to make hardware visible to the tracking network. - [Location Data Proxies](https://awesome-repositories.com/f/networking-communication/location-data-proxies.md) — Acts as a bridge that fetches network reports from the Apple ecosystem for remote applications. - [Location Proxy Servers](https://awesome-repositories.com/f/networking-communication/location-proxy-servers.md) — Provides a bridge server to fetch network reports and serve them to remote mobile applications. ([source](https://github.com/seemoo-lab/openhaystack#readme)) - [Network Report Bridges](https://awesome-repositories.com/f/networking-communication/network-report-bridges.md) — Acts as a middleware server translating raw network reports for mobile client applications. - [Network Bridging Proxies](https://awesome-repositories.com/f/networking-communication/webhook-integrations/network-bridging-proxies.md) — Runs a bridge on local hardware to fetch network reports and serve them to remote apps. ### Security & Cryptography - [Key Generation Tools](https://awesome-repositories.com/f/security-cryptography/cryptography/key-generation-tools.md) — Includes utilities for creating the secure public and private key pairs needed for location encryption. - [Identity & Key Management](https://awesome-repositories.com/f/security-cryptography/identity-key-management.md) — Provides tools to generate unique cryptographic keys and identities for network discovery. ([source](https://github.com/seemoo-lab/openhaystack#readme)) - [Location Data Decryption](https://awesome-repositories.com/f/security-cryptography/location-data-decryption.md) — Uses private keys to transform encrypted network reports into readable geographic coordinates. - [Location Report Decryptions](https://awesome-repositories.com/f/security-cryptography/message-decryption/location-report-decryptions.md) — Provides tools to decrypt encrypted location reports using private keys to recover device movement history. ([source](https://github.com/seemoo-lab/openhaystack/blob/main/README.Reproducibility.md)) - [Private Key Extractions](https://awesome-repositories.com/f/security-cryptography/private-key-extractions.md) — Implements capabilities to read private advertisement keys from a device to enable the decryption of location data. ([source](https://github.com/seemoo-lab/openhaystack/blob/main/README.Reproducibility.md)) ### System Administration & Monitoring - [Location Tracking](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring/location-tracking.md) — Retrieves and displays the most recent geographic coordinates of registered Bluetooth accessories on a map. ([source](https://github.com/seemoo-lab/openhaystack#readme)) ### Data & Databases - [Location Report Proxies](https://awesome-repositories.com/f/data-databases/remote-data-fetching/location-report-proxies.md) — Uses a bridge device to request and retrieve encrypted network reports from remote cloud infrastructure.