Apple Device Tracker Smart-Home-Integration, kostenlos und Open Source

Orte deine Apple-Geräte mit „Wo ist?“ und nutze sie als Anwesenheitssensoren.

• Veröffentlicht von prohand
• Geräte
• Version 2.5.1
• Erfordert Gladys >=5.2.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Diese Integration meldet sich bei deinem iCloud-Account an, liest die Position der Geräte, die in „Wo ist?“ sichtbar sind, und stellt sie in Gladys als Anwesenheitssensoren bereit. Damit kannst du Szenen auslösen wie „mein iPhone kommt nach Hause“ oder „niemand ist mehr da“.

Was du bekommst

Ein Gladys-Gerät pro Gerät, das in „Wo ist?“ auf iCloud.com sichtbar ist (iPhone, iPad, Mac, Apple Watch und die AirPods, die Apple dort auflistet), mit diesen Messwerten:

Messwert	Typ	Wozu er dient
Anwesenheit	Binär	Der Szenen-Auslöser (1 = zu Hause)
Entfernung vom Zuhause	Dezimal (km)	Verfolgen, wie weit du entfernt bist, das Haus vorheizen
Positionsgenauigkeit	Ganzzahl (m)	Eine GPS-Ortung von einer WLAN-Schätzung unterscheiden
Position	Text	„Breitengrad,Längengrad“, praktisch bei der Fehlersuche
Alter der Position	Ganzzahl (min)	Ein Gerät erkennen, das keine Position mehr meldet
Akku	Ganzzahl (%)	Bei niedrigem Akkustand warnen
Wird geladen	Binär	Wissen, ob das Gerät am Strom hängt
Klingeln	Taste	Spielt den Ton von „Wo ist?“ auf diesem Gerät ab

Akku und Ladezustand erscheinen nur bei Geräten, die sie melden: Ein Zubehör hat keines von beiden.

Wenn Apple ein Gerät nicht erreicht (ausgeschaltet, kein Netz, Tiefschlaf), antwortet es mit einem Akkustand von 0 %: Das ist der Standardwert des Feldes, keine Messung. Die Integration veröffentlicht ihn nicht – Gladys würde sonst „niedriger Akkustand“ für ein Telefon melden, das noch lange nicht leer ist – und behält stattdessen den zuletzt bekannten Stand, wie die App „Wo ist?“.

Der Messwert „Wird geladen“ steht bewusst nicht in der Akku-Kategorie, obwohl Gladys eine dafür hat. Gladys warnt „Akkustand unter 10 %“ für jede Funktion der Akku-Kategorie, deren Wert unter dem Schwellenwert liegt, unabhängig von ihrem Typ: Ein Ladesensor hat den Wert 0 oder 1, wurde also als „0 %“ gelesen und löste jeden Tag auf jedem Telefon eine Warnung aus. Er wird stattdessen als binärer Eingang veröffentlicht (der generische binäre Messwert von Gladys): derselbe Ja/Nein-Wert, dieselbe Verwendung in einer Szene, aber außerhalb der Kategorie, die diese Prüfung durchläuft.

Ein Gerät vom Dashboard aus klingeln lassen

Alle oben genannten Messwerte sind schreibgeschützt, aber Klingeln ist eine Taste: Leg das Gerät auf ein Dashboard, und seine Taste „Schieben“ spielt den Ton von „Wo ist?“ auf diesem iPhone, iPad, Mac oder dieser Apple Watch ab – genau wie die App „Wo ist?“. Es ist ein Taster, kein Schalter: Es gibt nichts wieder auszuschalten, ein Druck ist ein Klingeln. Auch eine Szene kann sie drücken („wenn nachts die Türklingel läutet, mein iPhone klingeln lassen“).

Die Aktion Ein Gerät klingeln lassen im Tab „Konfiguration“ macht genau dasselbe und bleibt verfügbar: So lässt du ein Gerät klingeln, das du noch nicht zu Gladys hinzugefügt haben.

Deine Geräte sind schon in Gladys? Gladys ändert die Funktionen eines erstellten Geräts nie von selbst: Öffne den Tab Entdecken der Integration und klicke bei jedem Gerät auf Aktualisieren, damit die Taste erscheint.

