seemoo-lab/openhaystack

Build your own 'AirTags' 🏷 today! Framework for tracking personal Bluetooth devices via Apple's massive Find My network.

View on GitHub ↗Jump to charts ↓

Summary Information

Updated 17 minutes ago
Added to GitGenius on September 4th, 2026
Created on February 22nd, 2021
Open Issues & Pull Requests: 145 (+0)
GitHub issues: Enabled
Number of forks: 679
Total Stargazers: 13,513 (+0)
Total Subscribers: 138 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 2.2 days
Mean response time: 39.8 days
90th percentile: 125.9 days
Tracked items: 36

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 100% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Only 4% of issues opened in the past year have been closed.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 29
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 1,013 days
Stale 30+ days: 28
Stale 90+ days: 24

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • question (24)
  • enhancement (11)
  • bug (4)
  • wontfix (2)

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

OpenHaystack is a framework for creating custom tracking tags that leverage Apple's Find My network to locate personal Bluetooth devices without cellular coverage.

The tool solves the problem of tracking physical objects by reverse-engineering Apple's Find My network and enabling users to build their own tracking accessories. It works by having Bluetooth devices broadcast beacons that nearby iPhones discover and report back to Apple's servers with location data. The framework consists of a macOS application that displays the last reported location of tracked devices and firmware that enables Bluetooth devices to broadcast the necessary beacons for discovery by iPhones.

OpenHaystack suits developers and users who want to track personal items using existing Apple infrastructure without relying on commercial tracking products. It works with BBC micro:bit devices or any other Bluetooth-capable hardware that can run the provided firmware. The project is experimental and incomplete, with known limitations such as accessories broadcasting a fixed public key that makes them trackable by other devices in proximity. The tool requires macOS and is not affiliated with or endorsed by Apple.

The project emerged from reverse-engineering and security analysis work conducted at an academic lab, with the authors having published research on Apple's offline finding system and identified vulnerabilities in the original implementation. Development appears to acknowledge the experimental nature of the codebase, with documentation noting that code is untested and incomplete. The project includes both a macOS application component and firmware for Bluetooth devices, indicating active work across multiple technical domains.