OpenTagViewer

Note

This app is feature-complete as of app version 1.1.0 as far as the original author is concerned. Contributions are welcome and will be reviewed - get started through reading CONTRIBUTING.md (and optionally having your agent read AGENTS.md) which contain all details to get up and running.

This is an Android App to allow you to view/track your official Apple AirTags. It was made because Apple does not make any official app or webpage that lets you do this.

This project is a relatively polished looking Android/Java UI-wrapper around the Python FindMy.py library, which is a derivative of the openhaystack project.

Warning

This project is not affiliated with Apple Inc. or Android/Google LLC in any capacity

Video Demo	Demo: ☀️ Light Mode	Demo: 🌑 Dark Mode
app_demo_smallw.mp4

(No, the location history in this demo isn't real)

Features ⭐

• View current "live" location of your AirTags (or other FindMy devices) on Android
• Track & (automatically) save historical location history of your AirTags (a feature notably missing from the iOS FindMy apps!)
• UI customisation options

What it works with 🏷️

If it shows up under Items in Apple's own Find My app, it works.

What	Works?
AirTag	✅	What most people are here for
Third-party trackers that work with Apple Find My (Chipolo, Pebblebee, Mili MiTag, eufy and similar)	✅	Should work; reports welcome
AirPods, and other Find My accessories	✅	Works where Apple stores a usable key for it. Lightly tested
Self-made tags (OpenHaystack, Macless Haystack)	✅	Works; requires creating an export by CLI or Wizard
Your own iPhone, iPad or Mac	⚠️	Partial coverage (see issue #131)
A tag someone shared with you through Apple's own sharing	❌	Only the account that owns a tag can export it. Ask the owner to export it and send you the zip
Tile, Samsung SmartTag, Google Find My Device trackers	❌	Different networks entirely, with nothing in common with Apple's. This is an open feature request that can be contributed to the app if wanted.

Note

This app (currently) reads Apple's Find My network. Anything not on that network cannot be tracked with it, no matter how similar the device looks.

How To Use 📖

Requirements 🤓

1. An Android phone with the OpenTagViewer app installed
2. A (free) Apple Account with 2FA enabled to be via either SMS or Trusted Device
3. One or more of:
   1. AirTags;
   2. Any other "FindMy-compatible Accessory" or tracker that appears under Items in Apple's FindMy app
   3. OpenHaystack-like custom devices (see what it works with)

And then one of two routes:

1. Read them from iCloud, in the app (requires only your Android phone)
2. Export a zip on a computer, import it (requires a computer once during export)

👉 Which route should I use?

How to view my AirTag on my Android Phone?!

See 📖 wiki for more details:

1. Install the app and log in to your Apple Account, and either (or both):
   1. Use the iCloud login method (when you are the owner of official FindMy-compatible devices that show up in the official FindMy app):
      1. Follow the steps here explaining how to link your account
   2. Use the zip method:
      1. Create an export .zip file by following this wiki guide
      2. Import the .zip file in the app
2. Profit: you can now track your AirTags on your Android Phone indefinitely!

---

Contributing

This started as a "hackathony" thing thrown together ASAP and made presentable for layusers, and plenty can still be improved. Contributions/MRs are more than welcome.

To get started with the repo, see:

📋 CONTRIBUTING.md: covers getting set up (the JDK, the SDK, the Maps API key, the git hook) and how to run every test suite, as well as the CI setup.

📐 AGENTS.md: the rules a change has to satisfy migrations, Anisette, API keys, attribution. Written for automated contributors, but contains useful information for people too (best queried via a coding assistant rather than read directly).

Bluetooth and hardware

The app works without these, but they are the open questions for anyone with a tag and a Bluetooth sniffer:

• #201: playing a sound on a tag that is still near its owner
• #166: registering an AirTag without an iPhone or iPad

What is known so far is collected in docs/owner-connected-tags.md, and everything on the topic is labelled @hardware.

Credits

• UI Icons by Google
• Material theme 3 library + colours by Google

License: MIT

Do with it whatever you like, I don't really care :P