Skip to content

parawanderer/OpenTagViewer

Repository files navigation

opentagviewer_banner

OpenTagViewer

Apparently, this is the first Android App to allow you to view/track your official Apple AirTags.

I made this because I couldn't find any app or webpage that lets me 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 afilliated with Apple Inc. or Android/Google LLC in any capacity

Video Demo Demo: ☀️ Light Mode Demo: 🌑 Dark Mode
app_demo_smallw.mp4
Demo of the app while using Light Mode Demo of the app while using Dark Mode

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

Features ⭐

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

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 AirTags, which need to be already registered to some Apple account via the FindMy app
  4. A Mac or a MacOS Virtual Machine (only needed once/initially)

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
  2. Create an export .zip file by following this wiki guide
  3. Import the .zip file in the app
  4. Profit: you can now track your AirTags on your Android Phone indefinitely!

Contributing

Contributions/MRs are more than welcome.

Plenty of things can be improved in this project as it was mostly a "hackathony" thing I tried to throw together ASAP and make presentable for layusers. Plenty of best practices haven't been followed, e.g. in the Testing & CI/CD setup.

I think it would be nice if the app could support the following features:

  • 🔴 BLOCKED due to 🐛Bug Locate Nearby AirTags using Low-Power Bluetooth & display the latest update in that case
  • 🔴 BLOCKED by 🙏Feature Request "Ring"/"Make Noise" button
  • 🟡 Doable Support showing unofficial "AirTags" created using openhaystack
  • 🟠 Doable with enough effort Integrate with projects that query Google's/Samsung's network and also show these in the same UI:
  • 🟢 Easy If you'd like to contribute a Language or make corrections in my Translations, feel free to do that too

Credits

License: MIT

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