Our take
- Activity
- 37
- Community
- 4
- Issues
- 53
- Pull requests
- 65
+14 stars in the last 30 days
- Fewer contributors than 91% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
1,543Forks
50Change since Nov 17, 2026: +1 stars·0 forks
Overview
go-haystack is a set of Go and TinyGo tools for setting up personal Bluetooth beacons that can be located through Apple’s Find My network. It combines OpenHaystack and Macless-Haystack, so beacon owners can use the network without owning Apple hardware.
The project covers beacon firmware for supported microcontrollers and Linux devices, plus command-line tools for managing keys, flashing beacons, and scanning for nearby devices. It is aimed at people comfortable setting up hardware and operating the supporting services themselves.
Key Features
- Generate device keys and configuration files with the
haystackcommand-line tool. - Build and flash beacon firmware with TinyGo on supported boards, including nRF52840, ESP32-C3/S3, and Pico-W hardware.
- Run beacon firmware on Linux systems with Bluetooth hardware.
- Scan for nearby Bluetooth devices with
haystack scan. - Use TinyScan on supported microcontroller boards with small displays.
- Connect to Macless-Haystack to view reported device locations.
Use Cases
- Makers can build a custom beacon for personal items using a supported microcontroller instead of buying an Apple tracker.
- Embedded developers can prototype a Find My-compatible beacon on supported boards or Linux hardware.
- Users with personal beacons can scan locally for nearby Bluetooth devices and identify their own devices with TinyScan.
- Self-hosting users can run the required Macless-Haystack and anisette services and manage their own beacon setup.
Getting Started
Install the CLI with Go:
go install github.com/hybridgroup/go-haystack/cmd/haystack@latest
The setup also requires an Apple ID with two-factor authentication and running anisette-v3-server and Macless-Haystack services. See the README for setup, device support, and flashing instructions.
Considerations
- This requires Bluetooth-capable hardware for beaconing or scanning, and board support varies. Some ESP32-C3 and ESP32-S3 targets require TinyGo 0.42 or later.
- Location reporting depends on Apple's Find My network and the separately configured Macless-Haystack and anisette services. Initial reports may take time to appear.
- The README specifies an Apple ID with 2FA enabled and supports SMS/text message as the second factor.
- The project handles device keys and personal location tracking. Review its key guidance and consider the privacy implications before deployment.
Found this useful?
Share it with someone who would like go-haystack.