English · Polski
Unofficial native iOS client for Google Find Hub trackers — map, history, places and Bluetooth ringing, fully on-device.
Not affiliated with Google. Licensed under GPLv3.
Important
Tagpin is an independent, unofficial project. It is not affiliated with, endorsed or supported by Google LLC, Motorola or Apple Inc. Google does not offer a public Find Hub API; this app talks to Google services the way the reverse-engineered GoogleFindMyTools project does. Google may change or block this at any time, and use of an unofficial client may conflict with Google's terms. Use it at your own risk.
Tagpin lets iPhone users see the Find Hub tags (for example Motorola moto tag) that were already paired on an Android phone with their Google account.
- Map of your tags and your own position, with clustering, report time, accuracy and distance.
- Locate a tag through the Find Hub network; reports are decrypted on the iPhone (AES-GCM / SECP160r1 + AES-EAX).
- 7-day local history with honest gaps (no fabricated route points).
- Places: home, work and other zones, with local alerts when fresh reports confirm a tag left a zone.
- Ring the nearest tag via Bluetooth using the standard DULT non-owner sound.
- Bluetooth separation alerts after a confirmed connection to a tag.
- Notification settings: turn place and separation alerts on or off, hide names on the lock screen, send a test notification.
- Custom names, icons, photos and notes, multiple Google accounts, light and dark mode.
- Delete this account's data from the phone in Settings.
- Demo mode on the sign-in screen: every screen with sample data, without a Google account and without contacting Google or any tracker.
- No pairing of new tags (pair on Android first), no UWB precision finding, no battery level.
- Reports can be delayed; background work and alerts depend on iOS and are not guaranteed.
- iOS 17 or later, iPhone only.
There is no server operated by this project. Tokens and encryption keys stay in the iPhone Keychain. History, places and notes are stored locally and excluded from device backups; custom device names, icons and photos are stored in regular app storage. The app contacts Google (sign-in, device list, location reports) and Apple (MapKit) only to provide its features. Nothing is sent to mintstudio.
| Document | English | Polski |
|---|---|---|
| Privacy policy | privacy-policy.md | polityka-prywatnosci.md |
| Terms of use | terms-of-use.md | warunki-korzystania.md |
| Licences and acknowledgements | ACKNOWLEDGEMENTS-en.txt | ACKNOWLEDGEMENTS-pl.txt |
| Licence overview | Legal/README.md | Legal/README.pl.md |
All documents ship inside the app (Settings → Legal information) and must be accepted before signing in. The app shows the Polish versions when it runs in Polish and the English versions in every other language; if versions differ, the Polish one prevails to the extent permitted by law. In short: the app is free GPLv3 software provided without warranty; use it only with your own Google account and devices, never to track other people; mintstudio receives no personal data.
The interface is available in English, Polish, German, French, Spanish and Italian and follows the iPhone’s language settings. Other languages fall back to English. Translations live in App/Resources/Localizable.xcstrings; corrections by native speakers are welcome.
- AltStore PAL (EU): planned. The app is not yet notarized; this section will link the AltStore source once it is published.
- Not on the App Store: Apple requires permission from the third-party service (guideline 5.2.2), which Google does not provide for Find Hub.
Requires Xcode 26+ and XcodeGen.
cp App/Config/Local.xcconfig.example App/Config/Local.xcconfig # set your DEVELOPMENT_TEAM
xcodegen generate --spec App/project.yml
open "App/Tagpin.xcodeproj"
bash Scripts/check_local.sh # offline regression tests, no account or networkTagpin stands on the work of these projects. Full licence texts are in ACKNOWLEDGEMENTS-en.txt (Polish) and are shown in the app under Settings → Licences and source code.
| Project | Authors | License | Version | Used for |
|---|---|---|---|---|
| GoogleFindMyTools | Leon Böttger (SEEMOO, TU Darmstadt) | GPL-3.0 | d46e952 (2026-05-05) |
Protocol definitions and the ported auth, Nova, Spot, key and report-decryption logic |
| firebase-messaging | Matthieu Lemoine, Steven Beth | MIT | GoogleFindMyTools d46e952 |
FCM registration and MCS push connection (ported) |
| gpsoauth | Simon Weber | MIT | 2.0.0 | Google account token exchange (ported) |
| encrypted-content-encoding | Martin Thomson | MIT | 1.2.1 | Web Push aesgcm decryption (ported) |
| micro-ecc | Kenneth MacKay | BSD-2-Clause | 541b3a7 (2024-11-14) |
SECP160r1 elliptic-curve operations (bundled) |
| Chromium | The Chromium Authors | BSD-3-Clause | main |
Checkin and MCS protobuf definitions |
| SwiftProtobuf | Apple Inc. and contributors | Apache-2.0 | 1.38.1 | Protobuf runtime (Swift Package) |
All links point to the original upstream repositories. Versions are the exact revisions this app was ported from or bundles; micro-ecc files were verified byte-for-byte (SHA-256) against upstream.
References: Find Hub Network Accessory Specification, IETF DULT, Material Design 3.
If you use this work academically, please also cite GoogleFindMyTools as described in its CITATION.cff.
Copyright © 2026 mintstudio Jakub Koncewicz.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License v3.0 or (at your option) any later version. See LICENSE and NOTICE. Project planning documents in docs/ are written in Polish.
Trademarks. Google, Find Hub and Android are trademarks of Google LLC. Motorola and moto tag are trademarks of Motorola Trademark Holdings, LLC. Apple and iPhone are trademarks of Apple Inc. They are used here only to describe compatibility. The mintstudio name and logo are not covered by the GPL; all rights reserved.
Issues and pull requests are welcome. Contact: kontakt@mintstudio.pl.
