Home - parawanderer/OpenTagViewer GitHub Wiki

opentagviewer_banner

Welcome to the OpenTagViewer wiki!

This wiki contains a summary of some good-to-know information when it comes to using the OpenTagViewer Android app.

Prerequisites πŸ€“

To use the app at this point in time, you're going to need:

Android phone with OpenTagViewer app installed

πŸ‘‰ You can find back installation instructions here

A (free) Apple Account with 2FA enabled either via SMS or Trusted Device
⚠️ Note that other 2FA authentication modes are not currently supported.

You may choose to create a "throwaway" Apple account for this purpose as well. However note that:

  • You need to use this same Apple account while registering the AirTags from an iOS device, making this account the "Owner" (see issue #6)
  • You can still share the AirTags to (your) other Apple accounts using the "Share this Device" feature in any of the official FindMy apps
  • The Apple account you choose to use must be the account that you will use on the MacOS machine while exporting the tags (you could log in to the account temporarily).
One or more AirTags, which need to already be registered with Apple via the iOS FindMy app
  • β˜‘οΈ Non-Apple produced tags are supported -- anything that is officially supported by FindMy is supported
  • Currently registration of AirTags requires somebody to have an iOS device (i.e. iPad or iPhone) to register them with Apple
  • This iOS device is only needed once during AirTag registration
  • You need to plan the currently logged in account on the iOS device carefully (you may choose to switch to another account after the initial registration)!
  • You will need to log in to the same Apple account you used to register them later (issue #6)
  • You can still share your AirTags with (your) other Apple accounts via the FindMy app -- this works as it would usually with Apple devices
  • If you want to share your AirTags with other Android/OpenTagViewer users, you will need to share your "export zip" with them (see below)
A Mac or MacOS/OSX Virtual Machine
  • Check out the project: sickcodes/Docker-OSX, which allows you to set up a MacOS Sonoma (14) VM for free
  • This Mac is only needed once* to export details about the AirTags for import into the Android App (unless you decouple/reset and re-register the AirTags. Then you will have to complete this process over. This would be an intentional action you take via the FindMy app on an iOS or MacOS device)

How to set everything up πŸƒ

1. Install the OpenTagViewer Android app on your phone πŸ“²

πŸ‘‰ You can find back installation instructions here

2. Choose an Anisette Server (you can change this later) πŸ›œ

πŸ‘‰ If you want to set up your own custom Anisette server, see πŸ“–this wiki page

3. Log in to your Apple Account in the app 🍎

You will likely be prompted to enter your 2FA code the first time you connect to the chosen Anisette server.

Only SMS and Trusted Device authentication is currently available.

4. Generate an export .zip file by using the MacOS Exporter Tool πŸ§‘β€πŸ’»
πŸ‘‰ How to do this is explained in πŸ“– this wiki page
5. Import the .zip file in the OpenTagViewer UI πŸ“
πŸ‘‰ The process of importing the .zip is explained in πŸ“– this wiki page
6. Profit! πŸ†
You will now be able to track your AirTags on your Android phone indefinitely! πŸŽ‰πŸŽ‰

πŸ†˜ In cases of issues or bugs, feel free to open an Issue on this page

⚠️ **GitHub.com Fallback** ⚠️