Find my
Air tags
- AirTag - Tech Specs
- Requirements:
- iPhone and iPod touch models with iOS 14.5 or later
- iPad models with iPadOS 14.5 or later
- Precision Finding is compatible with iPhone 11 models and later, excluding iPhone SE (2nd and 3rd generation) and iPhone 16e.
- iOS 14 supported devices
3rd party software
FindMy.py
Query Apple's FindMy Network with Python
- GitHub
- Docs
- Discord Chat
- Recent releases
- Derivative of the discontinued openhaystack project
- MacOS Accessory Dumping Compatibility:
- MacOS 14 works !
- Official AirTag support as of v0.9.0 (2025-09-23)
Install
Preriquisites on MacOS 14:
- Python
- Pip
brew install uv
git clone https://github.com/malmeloo/FindMy.py
cd FindMy.py
python3 -m venv .venv
source .venv/bin/activate
uv sync
Usage
Fetching device locations on MacOS 14 (beware this must be done in graphical mode since the OS asks for the keystore password):
python3 -m findmy decrypt --out-dir accessories/
Then copy over the accessory json to another machine (i.e the one that runs a cronjob to fetch location data). On this machine:
python3 ./examples/airtag.py accessories/xxx.json
First time it logs in to your apple account, and stores the session data in account.json.
On subsequent runs, the cached session is used.
Issues:
OpenTagViewer
- GitHub
- Android app for air tags
- Recent releases
- Not in F-Droid, nor in Google play store, installation only via GitHub releases
- Based on
FindMy.py - Wiki/Docs
- Install
- Mac or Mac VM is needed only once on setup
Issues
OpenTagViewer MacOS AirTag Exporter
Conclusion: Didn't work on MacOS 15, use MacOS 14 !
MacOS <= 14
- Use Simple GUI Application for exporting Apple AirTags to a .zip file that can be imported into the OpenTagViewer app.
- Install via GitHub releases
- See macos.md for solution when the downloaded app is quarantined
- Allow access to the keystore for
BeaconStorein order to export AirTags
MacOS >= 15
- See MacOS Sequoia (15)+ support
- Wiki: Extract AirTag data and create zip file Manually
- beaconstorekey-extractor
- Not work on macOs 15.5
- Also doesn't work on a fresh
15.6.1docker-osx install (error: the specified item could not be found in the keychain.)
- Also doesn't work on a fresh
- The specified item could not be found in the keychain
- See macos.md how to install
xcodeand create a developer certificate
- See macos.md how to install
- Not work on macOs 15.5
Home Assistant integrations
hass-FindMy
- GitHub
- Based on and from the author of
FindMy.py - Custom Home Assistant integration for Apple's FindMy network
- "Currently, only "static" (default OpenHaystack) trackers are supported. Support for official AirTags and other devices/accessories will come soon."
Deprecated
- home-assistant-findmy
- Last release 2023-11
Other
- findmydad
- Python
- Few commits, no releases
- Based on
FindMy.py