OwnTracks Community-Integration, kostenlos und Open Source

Deine von OwnTracks verfolgten Telefone in Gladys: Anwesenheit, Entfernung, Regionen, Akku.

• Veröffentlicht von guim31
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Bringt die von OwnTracks verfolgten Telefone nach Gladys, die freie und datenschutzfreundliche Standort-App für Android und iOS, über deinen eigenen OwnTracks Recorder. Jedes Telefon wird ein Gladys-Gerät, das sagt, ob es zu Hause ist, wie weit es von zu Hause entfernt ist, in welcher OwnTracks-Region es sich befindet und wie viel Akku es noch hat; Szenen können reagieren, wenn ein Telefon nach Hause kommt oder geht, eine Region betritt oder verlässt oder keine Positionen mehr sendet; und ein Telefon zu Hause kann die Anwesenheit eines Gladys-Benutzers steuern.

Getestet mit einem echten OwnTracks Recorder 1.0.4 und simulierten Telefonen (Positionen über seine HTTP-API gesendet), nicht mit Telefonen unterwegs: Rückmeldungen sind willkommen.

Voraussetzungen

• Gladys 5.1 oder neuer.
• Ein OwnTracks Recorder, den Gladys in deinem Netzwerk erreicht, meist auf Port 8083 (zum Beispiel das Docker-Image owntracks/recorder).
• Die OwnTracks-App auf jedem Telefon, die ihre Positionen an den Recorder sendet: über deinen MQTT-Broker oder im HTTP-Modus direkt an den Recorder (/pub). Gladys liest nur den Recorder; es spricht nie mit den Telefonen.

Konfiguration

1. Öffne in Gladys den Reiter Konfiguration der Integration:
   • Adresse des Recorders: wie du sie im Browser öffnest, zum Beispiel http://192.168.1.20:8083. Ohne Port wird 8083 verwendet. Ein Recorder hinter einem Reverse Proxy funktioniert auch, mit seinem Pfad (https://example.com/owntracks).
   • Benutzername des Proxys und Passwort des Proxys: nur wenn ein Reverse Proxy den Recorder mit einem Passwort schützt (Basic Auth). Der Recorder selbst hat keines.
2. Speichere. Die Schaltfläche Verbindung testen zeigt die Version des Recorders sowie die Zahl der Benutzer und der Telefone mit Position.
3. Öffne den Reiter Entdecken und füge die gewünschten Telefone zu Gladys hinzu.

Zuhause und Anwesenheit (optional):

• Das Zuhause ist ein Radius (standardmäßig 150 m) um den Standort deines Gladys-Hauses (Einstellungen → Zuhause). Bei mehreren Häusern gib den Namen des gewünschten ein; standardmäßig das erste mit Standort.
• Oder gib eine OwnTracks-Region ein (eine in der App definierte Region, zum Beispiel Zuhause): Ein Telefon ist dann zu Hause, wenn die App sagt, dass es darin ist, und der Radius wird ignoriert. Regionen überwacht das Telefon selbst: Das ist die zuverlässigste und akkuschonendste Wahl.
• Anwesenheit: letzte Position höchstens: Ein Telefon zu Hause meldet nur so lange „zu Hause gesehen“, wie seine letzte Position jünger als diese Frist ist (standardmäßig 2 Stunden). Ein iPhone im Modus Signifikant sendet nichts, solange es sich nicht bewegt: Wähle eine lange Frist.
• Koordinaten mit Gladys teilen: standardmäßig aus, siehe Datenschutz unten.
• Sprache: die Sprache der Funktionsnamen und der Texte der Integration (Regionen, Sätze). Standardmäßig Französisch.

Datenschutz

Standardmäßig verlassen die Koordinaten der Telefone nie die Integration: Gladys erhält Anwesenheit, Entfernung von zu Hause, Namen der Regionen und Akku, sonst nichts. Mit Koordinaten mit Gladys teilen erhalten Widget und Szenen zusätzlich einen Link zur Position auf OpenStreetMap. Koordinaten und Regionsnamen werden nie in die Logs geschrieben.

Geräte

Ein Gerät pro Telefon des Recorders (ein Benutzer und ein Gerätename in OwnTracks), benannt nach seiner OwnTracks-Karte, wenn es eine hat. Funktionen:

Funktion	Was sie anzeigt
Zu Hause	Ja oder nein, nach der Regel für das Zuhause oben
Anwesenheit	Ein Signal „zu Hause gesehen“ für die Anwesenheit (siehe unten)
Entfernung von zu Hause	In km, bis zum Gladys-Haus
Akku	In % des Telefons
Letzte Position	Datum und Uhrzeit der letzten Position
OwnTracks-Region	Die Regionen, in denen das Telefon ist, oder „Keine Region“

