{"id":24208372,"url":"https://github.com/hybridgroup/go-haystack","last_synced_at":"2025-12-29T22:15:10.461Z","repository":{"id":271727168,"uuid":"914381428","full_name":"hybridgroup/go-haystack","owner":"hybridgroup","description":"CLI tools for OpenHaystack written in Go","archived":false,"fork":false,"pushed_at":"2025-01-09T14:54:52.000Z","size":1,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-01-09T14:56:26.359Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hybridgroup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-09T13:40:45.000Z","updated_at":"2025-01-09T14:54:55.000Z","dependencies_parsed_at":"2025-01-09T14:56:30.058Z","dependency_job_id":"fff8af5c-00dc-4205-b53a-a6c4448c9645","html_url":"https://github.com/hybridgroup/go-haystack","commit_stats":null,"previous_names":["hybridgroup/go-haystack"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hybridgroup%2Fgo-haystack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hybridgroup%2Fgo-haystack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hybridgroup%2Fgo-haystack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hybridgroup%2Fgo-haystack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hybridgroup","download_url":"https://codeload.github.com/hybridgroup/go-haystack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":233828159,"owners_count":18736581,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-14T01:01:56.309Z","updated_at":"2025-09-22T06:31:31.382Z","avatar_url":"https://github.com/hybridgroup.png","language":"Go","funding_links":[],"categories":["Wireless Communication","Go"],"sub_categories":["WASI and WASM Unknown"],"readme":"# go-haystack\n\n![Go Haystack gopher](./images/go-haystack.png)\n\nGo Haystack lets you track personal Bluetooth devices via Apple's massive [\"Find My\"](https://developer.apple.com/find-my/) network.\n\nIt uses [OpenHaystack](https://github.com/seemoo-lab/openhaystack) together with [Macless-Haystack](https://github.com/dchristl/macless-haystack) to help you setup a custom FindMy network with tools written in Go/TinyGo. No Apple hardware required!\n\n![image of macless-haystack web UI](./images/macless-haystack.png)\n\n## Build Your Own Beacon\n\nThis package provides firmware written using [TinyGo](https://tinygo.org/) and the [TinyGo Bluetooth package](https://github.com/tinygo-org/bluetooth).\n\n![tinygo beacons](./images/tinygo-beacons.jpg)\n\nAs a result, any of the following hardware devices should work:\n\n- [Adafruit Bluefruit boards using nRF SoftDevice](https://github.com/tinygo-org/bluetooth?tab=readme-ov-file#adafruit-bluefruit-boards)\n- [BBC Microbit using nRF SoftDevice](https://github.com/tinygo-org/bluetooth?tab=readme-ov-file#bbc-microbit)\n- [Seeed Studio XIAO nRF52840](https://wiki.seeedstudio.com/XIAO_BLE)\n- [Other Nordic Semi SoftDevice boards](https://github.com/tinygo-org/bluetooth?tab=readme-ov-file#flashing-the-softdevice-on-other-boards)\n- [Boards using the NINA-FW with an ESP32 co-processor](https://github.com/tinygo-org/bluetooth?tab=readme-ov-file#esp32-nina)\n- [Boards such as the RP2040 Pico-W using the CYW43439 co-processor](https://github.com/tinygo-org/bluetooth?tab=readme-ov-file#cyw43439-rp2040-w)\n\nThe beacon code is located in this repository in the [firmware](./firmware/) directory.\n\n## Linux Beacons\n\nYou can also run the beacon code on any Linux that has Bluetooth hardware, such as a Raspberry Pi or other embedded system.\n\nThe beacon code is the same for embedded Linux as for microcontrollers, and is located in this repo in the [firmware](./firmware/) directory.\n\n## TinyScan\n\nGo Haystack also includes TinyScan, a hardware scanner for local devices.\n\n![tinyscan](./images/tinyscan.gif)\n\nTinyScan runs on several different microcontrollers boards with Bluetooth and miniature displays, such as those made by [Adafruit](https://www.adafruit.com/) and [Pimoroni](https://shop.pimoroni.com/)\n\nThe TinyScan code is located in the [tinyscan](./tinyscan/) directory in this repository.\n\n## How to install\n\n### Apple ID\n\nYou must have an Apple-ID with 2FA enabled. Only sms/text message as second factor is supported!\n\n### anisette-v3-server\n\nStart [`anisette-v3-server`](https://github.com/Dadoum/anisette-v3-server)\n\n```bash\ndocker network create mh-network\ndocker run -d --restart always --name anisette -p 6969:6969 --volume anisette-v3_data:/home/Alcoholic/.config/anisette-v3 --network mh-network dadoum/anisette-v3-server\n```\n\n### macless-haystack\n\n1. Start and set up your Macless Haystack endpoint in interactive mode:\n\n```bash\ndocker run -it --restart unless-stopped --name macless-haystack -p 6176:6176 --volume mh_data:/app/endpoint/data --network mh-network christld/macless-haystack\n```\n\n###### You will be asked for your Apple-ID, password and your 2FA. If you see `serving at port 6176 over HTTP` you have all set up correctly\n\nHit ctrl-C to exit the process once it has been configured.\n\n2. Restart the macless-haystack server\n\n```bash\ndocker restart macless-haystack\n```\n\nSee https://github.com/dchristl/macless-haystack/blob/main/README.md#server-setup for the original instructions.\n\n### go-haystack\n\nInstall the go-haystack command line tool\n\n```shell\ngo install github.com/hybridgroup/go-haystack/cmd/haystack@latest\n```\n\n## How to use\n\n### Scanning for local devices\n\n```shell\nhaystack scan\n```\n\nShould return any local devices within range:\n\n```shell\n$ haystack scan                                                                                                             \nCE:8B:AD:5F:8A:02 -53 ce8bad5f8a0271538ff5afda87498cb067e9a020d6e4167801d55d83 - battery full\nFE:B0:67:9B:9A:5C -55 feb0679b9a5c55b1141c5cc6c8f65224ae9bc6bc2d998ccf5c56a02d - battery full\nCE:8B:AD:5F:8A:02 -53 ce8bad5f8a0271538ff5afda87498cb067e9a020d6e4167801d55d83 - battery full\nCE:8B:AD:5F:8A:02 -53 ce8bad5f8a0271538ff5afda87498cb067e9a020d6e4167801d55d83 - battery full\nFE:B0:67:9B:9A:5C -56 feb0679b9a5c55b1141c5cc6c8f65224ae9bc6bc2d998ccf5c56a02d - battery full\nCE:8B:AD:5F:8A:02 -53 ce8bad5f8a0271538ff5afda87498cb067e9a020d6e4167801d55d83 - battery full\nFE:B0:67:9B:9A:5C -56 feb0679b9a5c55b1141c5cc6c8f65224ae9bc6bc2d998ccf5c56a02d - battery full\nCE:8B:AD:5F:8A:02 -53 ce8bad5f8a0271538ff5afda87498cb067e9a020d6e4167801d55d83 - battery full\n```\n\n### Adding a new device\n\n1. Generate keys for a device\n\n```shell\nhaystack keys DEVICENAME\n```\n\nThe keys will be saved in a file named `DEVICENAME.keys` and the configuration file for Haystack will be saved in `DEVICENAME.json`. Replace \"DEVICENAME\" with whatever you want to name the actual device.\n\n\n2. Flash the hardware with the TinyGo target and the name of your device.\n\nFor example:\n\n```shell\nhaystack flash DEVICENAME nano-rp2040\n```\n\nThis will use TinyGo to compile the firmware using your keys, and then flash it to the device. See [https://tinygo.org/getting-started/overview/](https://tinygo.org/getting-started/overview/) for more information about TinyGo.\n\n\n3. Upload the JSON file for that device to your running instance of `macless-haystack` using the web UI.\n\nPoint your web browser to [`https://dchristl.github.io/macless-haystack/`](https://dchristl.github.io/macless-haystack/) which is a single-page web application that only reads/writes local data. Click on the link for \"Accessories\", then on the \"+\" button. Choose the `DEVICENAME.json` file for your device.\n\nThat's it, your device is now setup.\n\n## Objects in your data may be closer than they appear\n\nEventually, if your device is in range of any iPhone, they will appear in your Macless-Haystack data in the web UI.\n\nNote that it might take a while for the first data to show up.\n\nHave fun, be good!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhybridgroup%2Fgo-haystack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhybridgroup%2Fgo-haystack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhybridgroup%2Fgo-haystack/lists"}