AirTags werden nicht gemeldet. Apple stellt sie nicht über die Web-API von „Wo ist?“ bereit: Ihre Position ist Ende-zu-Ende-verschlüsselt und wird nur von der App „Wo ist?“ auf einem Apple-Gerät entschlüsselt. iCloud.com selbst zeigt nur den Tab „Geräte“, nie den Tab „Objekte“ – keine Integration, die sich bei einem iCloud-Account anmeldet, kann sie also sehen. Die Integration liest die Zubehörlisten trotzdem, falls Apple sie eines Tages bereitstellt: Sie würden dann ohne neue Version erkannt.

Dashboard-Widgets (Gladys 5.1+)

Zwei Widgets können unter Dashboard → Bearbeiten → Neues Widget bei den Integrations-Widgets hinzugefügt werden:

• Wer ist zu Hause – eine Zeile pro Gerät: „Zu Hause“ oder „Abwesend · 5,6 km“. Darüber, wie viele Geräte zu Hause sind. Einstellung: die anzuzeigenden Geräte (leer = alle in Gladys erstellten Geräte, höchstens 10).
• Apple-Gerät – ein Gerät im Detail: Akku und Entfernung (live), der Entfernungsverlauf der letzten 24 h, Anwesenheit, Ladezustand, Genauigkeit und Alter der Position sowie drei Tasten: Klingeln, Karte (öffnet die Position in Apple Karten) und Aktualisieren.

Die Taste Aktualisieren fragt „Wo ist?“ sofort ab, ohne auf das Aktualisierungsintervall zu warten. Um Apples Anfragebegrenzung nicht zu überschreiten, ruft die Integration „Wo ist?“ nie öfter als einmal alle 30 s ab: Ein schnellerer Druck verwendet die letzte Abfrage erneut.

Szenen (Gladys 5.1+)

Anwesenheit bleibt der einfachste Auslöser (ein Auslöser Änderung von Gerätestatus: „die Anwesenheit meines iPhones wird 1“). Gladys 5.1 fügt dem Szenen-Editor eigene Karten hinzu, unter Integrationen.

Auslöser

Auslöser	Wann	Variablen
Ein Apple-Gerät kommt nach Hause	Einmal, wenn das Gerät den Radius betritt	Gerätename, Akku, Geräte zu Hause
Ein Apple-Gerät verlässt das Zuhause	Einmal, wenn das Gerät 125 % des Radius überschreitet	Gerätename, Entfernung, Akku, Geräte zu Hause
iCloud verlangt einen neuen Zwei-Faktor-Code	Einmal, wenn die Positionen mangels Code stehen bleiben	—

• Wähle auf der Karte ein oder mehrere Geräte, oder lass sie leer für „ein beliebiges Gerät“.
• Nur die in Gladys erstellten Geräte starten eine Szene.
• Wenn die Integration neu startet, „kommt“ ein Telefon, das schon zu Hause ist, nicht ein zweites Mal an.
• „Geräte zu Hause“ ist 0, wenn das letzte Gerät geht: praktisch für eine Nachricht „das Haus ist leer“.
• Der Auslöser „neuer Code“ dient dazu, dich zu warnen (Benachrichtigung, Nachricht): Ohne den Code bewegen sich die Anwesenheiten nicht mehr.

Aktionen

• Nachricht auf einem Apple-Gerät anzeigen – die Nachricht erscheint auf dem Bildschirm des Geräts (wie die Nachricht von „Wo ist?“ auf icloud.com), mit optionalem Ton. Szenenvariablen sind erlaubt. Höchstens 500 Zeichen.
• Positionen der Apple-Geräte aktualisieren – fragt „Wo ist?“ sofort ab. Gibt zurück, wie viele Geräte zu Hause sind und wie viele verfolgt werden. Setze sie vor eine Bedingung auf eine Anwesenheit.
• Position eines Apple-Geräts abrufen – gibt den Namen, „zu Hause“, die Entfernung, Breitengrad, Längengrad, Genauigkeit, Alter der Position, Akku, Ladezustand und einen Kartenlink zurück. Beispiel: „Maria ist {{Entfernung}} km entfernt: {{Kartenlink}}“ in einer Telegram-Nachricht. Option: zuerst eine aktuelle Position von „Wo ist?“ anfordern.

Die Aktualisierungsaktionen folgen derselben Regel wie die Widget-Taste: höchstens ein Aufruf bei Apple alle 30 s.