Die Entfernung braucht ein Gladys-Haus mit Standort; Zu Hause und Anwesenheit brauchen eine Regel für das Zuhause (Radius oder Region).

Die Aktualisierung ist live: Der Recorder schickt jede neue Position über seinen WebSocket (/ws/last) an die Integration. Fällt die Verbindung aus, liest die Integration den Recorder jede Minute, bis sie zurück ist: Die letzte Position jedes Telefons wird nachgeholt, nicht die dazwischen.

Anwesenheit eines Benutzers

Gladys entscheidet mit Szenen, wer zu Hause ist. Zwei Wege, die sich gut kombinieren lassen:

• Einfach: eine Szene, die ausgelöst wird, wenn die Funktion Zu Hause des Telefons 1 wird, mit der Aktion Benutzer zu Hause gesehen; eine zweite, wenn sie 0 wird, mit Benutzer hat das Zuhause verlassen. Die Auslöser Telefon kommt nach Hause und Telefon verlässt das Zuhause der Integration tun dasselbe.
• Robust: Die Funktion Anwesenheit sendet bei jeder Position zu Hause ein Signal „zu Hause gesehen“, dann alle 5 Minuten, solange die letzte Position aktuell ist. Eine geplante Szene (alle 5 oder 10 Minuten) mit der Aktion Anwesenheit von Benutzern überprüfen (der Benutzer, das Haus, die Funktion Anwesenheit seines Telefons, eine Wartezeit wie 15 Minuten) markiert den Benutzer als abwesend, wenn das Telefon so lange nicht zu Hause gesehen wurde — auch wenn sein Akku im Büro leer ist.

Dashboard-Widget

Das Widget Telefone und Anwesenheit listet jedes Telefon (höchstens acht) mit seiner Region, der Zeit seiner letzten Position und seiner Anwesenheit als farbiges Abzeichen (zu Hause, unterwegs, unbekannt). Tippe auf ein Telefon, um Akku, Entfernung von zu Hause, Genauigkeit der Position und einen Kartenlink (wenn Koordinaten geteilt werden) zu sehen.

Szenen

Auslöser (Kategorie Integrationen des Szenen-Editors):

• Telefon kommt nach Hause und Telefon verlässt das Zuhause: Das Telefon war unterwegs und ist jetzt zu Hause, oder umgekehrt. Filter: das Telefon (leer: jedes). Weitergegebene Informationen: der Name des Telefons, die Zeit der Position.
• Telefon betritt eine Region und Telefon verlässt eine Region: Die OwnTracks-App meldet das Telefon in einer ihrer Regionen oder außerhalb davon. Filter: das Telefon und der Name der Region, genau wie in OwnTracks (leer: jede). Weitergegebene Informationen: der Name des Telefons, die Region, die Zeit, der Kartenlink (falls geteilt).
• Keine Position mehr empfangen: keine neue Position vom Telefon seit 1, 2, 3, 6, 12, 24 oder 48 Stunden (Pflichtfeld): Die App ist vielleicht gestoppt oder das Telefon aus. Einmal pro Stille; eine neue Position setzt zurück. Weitergegebene Informationen: der Name des Telefons, die Zeit der letzten Position.

Nur die zu Gladys hinzugefügten Telefone lösen Szenen aus. Ein Wechsel, der stattfand, während der Recorder nicht erreichbar war, löst verspätet aus, wenn die Verbindung zurück ist. Was während eines Neustarts von Gladys passiert, wird nicht nachgeholt: Die Integration startet mit dem aktuellen Stand neu.

Aktion Position eines Telefons abfragen: ein fertiger Satz („Alice (phone) ist zu Hause, Position von 16:08.“) und die Werte, für eine Nachricht oder eine Bedingung: Anwesenheit, zu Hause (ja/nein), Region, Entfernung von zu Hause (km, -1 wenn unbekannt), Akku (%, -1 wenn unbekannt), Zeit der Position, Kartenlink (falls geteilt).

Szenenbeispiele

• Willkommen: Auslöser Telefon kommt nach Hause (Telefon von Alice) → das Licht im Flur einschalten, wenn es dunkel ist.
• Der Letzte geht: Auslöser Telefon verlässt das Zuhause → Bedingung „niemand zu Hause“ → die Alarmanlage scharf schalten und die Heizung absenken.
• Kinder in der Schule: Auslöser Telefon betritt eine Region (Region Schule) → eine Nachricht mit dem Namen des Telefons und der Uhrzeit senden (über die Variablenauswahl eingefügt).
• Tracking gestoppt: Auslöser Keine Position mehr empfangen (6 Stunden) → eine Nachricht senden: Die App wurde wahrscheinlich vom Energiesparmodus beendet.

