ioBroker.googlefindmydevice GitHub

läuft im Daemon-Modus, Poll alle 15 Minuten

Wo ist mein Tracker? Als ioBroker-States.

iobroker.googlefindmydevice liest Standorte deiner Bluetooth-Tracker (getestet mit Chipolo, UGREEN und Maginon – alles im Google "Find My Device"-Netzwerk) aus Googles Find Hub aus und stellt sie als States bereit – bereit für eigene Automatisierungen, Karten-Dashboards und Benachrichtigungen.

GPL-3.0-Lizenz Open Source Kein Passwort wird gespeichert
Admin › Objekte › googlefindmydevice.0
<id>.name "Fahrrad Keller"
<id>.latitude 50.9412
<id>.semanticLocation "Zuhause"
<id>.lastSeen 2026-09-19T08:14:02
<id>.mapsLink maps.google.com/…
info.connection true

Unterstützt werden Bluetooth-Tracker aus dem Google "Find My Device"-Netzwerk (getestet mit Chipolo ONE Point, Maginon Smart Tag Duo und UGREEN FineTrack G). Kopfhörer und Lautsprecher mit Find-Hub-Schlüssel (getestet: Soundcore P40i, JBL Clip 5) werden ebenfalls aufgelistet, melden Standorte aber meist nur beim Verbinden und Trennen. Telefone, Tablets und andere Geräte am selben Google-Konto werden bewusst nicht unterstützt: Google liefert deren Standort über ein komplett anderes System (volle Browser-Session statt schmal berechtigtem Geräte-Token), dessen Sicherheitsrisiko in keinem Verhältnis zum Nutzen steht – dafür bleibt Googles eigene App die richtige Wahl. Unabhängiges Community-Projekt, keine Verbindung zu Google.

Zur Einordnung: Standorte entstehen dadurch, dass fremde Android-Handys in der Nähe einen Tracker hören und den Standort verschlüsselt hochladen. Meldungen kommen unregelmäßig, teils erst nach Minuten oder Stunden, und abseits von Menschen seltener. Für Verfolgung in Echtzeit oder Diebstahlschutz ist das Netz nicht geeignet.

Was der Adapter liefert

Alles, was Find Hub über einen Tracker weiß

Standort

Breiten-/Längengrad, Höhe, Genauigkeit und Zeitpunkt der letzten Meldung – sowie ein fertiger Google-Maps-Link zum direkten Öffnen.

Semantischer Ort

Wo verfügbar zusätzlich als Klartext (z. B. "Zuhause"), nicht nur als Koordinate.

Geräte-Infos

Hersteller, Modell, Fast-Pair-ID, Gerätetyp und Kopplungsdatum werden bei jedem Abgleich aktuell gehalten.

Eigene vs. fremde Meldung

isOwnReport zeigt, ob der Standort direkt vom Tracker kam oder über ein fremdes Gerät in der Nähe gemeldet wurde.

"Jetzt orten"

Aktive Standortanfrage pro Tracker, einzeln aktivierbar mit eigenem Intervall – da jede Anfrage spürbar Akku des Trackers kostet, standardmäßig aus.

Sharing-Info

Anzahl der Personen, mit denen ein Tracker geteilt ist – praktisch, um vergessene Freigaben zu bemerken.

Objekte

Der State-Baum

Jeder gefundene Tracker ist ein eigenes Gerät direkt unter der Instanz: googlefindmydevice.0.<id> – durchsuchbar, typisiert, nutzbar in Skripten, Blockly, Node-RED oder einem eigenen vis-Dashboard.

Alle Objektnamen liegen in 11 Sprachen vor (Admin-UI übernimmt automatisch die passende).

Update von 0.0.7 oder älter: Die Tracker lagen früher unter googlefindmydevice.0.devices.<id>. Der alte Ordner wird beim ersten Start automatisch entfernt – Skripte, Visualisierungen und Aliase mit den alten IDs müssen angepasst werden.