Gladys 5.1 oder neuer ist erforderlich für diese Widgets und Szenenkarten, und Gladys 5.2 oder neuer, um das Zuhause zu wählen, von dem aus die Anwesenheit gemessen wird.

Konfiguration

1. Öffne den Tab Konfiguration der Integration.

2. Gib deine Apple-ID (die E-Mail-Adresse des iCloud-Accounts) und dein Passwort ein. Gladys speichert sie verschlüsselt und sendet sie nur an Apple.

3. Wähle das Referenz-Zuhause für die Anwesenheit unter deinen Gladys-Zuhause: Seine Position (Einstellungen > Zuhause, es muss auf der Karte platziert sein) hat Vorrang vor den unten eingegebenen Koordinaten. Mit mehreren Zuhause – einer Stadtwohnung, einem Ferienhaus – legst du so fest, welches „zu Hause“ ist. Wird das Zuhause in Gladys verschoben, wird das beim nächsten Speichern der Konfiguration oder Neustart der Integration berücksichtigt. Wird das gewählte Zuhause gelöscht oder hat es keine Position, meldet das der Tab „Konfiguration“, und in der Zwischenzeit werden die eingegebenen Koordinaten verwendet. Lass das Feld leer, um weiterhin die eingegebenen Koordinaten zu verwenden.

   Breitengrad und Längengrad deines Zuhauses sind mit der Position deines Gladys-Zuhauses vorausgefüllt (das gewählte, sonst das erste auf der Karte platzierte): Lass sie unverändert, es sei denn, du möchtest einen anderen Bezugspunkt. Bleiben sie leer – ein Zuhause ohne Adresse –, klicke auf Koordinaten meines Gladys-Zuhauses abrufen (die Aktion nennt dir, was blockiert), oder gib sie in Dezimalgrad ein (48.8566, 2.3522, kopiert aus einem beliebigen Kartendienst). Lege den Radius fest, innerhalb dessen ein Gerät als anwesend gilt (standardmäßig 150 m – erhöhe ihn bei einem großen Grundstück oder wenn deine Geräte oft über WLAN geortet werden).

4. Speichere.

Zwei-Faktor-Authentifizierung

Wenn dein Account die Zwei-Faktor-Authentifizierung nutzt – Apples Standard –, erscheint direkt nach dem Speichern ein 6-stelliger Code auf deinen Apple-Geräten. Die Integration fordert Apple ausdrücklich auf, ihn zu senden: Ein Account ohne vertrauenswürdiges Gerät (nur mit einer Telefonnummer) erhält ihn per SMS.

1. Notiere den Code. Die Meldung im Tab „Konfiguration“ sagt, wohin er gesendet wurde (vertrauenswürdige Geräte oder Telefonnummer).
2. Klicke im Tab Konfiguration auf Zwei-Faktor-Code übermitteln, gib ihn ein und bestätige.
3. Die Integration bittet Apple dann, dieser Sitzung zu vertrauen, damit der Code bei den nächsten Neustarts nicht erneut verlangt wird (Apple behält dieses Vertrauen etwa 30 Tage, manchmal weniger).

Kommt nichts an, klicke auf Neuen Zwei-Faktor-Code anfordern: Apple sendet einen weiteren (zuerst per Push, ersatzweise per SMS), ohne dass du von vorne beginnen musst. Und wenn die Benachrichtigung auf deinen Geräten immer noch nicht erscheint, erzwingt Code per SMS anfordern den Versand an eine vertrauenswürdige Telefonnummer.

Erweiterte Einstellungen

• Aktualisierungsintervall (poll_frequency, standardmäßig 300 s): wie oft die Integration Apple nach einer neuen Position fragt. Das ist der erste Regler, an dem du drehen solltest – kürzer bedeutet eine reaktionsschnellere Anwesenheit, aber mehr Aufrufe bei Apple und mehr Akkuverbrauch auf deinen Geräten. Das Minimum ist 60 s. Gladys selbst kann nicht seltener als einmal pro Minute abfragen: Zwischen zwei echten Aktualisierungen antwortet die Integration einfach mit der zuletzt bekannten Position. Unabhängig von der Einstellung ruft sie Apple nie öfter als einmal alle 30 Sekunden auf, und ein einziger Aufruf deckt alle deine Geräte ab.
• Maximaler Genauigkeitsradius (standardmäßig 500 m): Eine Position, die mit einem größeren Unsicherheitsradius gemeldet wird, wird ignoriert. Ohne diese Schutzmaßnahme würde eine aus einem Mobilfunk-WLAN abgeleitete Position deine Anwesenheit um Kilometer springen lassen.
• Geräte der Familie einbeziehen: auch die über die Familienfreigabe geteilten Geräte bereitstellen.