Fehlerbehebung

• „Der Recorder antwortet nicht“: Öffne die Adresse in einem Browser auf dem Rechner von Gladys; prüfe den Port (standardmäßig 8083) und dass der Recorder im Netzwerk lauscht (OTR_HTTPHOST=0.0.0.0 in Docker).
• „Benutzername und Passwort abgelehnt“: Der Reverse Proxy vor dem Recorder hat sie abgelehnt. Ohne Proxy lass beide Felder leer.
• Kein Gerät unter Entdecken: Der Recorder hat noch keine Position. Prüfe auf seiner Webseite (/last), dass die Telefone erscheinen.
• Ein Telefon ist nie zu Hause: Prüfe den Standort des Gladys-Hauses oder den genauen Namen der OwnTracks-Region (Groß- und Kleinschreibung egal). Bei einem Radius kann eine Position um ihre Genauigkeit danebenliegen (im Widget angezeigt).
• Keine Live-Aktualisierung: Ein Reverse Proxy muss den WebSocket /ws/last durchlassen. Ohne ihn kommen die Positionen trotzdem an, jede Minute.
• Das Telefon sendet stundenlang nichts: In OwnTracks sendet der Modus Signifikant erst nach einer Bewegung von einigen hundert Metern eine Position; auch der Energiesparmodus von Android kann die App stoppen. Siehe die Dokumentation von OwnTracks.

Grenzen

• Nur lesend: Die Integration sendet nie etwas an die Telefone (keine Fernkonfiguration, keine Positionsanfrage).
• Kein Verlauf: nur die letzte Position. Für Verlauf und Statistiken siehe die Integration Dawarich.
• Die Regionsauslöser folgen den in der OwnTracks-App definierten Regionen; die Wegpunkte und Freunde des Recorders werden nicht verwendet.
• Die Positionen werden so, wie sie sind, mit dem Gladys-Haus verglichen, ohne ihre Genauigkeit zu berücksichtigen.
• Ohne Telefon unterwegs entwickelt: getestet mit einem echten Recorder und simulierten Positionen. Rückmeldungen sind willkommen.

Konfigurationseinstellungen

Diese Einstellungen fragt OwnTracks in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Verbinde deinen OwnTracks Recorder	section	Nein	Gib die Adresse des OwnTracks Recorders ein, wie du sie im Browser öffnest (standardmäßig Port 8083). Die OwnTracks-App der Telefone sendet ihre Positionen per MQTT oder HTTP an den Recorder; Gladys liest sie dort. Liegt der Recorder hinter einem Proxy mit Passwort (Basic Auth), gib auch Benutzername und Passwort ein.
Adresse des Recorders	string	Ja
Benutzername des Proxys (optional)	string	Nein
Passwort des Proxys (optional)	secret	Nein
Zuhause und Anwesenheit	section	Nein	Ein Telefon ist zu Hause, wenn es im unten angegebenen Radius um den Standort deines Gladys-Hauses liegt, oder, wenn du eine nennst, in dieser OwnTracks-Region (einer in der App definierten Region). Nutze seine Funktion Zu Hause in Szenen mit „Benutzer zu Hause gesehen“ und „Benutzer hat das Zuhause verlassen“, oder seine Funktion Anwesenheit mit „Anwesenheit von Benutzern überprüfen“. Ein iPhone im Modus Signifikant kann stundenlang still bleiben, wenn es sich nicht bewegt: wähle unten eine ausreichend lange Frist.
Gladys-Haus (optional)	string	Nein
Radius um das Zuhause (Meter)	number	Nein
Oder: OwnTracks-Region des Zuhauses	string	Nein
Anwesenheit: letzte Position höchstens (Minuten)	number	Nein
Koordinaten mit Gladys teilen (Kartenlinks)	boolean	Nein	Aus: Nur Anwesenheit, Entfernung und Region verlassen die Integration. An: Widget und Szenen erhalten einen OpenStreetMap-Link zur Position.
Sprache der Namen und Texte	select	Nein

So installierst du OwnTracks in Gladys

1. Öffne in Gladys Integrationen: OwnTracks erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-owntracks:1.0.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/guim31/gladys-owntracks.

OwnTracks benötigt Gladys >=5.1.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

OwnTracks 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 guim31 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 🙂