Skip to content

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

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

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 BeaconStore in order to export AirTags

MacOS >= 15

Home Assistant integrations

hass-FindMy

Deprecated

Other

  • findmydad
    • Python
    • Few commits, no releases
    • Based on FindMy.py