hybridgroup

go-haystack: Build Bluetooth Beacons for Find My

go-haystack provides Go and TinyGo tools for creating Bluetooth beacons that report through Apple’s Find My network using OpenHaystack and Macless-Haystack. It suits makers who want to track personal devices without Apple hardware.

View on GitHub Compare
Stars
1.5k
Forks
49
Stars, last 30 days
+14

Our take

Health score

40/100

How it is scored
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.

Selected snapshot

Stars

1,543

Forks

50

Change 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 haystack command-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.