How To: Export AirTags From Mac - parawanderer/OpenTagViewer GitHub Wiki
There are 2 general strategies that can be used:
- Use the MacOS UI Export Wizard (Recommended)
- Export the tags Manually
The simplest of which is using the MacOS Export App to generate an export zip for you.
Import steps for inside of the Android App can be found back here
âšī¸ A note on why this is needed
What this process achieves is that it uses the Mac's cache files (that are stored on disk) to get access to the private key that is needed to query Apple's FindMy network for location details about the AirTag. Currently this is the best known way to get these private keys, because no public API has been made available by Apple for interacting with the FindMy network in any way (and neither has anybody reverse engineered Apple's API for obtaining these keys).
But if in the future a better means of obtaining the keys becomes available, this will be sure to be incorporated in the app to skip this rather cumbersome step.
A Mac
or MacOS VM
with Operating System version AT MOST Sonoma (14)
, where you are logged in as an Apple user who has access to your AirTags and can see them listed in the Mac FindMy app.
Check out the project sickcodes/Docker-OSX which allows you to set up a MacOS Sonoma (14)
VM for free on Windows or Linux.
OR use the manual approach and check out the "Extract AirTag data and create zip file Manually" section if you want to use MacOS 15+
.
Important
Note that only the "Owner" Apple Account of an AirTag can export that AirTag. This means you need to (temporarily is fine) log in on your MacOS as the same Apple account that was used to register the AirTags on iOS while exporting the AirTags. (See issue #6)
This is recommended simply because this process should take less work/time when using this Wizard.
You can install the app from here
- đ Download the latest available zip named
OpenTagViewer-ExportWizardMacOS-<version>.zip
2. đ Unzip and run the app (double-click the OpenTagViewer icon)
After Unzipping, locate the app with the icon:
3. â ī¸ Whitelist OpenTagViewer app
You will get a warning about the app coming from an "unknown developer"
Follow this official guide to add an exception for the app.
This will prompt you to enter your password to confirm adding an exception, and then confirm in a second popup box:
4. đ Enter your password TWICE
Afterwards, the app will launch and prompt you for your password **TWICE**
First password prompt:
Second password prompt:
5. â Choose Devices to export to Android
The app will show the list of devices that you can export to your Android device.
Select the devices you would like to export by clicking on them in the list, and click Confirm
.
6. đī¸ Save as zip file
Save the zip file somewhere, such that you can import it on your Android phone afterwards.
You can e.g. upload this file to a Cloud Storage app like Google Drive, so that you can download it from the Cloud Storage app on your Android Phone for importing purposes.
To import it in the app, see đ this wiki page.
If you'd like to share your devices with other people using this OpenTagViewer app, you can share this same .zip
with them.
Important
If you'd like to share your AirTags with other people using the OpenTagViewer
app, then you can share the same .zip
file with them -- they will be able to see all the same devices you chose to export via the app.
Ensure you only share your export .zip
with trusted people, as the export contains everything needed to permanently track your AirTags, unless you reset them.
The alternative to using the MacOS App is to compile a Zip file manually. This is the only option if you are on MacOS 15+
.
A multitude of decoder scripts are available to decode the necessary data.
Some examples:
- Repo
pajowu/beaconstorekey-extractor
forMacOS 15+
-
airtag_decryptor.py
-- the same script used by the MacOS Export Wizard (MacOS <= 14
). -
airtag-decryptor.swift
by airy10 on which the above script is based (MacOS <= 14
) -
airtag-decryptor.swift
by Matus (MacOS <= 14
)
After decrypting the files, you have to compose your own .zip
file. The steps for doing that are described in đ this wiki page
To import it in the app, see đ this wiki page