Anwesenheits-Hysterese

Ein Gerät wird anwesend, sobald es den Radius betritt, aber erst jenseits von 125 % des Radius abwesend. Bei einem Radius von 150 m muss es sich mehr als 187 m entfernen, um als weg zu gelten. So löst ein Telefon, das am Rand der Zone liegt, deine Szenen nicht wegen GPS-Rauschens immer wieder aus.

Aktionen

• Zwei-Faktor-Code übermitteln – bestätigt den 6-stelligen Code und lässt die Sitzung von Apple als vertrauenswürdig einstufen.
• Neuen Zwei-Faktor-Code anfordern – fordert bei Apple einen weiteren Code an: per Push an die vertrauenswürdigen Geräte oder per SMS, wenn der Account keine hat.
• Code per SMS anfordern – erzwingt den Versand des Codes an eine vertrauenswürdige Telefonnummer, auch wenn der Account vertrauenswürdige Geräte hat.
• Koordinaten meines Gladys-Zuhauses abrufen – füllt Breitengrad und Längengrad aus deinem Gladys-Zuhause (dem gewählten, falls vorhanden) und zeigt den genauen Fehler an, wenn Gladys sie nicht liefert. Lade die Seite neu, um die ausgefüllten Felder zu sehen.
• iCloud-Verbindung testen – meldet sich erneut an und zeigt, wie viele Geräte gefunden wurden, mit ihren Namen.
• Gespeicherte Sitzung vergessen – löscht die gespeicherten Tokens. Verwende sie, wenn die Verbindung in einem seltsamen Zustand feststeckt: Die nächste Anmeldung beginnt von vorne (und verlangt einen neuen Zwei-Faktor-Code).
• Ein Gerät klingeln lassen – wähle eines deiner Geräte, und es spielt den Ton von „Wo ist?“ ab. Praktisch, um ein Telefon im Sofa zu finden, und der Weg, ein Gerät klingeln zu lassen, das du noch nicht zu Gladys hinzugefügt haben. Hinzugefügte Geräte tragen dieselbe Taste auf ihrer Dashboard-Karte (siehe oben).

Fehlerbehebung

Die Werte werden nicht mehr aktualisiert: Schau zuerst in den Tab Konfiguration der Integration. Wenn die Integration ihre Werte nicht mehr aktualisiert, sagt sie das jetzt dort, mit dem Grund: Apple verlangt einen neuen Zwei-Faktor-Code (die iCloud-Sitzung ist abgelaufen, ebenso das ihr gewährte Vertrauen), „Wo ist?“ antwortet nicht, oder seit Langem wurde nichts aktualisiert. Im ersten Fall gibst du den neuen Code mit der Aktion Zwei-Faktor-Code übermitteln ein, und die Werte bewegen sich sofort wieder. In den anderen Fällen zeigt die Aktion iCloud-Verbindung testen, wo es hakt. Das Dashboard behält in der Zwischenzeit die zuletzt bekannten Werte: Sie sind nicht falsch, nur alt.

Ein gelöschtes und neu erstelltes Gerät bleibt leer: behoben. Die Integration veröffentlicht jetzt alle seine Messwerte in dem Moment, in dem du es neu erstellst, statt das Ereignis für ein Duplikat zu halten und das Gerät leer zu lassen, bis sich ein Wert ändert.

„Verbindung zu iCloud fehlgeschlagen: ...“: Die Meldung gibt Apples eigene Antwort wieder. Die üblichen Ursachen sind ein geändertes Passwort, ein nach zu vielen Versuchen vorübergehend gesperrter Account oder eine Sitzung, die erneut bestätigt werden muss. Liegt die Ursache beim Netzwerk oder einem Ausfall bei Apple (der Container startete vor dem Netzwerk, Apple antwortet „503“), endet die Meldung mit „Nächster Versuch in N Min.“: Die Integration meldet sich nach 1, 5, 15 und dann alle 30 Minuten von selbst erneut an, und du musst nur warten. Ein abgelehntes Passwort oder ein Zwei-Faktor-Code wird nie automatisch erneut versucht, damit der Account nicht gesperrt wird.

