How To: Export AirTags From Mac - parawanderer/OpenTagViewer GitHub Wiki

Exporting AirTag Data from Mac

There are 2 general strategies that can be used:

  1. Use the MacOS UI Export Wizard (Recommended)
  2. 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.


Prerequisites

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)

MacOS Export Wizard (⭐ Recommended)

This is recommended simply because this process should take less work/time when using this Wizard.

You can install the app from here

Installation + Usage:

  1. 📁 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:

image

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.

image

424820923-44481118-7130-4dbd-82f7-e196afaada4d

This will prompt you to enter your password to confirm adding an exception, and then confirm in a second popup box:

424821305-0f5f3ea1-fa56-4eba-8216-50bb1477bc1f

4. 🔓 Enter your password TWICE
Afterwards, the app will launch and prompt you for your password **TWICE**

First password prompt:

image

Second password prompt:

image

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.

image

image

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.

image

Done!

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.

Extract AirTag data and create zip file Manually

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:

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

âš ī¸ **GitHub.com Fallback** âš ī¸