# leonboe1/GoogleFindMyTools

Framework for tracking and building your own Google Find My Device / Find Hub trackers 🧭

Repository: https://github.com/leonboe1/GoogleFindMyTools
Canonical: https://ross.abutalabs.com/products/googlefindmytools
Language: Python
License: GPL-3.0
License Family: copyleft
Last push: 2026-05-05T17:22:27+00:00

## Health v2 (maintenance only)
Score: 58/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 80, release rhythm 35, longevity 47
- inputs: {"age_days": 665, "days_push": 120, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1153, forks 145 (observed 2026-08-28T04:03:47.336220+00:00)

## What it is
A Python framework that reimplements parts of Google's Find My Device (Find Hub) network, allowing users to query trackers and Android devices, decrypt their end-to-end encrypted location reports, and register custom ESP32- or Zephyr-based trackers. It includes firmware for building your own Find My Device-compatible trackers.

## Use cases
- locate my Google Find My Device tracker from a computer
- decrypt encrypted location reports from the Find Hub network
- build my own ESP32 tracker compatible with Google's Find My Device network
- read out E2EE keys from my Find My Device account
- register a custom Zephyr-based tracker with Google's network
- track lost Android devices outside the official app

## When to choose
- you want to query or decrypt locations from Google's Find My Device network programmatically
- you want to build a DIY tracker using ESP32 or Zephyr hardware
- you need headless access to Find My Device locations without the Android app

## When to avoid
- you need a polished, production-ready tracking solution
- you run ARM Linux and need the full authentication flow
- you want to track devices without setting up Find My Device on an Android phone first
- you need support for P-256 curve trackers like Sony WH1000XM5 headphones

## Facets
- artifact type: framework
- maturity: experimental
- function: security, cryptography, sdk, developer-tools, embedded
- domain: security, privacy, embedded-systems, developer-tools, hardware
- platform: python, windows, embedded
- tags: find-my-device, find-hub, tracker, esp32, zephyr, e2ee, location-tracking, reverse-engineering, google-network, linux, macos

## Member repositories
- leonboe1/GoogleFindMyTools (main) score 58

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:47.336220+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:33:28.667474+00:00, confidence not recorded.
  - readme: https://github.com/leonboe1/GoogleFindMyTools (fetched 2026-08-28T04:03:47.336220+00:00, sha d9171ba9bc41)
- Data as of 2026-08-30T08:39:29.467469+00:00.