Tractive Smart-Home-Integration, kostenlos und Open Source
Tractive-GPS-Tracker für Hunde und Katzen: zu Hause oder nicht, Abstand, Batterie, Aktivität.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Verfolge den Tractive-GPS-Tracker deines Hundes oder deiner Katze in Gladys: Ist das Tier zu Hause, wie weit weg, Batterie, Aktivität des Tages, dazu Summer und Licht, um es wiederzufinden. Inoffizielle Integration, nicht mit Tractive verbunden.
Ohne die Hardware entwickelt: Rückmeldungen sind willkommen. Die Integration nutzt die API der Tractive-App, so wie die freie Bibliothek aiotractive und die Home-Assistant-Integration sie lesen, und ist mit deren aufgezeichneten Antworten getestet, nicht mit einem echten Tracker. Melde bitte in den Issues, was funktioniert und was nicht.
Überblick
- Ein Gerät pro Tier mit Tractive-Tracker in deinem Konto: Batterie, Laden, Abstand zum Zuhause, Genauigkeit der Position, zu Hause oder nicht, Tracker online, Energiesparmodus, Aktivität und Ruhe des Tages, tägliches Aktivitätsziel.
- Befehle: Live-Tracking, Summer und Licht (LED), wenn Tracker und Abo es erlauben.
- Echtzeit: Batterie, Positionen und Schalter kommen sofort an, über den Ereignisstrom, den auch die Tractive-App hört.
- Szenen-Auslöser: Tier hat das Zuhause verlassen, Tier ist nach Hause gekommen, Tractive-Batterie schwach.
- Dashboard-Widget Tractive-Tier, mit Tasten für Summer und Licht.
Die Position selbst (Breite, Länge) wird nie in Gladys gespeichert, denn Gladys hat dafür keine Funktion: Gladys behält den Abstand zu deinem Haus, von der Integration berechnet.
Voraussetzungen
- Gladys Assistant 5.2.0 oder neuer.
- Ein Tractive-Tracker mit aktivem Abo, dazu die E-Mail-Adresse und das Passwort des Tractive-Kontos, zu dem er gehört. Ein mit „Mit Apple anmelden“ oder Google erstelltes Konto hat kein Passwort: Lege zuerst in der Tractive-App eins fest (Kontoeinstellungen).
- Für Abstand und „Zu Hause“: ein Haus in Gladys mit Standort (Einstellungen → Häuser, das Haus auf der Karte platzieren).
- Gladys braucht Internetzugang (
graph.tractive.com,aps-api.tractive.com,channel.tractive.com).
Konfiguration
- Öffne in Gladys Integrationen → Von GitHub installieren (oder den Katalog) und installiere Tractive. Der Installationsbildschirm fragt, ob der Standort deiner Häuser gelesen werden darf: Er dient zur Berechnung des Abstands.
- Fülle in der Konfiguration aus:
- E-Mail-Adresse und Passwort deines Tractive-Kontos;
- Haus: das Haus, von dem aus der Abstand gemessen wird (leer: das erste Haus mit Standort);
- Radius des Zuhauses (m): Innerhalb dieses Abstands ist das Tier zu Hause (standardmäßig 100 m). Als weg gilt es erst 20 % weiter (mindestens 25 m), damit GPS-Sprünge am Rand es nicht kommen und gehen lassen;
- Schwelle für schwache Batterie (%): standardmäßig 15 %;
- Aktualisierungsintervall (Min.): die vollständige Aktualisierung (standardmäßig 15 Min., 5 bis 60);
- Sprache der Funktionsnamen: standardmäßig Französisch, gilt auch für die Fehler bei Befehlen.
- Speichere und nutze dann Verbindung testen: Es listet die gefundenen Tiere.
- Öffne den Tab Erkennung und füge deine Tiere hinzu.
Die Integration legt ein Sitzungstoken in ihrem eigenen /data-Volume ab, so
meldet sie sich nach einem Neustart nicht erneut an. Das Passwort bleibt in der
Gladys-Konfiguration.
Was jedes Gerät kann
Ein Gerät pro Tier, mit dem Namen des Tiers. Die Funktionen hängen vom Tracker ab: Ein Tracker ohne Licht hat zum Beispiel keine Lichtfunktion.
| Funktion | Was sie zeigt |
|---|---|
| Batterie | Batteriestand des Trackers (%) |
| Lädt | 1, solange der Tracker lädt (Tracker, die es melden) |
| Abstand zum Zuhause | Abstand zwischen der letzten Position und dem gewählten Haus (m) |
| Genauigkeit der Position | Unsicherheit der letzten Position laut Tractive (m) |
| Zu Hause | 1 innerhalb des Radius, 0 außerhalb |
| Tracker online | 0, wenn der Tracker nichts mehr meldet oder ausgeschaltet wurde |
| Energiesparmodus | 1, solange der Tracker Energie spart (Ruhe im WLAN zu Hause) |
| Aktivität heute | Aktive Minuten seit Mitternacht |
| Ruhe heute | Ruhige Minuten seit Mitternacht (Tracker mit Schlaferkennung) |
| Tägliches Aktivitätsziel | Das in der Tractive-App eingestellte Ziel (Minuten) |
| Live-Tracking | Schalter: Live-Tracking, eine Position alle paar Sekunden |
| Summer | Schalter: Der Tracker piept, um das Tier in der Nähe zu finden |
| Licht (LED) | Schalter: Das Licht des Trackers, um das Tier im Dunkeln zu sehen |
Befehle
Live-Tracking, Summer und Licht (LED) gehen über Tractive an den Tracker. Summer und Licht gehen am Tracker nach einer Weile von selbst aus; Gladys zeigt sie aus, sobald Tractive das meldet. Live-Tracking leert die Batterie: Schalte es aus, sobald das Tier gefunden ist.
Ein Befehl wird mit einer klaren Meldung abgelehnt, wenn:
- der Tracker in seiner Energiesparzone (WLAN zu Hause) schläft: Dort nimmt er keine Befehle an;
- das Abo oder das Trackermodell die Funktion nicht erlaubt;
- die Integration nicht mit Tractive verbunden ist.
Nichts hier öffnet, entriegelt oder entschärft etwas.
Dashboard-Widget
Füge das Widget Tractive-Tier zu einem Dashboard hinzu und wähle das Tier in seinen Einstellungen. Es zeigt:
- Abstand zum Zuhause und Batterie (live);
- die Aktivität des Tages im Vergleich zum Tagesziel;
- zu Hause oder nicht, das Alter der letzten Position und den Zustand des Trackers (online, offline, Energiesparen);
- eine Taste Summer und eine Taste Licht (wenn der Tracker sie hat). Eine laufende Funktion zeigt einen Haken: Tippe erneut, um sie zu stoppen.
Szenen-Auslöser
| Auslöser | Wann | Variablen |
|---|---|---|
| Tier hat das Zuhause verlassen | Das Tier ist weiter weg als der Radius plus Spielraum | Name des Tiers, Abstand (m) |
| Tier ist nach Hause gekommen | Das Tier kommt in den Radius des Zuhauses zurück | Name des Tiers, Abstand (m) |
| Tractive-Batterie schwach | Die Batterie fällt unter die Schwelle, einmal (erneut erst nach 5 Punkten darüber), nicht beim Laden | Name des Tiers, Batterie (%) |
Jeder Auslöser lässt sich auf ein Tier beschränken (leer: jedes Tier). Die Auslöser ergänzen die Funktionen Zu Hause und Batterie um das, was ein Gerätezustand nicht sagt: ein Ereignis pro echtem Übergang, den Namen des Tiers für eine Nachricht, Positionen ungenauer als 500 m werden ignoriert (eine Funkzellen-Position lässt nie eine schlafende Katze „weggehen“), nichts beim ersten Wert nach einem Neustart.
Verbindungstest
Die Taste Verbindung testen meldet sich mit der gespeicherten Konfiguration bei Tractive an und antwortet mit den gefundenen Tieren, dem Zustand der Echtzeit-Aktualisierungen und einem eventuell fehlenden Haus mit Standort. Damit versuchst du es auch erneut, nachdem Tractive das Passwort abgelehnt hat und du es korrigiert hast.
Beispielszenen
- Der Hund ist ausgebüxt: Auslöser Tier hat das Zuhause verlassen für den Hund → Nachricht „{{triggerEvent.data.pet_name}} ist weg, {{triggerEvent.data.distance}} m entfernt“ senden → Live-Tracking einschalten.
- Willkommen zu Hause: Auslöser Tier ist nach Hause gekommen → Live-Tracking ausschalten und „{{triggerEvent.data.pet_name}} ist zu Hause“ senden.
- Tracker laden: Auslöser Tractive-Batterie schwach → Nachricht „Lade den Tracker von {{triggerEvent.data.pet_name}} ({{triggerEvent.data.battery}} %)“ senden.
- Abendkontrolle: jeden Abend um 22 Uhr, wenn Zu Hause 0 ist → Nachricht senden.
Aktualisierung und API-Grenzen
Tractive bietet keine öffentliche API: Die Integration nutzt die der Tractive-App, wie Home Assistant, und achtet darauf, sie nicht zu überlasten.
- Zuerst Echtzeit: Eine einzige dauerhafte Verbindung zum Tractive-Ereignisstrom liefert Batterie, Positionen und Schalter. Bricht sie ab, verbindet sie sich nach 10 s neu, dann bis zu alle 5 Minuten, solange es scheitert.
- Vollständige Aktualisierung alle 15 Minuten (einstellbar, 5 bis 60): Tracker, Batterie, Position und Aktivität nur der zu Gladys hinzugefügten Tiere, eine Anfrage nach der anderen, 2 Sekunden zwischen zwei Tieren. Der Gladys-Planer wird nicht genutzt: Die Integration hat ihren eigenen Timer.
- Eine Anmeldung pro Lebensdauer des Tokens: Es liegt in
/dataund wird eine Stunde vor Ablauf erneuert. Ein abgelehntes Passwort wird nicht erneut versucht, bis du die Konfiguration änderst oder Verbindung testen drückst. - Eine Antwort „zu viele Anfragen“ (429) wird nach 8 Sekunden wiederholt, dann bis zu 60 Sekunden, höchstens dreimal.
- Nur geänderte Werte gehen an Gladys, dazu alle 6 Stunden eine Erinnerung an die unveränderten.
Fehlerbehebung
- „Tractive lehnt die E-Mail-Adresse oder das Passwort ab“: Prüfe sie in der Tractive-App oder auf my.tractive.com. Ein Google- oder Apple-Konto braucht ein in der Tractive-App festgelegtes Passwort.
- Kein Tier in der Erkennung: Dem Tier muss in deinem Konto ein Tracker zugewiesen sein; ein von einem anderen Konto mit dir geteilter Tracker wird nicht aufgeführt. Drücke Verbindung testen.
- Abstand und „Zu Hause“ bleiben leer: Gib dem Haus einen Standort (Einstellungen → Häuser) oder wähle in der Konfiguration ein Haus mit Standort.
- Ein Befehl scheitert: Lies die Meldung; in der WLAN-Zone zu Hause schläft der Tracker und nimmt keine Befehle an.
- Die Werte wirken alt: Im Energiesparmodus meldet der Tracker seltener;
prüfe ihn in der Tractive-App.
LOG_LEVEL=debugfür die Integration zeigt jede Aktualisierung in ihren Protokollen.
Einschränkungen
- Ohne die Hardware entwickelt: nur mit aufgezeichneten API-Antworten getestet.
- Die API ist die der Tractive-App, keine öffentliche: Tractive kann sie ohne Vorankündigung ändern und die Integration bis zu einem Update stören.
- Keine Karte: Gladys hat keine Funktion für eine Position, nur den Abstand zu einem Haus.
- Der Zustand der Schalter (Summer, Licht, Live-Tracking) ist erst bekannt, wenn der Echtzeitstrom ihn meldet.
- Die Aktivität ist die des Tages, wie Tractive sie zählt.
- Ein Tractive-Konto pro Gladys.
- Zonen (Geofences), der Tractive-Verlauf und die Gesundheitswarnungen der App sind nicht verfügbar.
Konfigurationseinstellungen
Diese Einstellungen fragt Tractive in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Tractive-Konto | section | Nein | Die E-Mail-Adresse und das Passwort, die du in der Tractive-App verwendest. Ein Tracker mit aktivem Abo ist nötig. Inoffizielle Integration, nicht mit Tractive verbunden. |
| E-Mail-Adresse | string | Ja | |
| Passwort | secret | Ja | Nur in der Gladys-Konfiguration gespeichert; die Integration legt ein Sitzungstoken in ihrem /data-Volume ab, nie das Passwort. |
| Zuhause | section | Nein | Abstand und „Zu Hause“ werden in Gladys aus dem Standort eines Gladys-Hauses berechnet (Einstellungen, Häuser). Die Position selbst wird nie in Gladys gespeichert. |
| Haus | select | Nein | Leer: das erste Haus mit Standort. |
| Radius des Zuhauses (m) | number | Nein | Innerhalb dieses Abstands ist das Tier zu Hause. Als weg gilt es erst 20 % weiter (mindestens 25 m), gegen GPS-Sprünge. |
| Schwelle für schwache Batterie (%) | number | Nein | Unter diesem Wert löst der Szenen-Auslöser „Tractive-Batterie schwach“ einmal aus. |
| Aktualisierungsintervall (Min.) | number | Nein | Positionen und Batterie kommen in Echtzeit. Diese vollständige Aktualisierung liest die Aktivität und überbrückt Zeiten ohne Echtzeit. |
| Sprache der Funktionsnamen | select | Nein | Gilt für die ab jetzt hinzugefügten Geräte und für die Fehler bei Befehlen. |
So installierst du Tractive in Gladys
- Öffne in Gladys Integrationen: Tractive erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-tractive:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-tractive.
Tractive 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
Tractive 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