„Wo ist?“ antwortet nicht: Die Integration versucht es weiter, aber immer seltener (nach 1, 2, 4, 8 … Minuten, bis zu 30 Minuten oder dem Aktualisierungsintervall), und führt nie mehr als eine vollständige Anmeldung alle 15 Minuten durch, wenn Apple die Sitzung weiterhin ablehnt. Die Aktion iCloud-Verbindung testen versucht es trotzdem sofort.

Es kommt kein Zwei-Faktor-Code an: Verwende Neuen Zwei-Faktor-Code anfordern, dann Code per SMS anfordern. Die Meldung im Tab „Konfiguration“ gibt den Grund wieder, den Apple genannt hat, als es den Versand verweigerte. Prüfe dann auf appleid.apple.com, ob der Account wirklich ein vertrauenswürdiges Gerät oder eine vertrauenswürdige Telefonnummer hat – ohne eines von beiden kann Apple ihn nirgendwohin senden.

Die Koordinaten bleiben leer: Die Integration liest die Position deines Zuhauses über die Gladys-API, was die Berechtigung location (in ihrem Manifest deklariert) und ein Zuhause mit Adresse (Einstellungen → Zuhause) erfordert. Die Aktion Koordinaten meines Gladys-Zuhauses abrufen zeigt den genauen Grund der Ablehnung. Ein Zuhause, das nie auf der Karte platziert wurde, wird gemeldet und nie als Position 0, 0 genommen.

Mein AirTag erscheint nicht: erwartet, und nichts, was die Integration beheben kann (siehe Hinweis oben). Apple gibt die Position von Objekten in „Wo ist?“ nur an die App „Wo ist?“ auf einem Apple-Gerät weiter. Um eine Szene an einem Gegenstand auszulösen, verfolge ein Gerät, das seine Position meldet (iPhone, Apple Watch), oder verwende einen Tracker einer anderen Marke mit eigener Integration.

Die Geräte meiner Familie erscheinen nicht: Geräte der Familie einbeziehen muss aktiviert sein, und jedes Mitglied muss seinen Standort teilen (Einstellungen → dein Name → Familie → Standortfreigabe). Apple lädt die Geräte der Familie nach deinen: Es kann ein paar Minuten dauern. Das Protokoll zeigt, was Apple liefert, zum Beispiel „Family Sharing: Apple lists 3 member(s), 1 of them still loading". Ein Mitglied, das „loading" bleibt, teilt seinen Standort nicht; „no family member" heißt, dass Apple für dieses Konto kein Mitglied sieht.

Kein Gerät erscheint: Prüfe, ob Mein iPhone suchen auf diesen Geräten aktiviert ist (Einstellungen → dein Name → „Wo ist?“). Ein Gerät, das lange ausgeschaltet oder offline war, meldet möglicherweise überhaupt keine Position; es erscheint in Gladys, aber ohne Anwesenheit, bis Apple etwas Aktuelles hat.

Das gerade hinzugefügte Gerät bleibt leer: Seine Werte werden veröffentlicht, sobald es erstellt ist, und dann bei jeder Aktualisierung. Bleibt es leer, prüfe den Tab „Konfiguration“ (die Integration muss mit iCloud verbunden sein) und den Messwert Genauigkeit: Ein Gerät, für das Apple keine Position hat, bekommt weder Anwesenheit noch Entfernung.

„SQLITE_BUSY: database is locked“ beim Hinzufügen eines Geräts: Der Fehler kommt aus der Datenbank von Gladys, nicht aus der Integration. Gladys konnte das neue Gerät nicht speichern, weil im selben Moment ein anderer Schreibvorgang lief (zum Beispiel die Werte, die die Integrationen senden). Nichts geht verloren: Klicke erneut auf Erstellen. Passiert es oft, melde es im Gladys-Forum mit der vollständigen Fehlermeldung.