googlefindmydevice.0.info.connection         boolean
googlefindmydevice.0.<id>.name               string
googlefindmydevice.0.<id>.manufacturer       string
googlefindmydevice.0.<id>.model              string
googlefindmydevice.0.<id>.fastPairModelId    string
googlefindmydevice.0.<id>.deviceType         string
googlefindmydevice.0.<id>.pairDate           number  # Zeitstempel (ms)
googlefindmydevice.0.<id>.sharedWithCount    number
googlefindmydevice.0.<id>.latitude           number
googlefindmydevice.0.<id>.longitude          number
googlefindmydevice.0.<id>.altitude           number  # Meter
googlefindmydevice.0.<id>.accuracy           number  # Meter
googlefindmydevice.0.<id>.lastSeen           number  # Zeitstempel (ms)
googlefindmydevice.0.<id>.semanticLocation   string
googlefindmydevice.0.<id>.isOwnReport        boolean
googlefindmydevice.0.<id>.mapsLink           string # fertiger Google-Maps-Link

Login ohne Passwort im Adapter

Geführte Einrichtung in zwei Teilen

Die Einrichtung läuft komplett auf der Konfigurationsseite der Instanz in ioBroker Admin – ohne Zusatzprogramm. Der Adapter fragt nie nach deinem Google-Passwort. Stattdessen kopierst du Werte aus deinem eigenen Browser, genau wie einen API-Key von einem x-beliebigen Web-Dashboard. Die Seite zeigt immer nur den Teil, der noch fehlt. Wichtig: Die Instanz zuerst starten (Play-Button), sonst sind die Buttons nicht klickbar.

  1. 1 Teil 1 – Konto verbinden: Die Google-Anmeldeseite öffnen, anmelden und das oauth_token-Cookie aus den Entwicklertools kopieren, in die Konfiguration einfügen und auf Verbinden klicken. Dieser Teil sollte zügig gehen, denn das Cookie läuft nach kurzer Zeit ab.
  2. 2 Teil 2 – Standorte freischalten: Ein Button öffnet Googles Freischalt-Seite, ein weiterer zeigt ein kleines Skript zum Kopieren für die Browser-Konsole. Das Ergebnis fügst du ein und klickst auf Prüfen und freischalten. Hier gibt es keinen Zeitdruck.

Eine falsche oder abgelaufene Eingabe wird sofort auf der Seite gemeldet, nicht erst im Log. Das eingefügte Cookie wird nach dem Verbinden wieder gelöscht, der Adapter speichert nur einen langlebigen Konto-Token (verschlüsselt). Warum keine automatisierte Anmeldung? Google erkennt und blockiert automatisierte Browser (Puppeteer) zuverlässig als "unsicher" – die Umgehung dafür wäre Bot-Erkennungs-Evasion, die dieses Projekt bewusst nicht einsetzt.

// Teil 1: DevTools -> Application -> Cookies -> accounts.google.com
oauth_token  1//09xxxxxxxxxxxx...
// -> in die Konfiguration einfügen, [Verbinden]

// Teil 2: Browser-Konsole auf der von der Konfiguration geöffneten Seite:
allow pasting
// -> Skript aus der Konfiguration einfügen, Enter
// -> Ergebnis-Feld erscheint oben auf der Seite
// -> in die Konfiguration einfügen, [Prüfen und freischalten]

Loslegen

Installation

Empfohlen

Über Admin (Latest-Repository)

Der Adapter ist im offiziellen Latest-Repository gelistet. In Admin unter Adapter oben als Repository Latest auswählen (Standard ist „Stable“, dort ist er noch nicht enthalten), nach googlefindmydevice suchen, installieren und eine Instanz anlegen.

Manuell per npm

npm install iobroker.googlefindmydevice

Im ioBroker-Datenverzeichnis ausführen, danach die Instanz über Admin anlegen.

Aktueller Entwicklungsstand von GitHub

Nur für Tester: In Admin unter Adapter das kleine Wolken-Symbol neben der Suche anklicken (benutzerdefinierte Installation) und eintragen:

beabel/ioBroker.googlefindmydevice

Voraussetzungen: Node.js ≥ 22, js-controller ≥ 6.0.11, Admin ≥ 7.8.23.

Nach dem Anlegen die Instanz starten (neue Instanzen sind zunächst deaktiviert) und dann die Einrichtung auf der Konfigurationsseite durchlaufen. Bis dahin meldet sie im Log nur "Not set up yet" – das ist normal.

Kontakt

Fragen oder Feedback?

Bug gefunden, Feature-Wunsch oder eine Frage zur Konfiguration – kurze Nachricht reicht.