{"id":27357448,"url":"https://github.com/parawanderer/opentagviewer","last_synced_at":"2025-04-12T23:50:10.404Z","repository":{"id":282982015,"uuid":"950297516","full_name":"parawanderer/OpenTagViewer","owner":"parawanderer","description":"Track AirTags on Android","archived":false,"fork":false,"pushed_at":"2025-04-11T20:03:38.000Z","size":5225,"stargazers_count":16,"open_issues_count":3,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T23:50:02.251Z","etag":null,"topics":["android","android-app","chaquopy","macos-app","tkinter-gui","wiki"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/parawanderer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-18T00:11:10.000Z","updated_at":"2025-04-12T09:06:32.000Z","dependencies_parsed_at":"2025-03-18T01:37:48.778Z","dependency_job_id":null,"html_url":"https://github.com/parawanderer/OpenTagViewer","commit_stats":null,"previous_names":["parawanderer/opentagviewer"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parawanderer%2FOpenTagViewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parawanderer%2FOpenTagViewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parawanderer%2FOpenTagViewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/parawanderer%2FOpenTagViewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/parawanderer","download_url":"https://codeload.github.com/parawanderer/OpenTagViewer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647252,"owners_count":21139081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-app","chaquopy","macos-app","tkinter-gui","wiki"],"created_at":"2025-04-12T23:50:09.670Z","updated_at":"2025-04-12T23:50:10.377Z","avatar_url":"https://github.com/parawanderer.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![opentagviewer_banner](https://github.com/user-attachments/assets/f26dfbc3-92d7-4af0-950f-e9446c7fb6b9)\n\n\u003ch1\u003e\n   \u003cimg src=\"./opentagviewer_icon_xs.png\"/\u003e OpenTagViewer\n\u003c/h1\u003e\n\nApparently, this is the first **\u003cimg src=\"https://github.com/user-attachments/assets/aa0531f6-6a5e-4c9f-b3c4-dfc3899c8a49\" width=\"20\"/\u003e Android App** to allow you to view/track your **\u003cimg src=\"https://github.com/user-attachments/assets/fa3b912f-d204-4252-9449-465eb62f128c\" height=\"20\"/\u003e official Apple AirTags**.\n\nI made this because I couldn't find any app or webpage that lets me do this\n\u003cbr\u003e\n\u003cbr\u003e\n\nThis project is a relatively polished looking Android/Java UI-wrapper around the Python [FindMy.py](https://github.com/malmeloo/FindMy.py) library, which is a derivative of the [openhaystack](https://github.com/seemoo-lab/openhaystack) project.\n\n\u003cbr\u003e\n\n\u003e [!WARNING]  \n\u003e This project is not afilliated with Apple Inc. or Android/Google LLC in any capacity\n\n\n|Video Demo|Demo: ☀️ Light Mode|Demo: 🌑 Dark Mode|\n|----|----|----|\n| \u003cvideo src=\"https://github.com/user-attachments/assets/d3857480-4ef0-48a9-ab63-8d8c15fd5314\"\u003e |![Demo of the app while using Light Mode](./light_mode_preview.jpg)|![Demo of the app while using Dark Mode](./dark_mode_preview.jpg)|\n\n\n(No, the location history in this demo isn't real)\n\n## Features ⭐\n\n- View current \"live\" location of your AirTags **on Android**\n- Track \u0026 (automatically) save historical location history of your AirTags (a feature notably missing from the iOS FindMy apps!)\n- UI customisation options\n\n\n## How To Use 📖\n\n### Requirements 🤓\n\n1. An Android phone with [the `OpenTagViewer` app installed](https://github.com/parawanderer/OpenTagViewer/wiki/How-To:-Install-App)\n2. A (free) [Apple Account](https://account.apple.com/) with 2FA enabled to be via either `SMS` or `Trusted Device`\n3. One or more **AirTags**, which need to be already registered to some Apple account via the `FindMy` app\n4. A Mac or a [MacOS Virtual Machine](https://github.com/parawanderer/OpenTagViewer/wiki/How-To:-Export-AirTags-From-Mac#prerequisites) of MacOS version `Sonoma (14)` or lower (only needed once/initially)\n\n\n### How to view my AirTag on my Android Phone?!\n\nSee [📖 wiki](https://github.com/parawanderer/OpenTagViewer/wiki) for more details:\n\n1. [Install the app](https://github.com/parawanderer/OpenTagViewer/wiki/How-To:-Install-App) and log in to your Apple Account\n2. Create an export `.zip` file by following [this wiki guide](https://github.com/parawanderer/OpenTagViewer/wiki/How-To:-Export-AirTags-From-Mac#opentagviewer-macos-export-app--recommended)\n3. Import the `.zip` file in the app\n4. Profit: you can now track your AirTags on your Android Phone indefinitely!\n\n-------------\n\n## Contributing\n\nContributions/MRs are more than welcome.\n\nPlenty 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.\nPlenty of best practices haven't been followed, e.g. in the Testing \u0026 CI/CD setup.\n\n**I think it would be nice if the app could support the following features:**\n\n- [`🔴 BLOCKED due to 🐛Bug`](https://github.com/malmeloo/FindMy.py/issues/118) Locate Nearby AirTags using Low-Power Bluetooth \u0026 display the latest update in that case\n- [`🔴 BLOCKED by 🙏Feature Request`](https://github.com/malmeloo/FindMy.py/issues/88) \"Ring\"/\"Make Noise\" button\n- `🟡 Doable` Support showing unofficial \"AirTags\" created using [openhaystack](https://github.com/seemoo-lab/openhaystack)\n- `🟠 Doable with enough effort` Integrate with projects that query **Google**'s/**Samsung**'s network and also show these in the same UI:\n   - See [thread](https://github.com/malmeloo/FindMy.py/discussions/30), [thread](https://github.com/seemoo-lab/openhaystack/discussions/210) and repo [GoogleFindMyTools](https://github.com/leonboe1/GoogleFindMyTools). TL;DR: I think this (these two?) are separate projects with their own repos.\n- `🟢 Easy` If you'd like to contribute a Language or make corrections in my Translations, feel free to do that too\n    - Current list of languages can be found back [here](./app/src/main/res/xml/locales_config.xml), translation files can be found back at paths like [`./app/src/main/res/values-en/strings.xml`](./app/src/main/res/values-en/strings.xml) (replace `values-en` with `values-\u003cyour locale\u003e`)\n\n### Credits\n\n- [UI Icons](https://fonts.google.com/icons?icon.query=warn\u0026icon.set=Material+Icons) by Google\n- [Material theme 3 library](https://github.com/material-components/material-components-android) + [colours](http://material-foundation.github.io?primary=%23F4FEFF\u0026bodyFont=Nunito\u0026displayFont=Nunito+Sans\u0026colorMatch=false) by Google\n\n\n### License: MIT\n\nDo with it whatever you like, I don't really care :P\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparawanderer%2Fopentagviewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparawanderer%2Fopentagviewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparawanderer%2Fopentagviewer/lists"}