„Kein aktueller Wert“ auf dem Dashboard: Gladys betrachtet einen Wert als veraltet, wenn eine Weile nichts für ihn veröffentlicht wurde (standardmäßig 48 Stunden). Die Integration veröffentlicht jeden Wert mindestens alle 30 Minuten erneut, daher sollte das nur auftreten, wenn die Integration gestoppt ist, sich nicht mehr bei iCloud anmelden kann (prüfe den Tab „Konfiguration“) oder wenn das Gerät überhaupt keine Position meldet.

Ich bekam früher jeden Tag „Akkustand unter 10 % (aktuell: 0 %)“ für ein iPhone: Das war der alte Messwert „Wird geladen“, abgelegt in der Akku-Kategorie, der 0 ist, wann immer das Telefon nicht angeschlossen ist. Der neue Messwert „Wird geladen“ ist ein binärer Eingang und speist den alten nie mehr. Der alte bleibt auf den zuvor erstellten Geräten gespeichert: Öffne den Tab Entdecken der Integration und klicke bei diesem Gerät auf Aktualisieren – Gladys löscht die Messwerte, die nicht mehr veröffentlicht werden, und die Warnung hört auf.

Der Messwert „Wird geladen“ zeigt „Kein Wert empfangen“: zwei mögliche Ursachen, und die Protokolle sagen, welche.

1. Das Gerät wurde in Gladys erstellt, bevor es diesen Messwert gab (der aktuelle Messwert „Wird geladen“ kam mit 1.0.8). Gladys fügt einem bereits erstellten Gerät nie von selbst einen neuen Messwert hinzu: Öffne den Tab Entdecken der Integration und klicke bei diesem Gerät auf Aktualisieren – die Werte werden direkt nach diesem Klick veröffentlicht. Solange der Messwert fehlt, sagt die Integration das jetzt in ihren Protokollen: Gladys has no feature ...:charging-state.
2. Apple liefert für dieses Gerät keinen Ladezustand. „Wo ist?“ übermittelt das Feld batteryStatus nur für die Geräte, die es erreichen konnte, und ein Zubehör (AirTag, AirPods) hat es überhaupt nicht. Die Integration veröffentlicht dann nichts statt eines erfundenen „wird nicht geladen“. Die Aktion iCloud-Verbindung testen zeigt, was Apple für jedes Gerät antwortet, z. B. iPhone von Max (87%, Ladezustand unbekannt (batteryStatus: Unknown)), und die Protokolle wiederholen es, wann immer es sich ändert. Auf der Gladys-Seite gibt es nichts zu beheben: Der Wert kommt zurück, sobald Apple ihn wieder meldet.

Die Taste „Klingeln“ fehlt: Das Gerät wurde erstellt, bevor es die Funktion gab. Öffne den Tab Entdecken der Integration und klicke bei diesem Gerät auf Aktualisieren.

Das Gerät klingelt nicht: Der Ton wird von Apple abgespielt, nicht von Gladys. Ein Gerät, das ausgeschaltet, offline oder lange im Ruhezustand ist, klingelt erst, wenn es das nächste Mal online kommt. Die Fehlermeldung gibt Apples eigene Antwort wieder; LOG_LEVEL=debug liefert alle Details in den Protokollen.

Die Anwesenheit ändert sich nie: Schau dir den Messwert Positionsgenauigkeit an. Liegt er nahe an oder über deiner Einstellung „Maximaler Genauigkeitsradius“, werden Positionen ignoriert – erhöhe den Schwellenwert oder den Radius des Zuhauses.

Der Zwei-Faktor-Code wird oft verlangt: Apple entscheidet, wie lange eine Sitzung vertrauenswürdig bleibt. Vermeide es, das Passwort zu ändern oder Sitzungen auf appleid.apple.com zu widerrufen.

Die Integration protokolliert alles, was sie tut: Lies ihre Protokolle in der Gladys-Oberfläche (oder mit docker logs auf dem Host), mit LOG_LEVEL=debug für alle Details.

Gut zu wissen

Apple veröffentlicht keine offizielle API für „Wo ist?“. Diese Integration nutzt dieselbe Schnittstelle wie die Website icloud.com, mit demselben sicheren Anmeldeverfahren (SRP: Dein Passwort verlässt nie deinen Rechner, nur ein kryptografischer Nachweis wird gesendet). Apple kann diese Schnittstelle ohne Vorankündigung ändern: Funktioniert die Integration über Nacht nicht mehr, ist das die wahrscheinlichste Ursache.

Deine Zugangsdaten bleiben bei dir, in deiner Gladys-Instanz, und laufen nie über einen Drittanbieterdienst.

Konfigurationseinstellungen

Diese Einstellungen fragt Apple Device Tracker in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Dein iCloud-Account	section	Nein	Diese Integration meldet sich mit deiner Apple-ID bei iCloud an und liest die Position der Geräte, die in „Wo ist?“ sichtbar sind. Deine Zugangsdaten bleiben in Gladys, auf deinem Rechner. Die Zwei-Faktor-Authentifizierung wird unterstützt: Verwende nach dem Speichern die Aktion unten, um den 6-stelligen Code einzugeben, den Apple dir sendet, und die Aktion „Neuen Zwei-Faktor-Code anfordern“, falls nichts ankommt.
Apple-ID	string	Ja	Die E-Mail-Adresse des iCloud-Accounts, dem die Geräte gehören.
Passwort der Apple-ID	secret	Ja	Von Gladys verschlüsselt gespeichert und nur an Apple gesendet. Eine Änderung erzwingt eine neue Anmeldung.
Dein Zuhause	section	Nein	Ein Gerät gilt als anwesend, wenn es sich innerhalb des unten angegebenen Radius um das gewählte Gladys-Zuhause befindet. Ohne gewähltes Zuhause werden die Koordinaten unten verwendet: Sie sind mit der Position deines Gladys-Zuhauses vorausgefüllt; ändere sie nur, wenn du einen anderen Bezugspunkt möchtest.
Referenz-Zuhause für die Anwesenheit	select	Nein	Eines deiner Gladys-Zuhause: Seine Position hat Vorrang vor den Koordinaten unten. Es muss unter Einstellungen > Zuhause auf der Karte platziert sein. Leer lassen, um die Koordinaten unten zu verwenden.
Breitengrad des Zuhauses	string	Nein	Dezimalgrad zwischen -90 und 90 (Beispiel: 48.8566). Wird aus deinem Gladys-Zuhause vorausgefüllt, wenn das Feld leer ist. Ein Textfeld, damit die Nachkommastellen nie gerundet werden.
Längengrad des Zuhauses	string	Nein	Dezimalgrad zwischen -180 und 180 (Beispiel: 2.3522). Wird aus deinem Gladys-Zuhause vorausgefüllt, wenn das Feld leer ist. Ein Textfeld, damit die Nachkommastellen nie gerundet werden.
Radius des Zuhauses (m)	number	Nein	Radius um dein Zuhause, innerhalb dessen ein Gerät als anwesend gilt. Ein Gerät gilt erst 25 % jenseits davon als abwesend, um ständiges Hin- und Herspringen zu vermeiden.
Erweitert	section	Nein	Apple begrenzt die Anfragen an „Wo ist?“: Wähle ein vernünftiges Aktualisierungsintervall. Positionen, die ungenauer als der Schwellenwert unten sind, werden ignoriert, statt deine Anwesenheit hin- und herspringen zu lassen.
Aktualisierungsintervall (s)	number	Nein	Wie oft die Integration Apple nach einer neuen Position fragt, in Sekunden. Gladys selbst fragt jede Minute ab (seine eigene Grenze), und die Integration antwortet aus ihrem Cache, bis dieses Intervall abgelaufen ist.
Maximaler Genauigkeitsradius (m)	number	Nein	Positionen mit einem größeren Genauigkeitsradius als diesem Wert werden ignoriert.
Geräte der Familie einbeziehen	boolean	Nein	Auch die Geräte bereitstellen, die über die Familienfreigabe mit dir geteilt werden.

So installierst du Apple Device Tracker in Gladys

1. Öffne in Gladys Integrationen: Apple Device Tracker erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/prohand/gladys-appledevicetracker:2.5.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-appledevicetracker.

Apple Device Tracker benötigt Gladys >=5.2.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.

Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.

Über externe Integrationen

Apple Device Tracker ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.

• Alle Integrationen durchsuchen, native und aus der Community
• Deine eigene externe Integration bauen und veröffentlichen
• Quellcode auf GitHub — Quelle dieser Dokumentation

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