Weenect Smart-Home-Integration, kostenlos und Open Source
Weenect-GPS-Tracker für Katzen, Hunde, Kinder und Senioren: Zonen, Batterie, Klingeln.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Verfolge deine Weenect-GPS-Tracker (Katze, Hund, Kind, Senioren) in Gladys: die Zone, in der sie sind (Zuhause, Garten, Schule …), die Batterie, die letzte Position, und lass sie über ein Dashboard oder eine Szene klingeln oder vibrieren.
Ohne die Hardware entwickelt: Diese Integration wurde anhand der API der Weenect-App und der entsprechenden Home-Assistant-Integration geschrieben, ohne Weenect-Tracker oder -Konto. Rückmeldungen sind im Gladys-Forum oder in den GitHub-Issues willkommen.
Community-Integration, nicht mit Weenect verbunden.
Überblick
Jeder Tracker deines Weenect-Kontos wird ein Gladys-Gerät. Die Integration fragt die Weenect-Cloud in regelmäßigen Abständen ab (standardmäßig jede Minute) und veröffentlicht:
- in welcher Zone der Tracker ist, nach den Zonen, die du in der Weenect-App gezeichnet hast („Zuhause“, „Garten“, „Schule“ …);
- seinen Batteriestand und einen Alarm Niedriger Batteriestand bei der in der Weenect-App eingestellten Schwelle;
- ob er online oder offline ist;
- seine letzte Position (Koordinaten, Genauigkeit, Uhrzeit), außer du entscheidest dich, nur die Zonen zu behalten.
Dazu kommen zwei Szenen-Auslöser (betritt und verlässt eine Zone), eine Szenen-Aktion zum Starten von Super-Live und ein Dashboard-Widget.
Voraussetzungen
- Gladys 5.1.0 oder neuer.
- Ein Weenect-Tracker mit aktivem Abo und das Konto der Weenect-App (E-Mail und Passwort). Ein über Google oder Apple angelegtes Konto hat vielleicht kein Passwort: Lege eines in der Weenect-App oder auf der Weenect-Website fest („Passwort vergessen“).
- Die Zonen, die du verfolgen willst, in der Weenect-App angelegt.
- Gladys braucht Internetzugang (
apiv4.weenect.com).
Konfiguration
- Installiere die Integration über Integrationen → Von GitHub installieren (oder aus dem Katalog, sobald sie dort steht).
- Gib im Reiter Konfiguration die E-Mail und das Passwort deines Weenect-Kontos ein.
- Wähle, was Gladys von der Position behält:
- Koordinaten und Zonen (Standard): die Position, ihre Genauigkeit und ein Kartenlink;
- Nur Zonen: Gladys weiß, ob der Tracker in einer Zone ist, aber nie, wo er ist (siehe „Datenschutz“).
- Wähle das Aktualisierungsintervall (30 Sekunden bis 10 Minuten, standardmäßig 1 Minute) und die Sprache der Texte (standardmäßig Französisch).
- Speichere und klicke dann auf Verbindung testen: Der Button zeigt die Anzahl der gefundenen Tracker.
- Öffne den Reiter Entdecken und füge deine Tracker zu Gladys hinzu. Die Werte kommen sofort.
Die Funktionsnamen werden beim Hinzufügen festgelegt, in der Sprache, die in diesem Moment eingestellt ist.
Geräte
Ein Gerät pro Tracker, mit diesen Funktionen:
| Funktion | Was sie anzeigt |
|---|---|
| Position | „45.76400, 4.83570“, oder „Ausgeblendet“ im Modus „Nur Zonen“ |
| Genauigkeit der Position | Unsicherheitsradius der letzten Position, in Metern |
| Letzte Position | Datum und Uhrzeit der letzten Position, die der Tracker gesendet hat |
| Batterie | Batteriestand in % |
| Niedriger Batteriestand | Ja, wenn die Batterie unter die Alarmschwelle der Weenect-App fällt |
| Online | Ja, wenn der Tracker mit Weenect kommuniziert |
| Status | Online, offline oder Super-Live (aus Gladys gestartet) |
| In einer Zone | Ja, wenn der Tracker in mindestens einer seiner Zonen ist |
| Aktuelle Zone | Name der Zone (die kleinste, wenn mehrere), oder „Außerhalb der Zonen“ |
| Zone: Zuhause (eine pro Zone) | Ja, wenn der Tracker in dieser Zone ist |
| Klingeln lassen | Button: Der Tracker klingelt (wenn das Modell es kann) |
| Vibrieren lassen | Button: Der Tracker vibriert (wenn das Modell es kann) |
| Position anfordern | Button: Der Tracker sendet so bald wie möglich eine neue Position |
Eine später in der Weenect-App angelegte Zone erscheint im Reiter Entdecken mit einem Button Aktualisieren: Ein Klick fügt sie dem Gerät hinzu. Eine umbenannte Zone behält ihre Funktion (Gladys erkennt sie an ihrer ID, nicht an ihrem Namen).
Widget
Das Widget Weenect-Tracker fügst du im Dashboard-Editor hinzu.
- Ohne Einstellung listet es alle zu Gladys hinzugefügten Tracker auf: Name, Zone, Batterie (grüne, orange oder rote Plakette). Ein Tippen auf einen Tracker zeigt die Details (Status, Uhrzeit der letzten Position, Genauigkeit) und den OpenStreetMap-Link.
- Mit einem gewählten Tracker zeigt es seine Batterie live, seine Zone, seinen Status und Buttons: Karte, Klingeln, Vibrieren und Super-Live (mit Bestätigung).
Szenen-Auslöser
- Weenect-Tracker betritt eine Zone
- Weenect-Tracker verlässt eine Zone
Beide lassen sich nach Tracker und Zonenname filtern (leer: jede Zone). Schreib den Zonennamen genau wie in der Weenect-App. Die Aktionen der Szene können den Namen des Trackers, die Zone, die Batterie und den Kartenlink nutzen (leer im Modus „Nur Zonen“).
Warum Auslöser zusätzlich zu den Funktionen „Zone: …“? Eine einzige Szene reicht für „irgendein Tracker verlässt irgendeine Zone“, und die Nachricht kann sagen, welcher und wo. Für „ist die Katze zu Hause?“ als Bedingung nimm lieber die Funktion Zone: Zuhause oder In einer Zone.
Kein Auslöser „Niedriger Batteriestand“: Die Funktion Niedriger Batteriestand reicht (Auslöser „ein Gerätewert ändert sich“).
Szenen-Aktion
Weenect-Super-Live starten: Der Tracker sendet etwa 5 Minuten lang alle paar Sekunden eine Position. Währenddessen fragt Gladys das Konto alle 10 Sekunden ab. Super-Live leert den Akku schnell: Die Integration startet es nie von selbst, nur aus einer Szene oder dem Widget.
Szenen-Beispiele
- Die Katze hat den Garten verlassen: Auslöser „Weenect-Tracker verlässt eine Zone“, Tracker „Minou“, Zone „Garten“ → Nachricht „Minou hat den Garten verlassen“, ergänzt um die Variablen „Batterie (%)“ und „Kartenlink“.
- Die Kinder sind aus der Schule zurück: Auslöser „Weenect-Tracker betritt eine Zone“, Zone „Zuhause“, an Wochentagen zwischen 16 und 18 Uhr → Nachricht mit der Variable „Name des Trackers“: „… ist zu Hause“.
- Der Hund ist nachts ausgebüxt: Auslöser „Weenect-Tracker verlässt eine Zone“, Zone „Zuhause“, Bedingung „es ist Nacht“ → Weenect-Super-Live auf diesem Tracker starten, dann den Kartenlink senden.
- Ans Laden denken: „Niedriger Batteriestand“ des Halsbands wird Ja → Nachricht am Abend.
Datenschutz
Die Position eines Kindes oder Angehörigen ist eine sensible Information.
- Im Modus Nur Zonen werden die Koordinaten bei Weenect gelesen, um die Zonen im Container der Integration zu berechnen, und verlassen ihn nie: keine Positionsfunktion (sie zeigt „Ausgeblendet“), kein Kartenlink im Widget oder in Szenen. Der Wechsel zu „Nur Zonen“ ersetzt sofort die letzte Position, die Gladys gespeichert hatte.
- In jedem Modus landen keine Koordinaten, keine E-Mail, kein Passwort und
kein Token in den Protokollen, auch nicht mit
LOG_LEVEL=debug. - Die Funktion Position ist ein Text: Gladys speichert keinen Verlauf, nur den letzten Wert.
- Das Weenect-Sitzungstoken liegt im Volume
/datader Integration (keine neue Anmeldung bei jedem Start), mit einem Fingerabdruck der E-Mail, nie der E-Mail oder dem Passwort.
Aktualisierung und API-Grenzen
- Eine Abfrage = ein Aufruf der Weenect-Cloud für das ganze Konto, dazu alle 30 Minuten ein Aufruf pro Tracker, um die Zonen neu zu lesen.
- Gladys fragt das Konto nur ab, wenn mindestens ein Tracker hinzugefügt ist.
- Weenect veröffentlicht weder Nutzungsbedingungen noch ein Kontingent für seine API. Zur Sicherheit: höchstens alle 30 Sekunden (die Home-Assistant-Integration fragt ebenfalls alle 30 Sekunden ab), alle 10 Sekunden nur während eines aus Gladys gestarteten Super-Live. Antwortet Weenect mit „zu viele Anfragen“, pausieren die Abfragen so lange wie verlangt (standardmäßig 5 Minuten).
- Ein abgelehntes Passwort stoppt die Versuche bis zur nächsten Änderung der Konfiguration: Eine Schleife abgelehnter Anmeldungen könnte das Konto sperren.
- Der Tracker selbst sendet Positionen im Rhythmus, der in der Weenect-App eingestellt ist: Häufigere Abfragen machen die Position nicht aktueller.
Fehlerbehebung
- „Weenect lehnt die E-Mail oder das Passwort ab“: Prüfe sie in der Weenect-App, korrigiere die Konfiguration und speichere; Verbindung testen versucht es sofort erneut.
- „Weenect ist gerade nicht erreichbar“: Gladys versucht es bei jeder Aktualisierung erneut; prüfe den Internetzugang des Gladys-Rechners.
- Kein Tracker im Reiter Entdecken: Klicke auf Verbindung testen; einen Tracker ohne aktives Abo liefert Weenect eventuell nicht.
- Eine Zone fehlt: Lege sie in der Weenect-App an, öffne dann den Reiter Entdecken und klicke auf Aktualisieren.
- Der Auslöser startet nicht: Der Zonenname im Filter muss genau wie in der App geschrieben sein. Das Verlassen einer Zone wird erst erkannt, wenn die Position weit genug vom Rand entfernt ist (ihre Genauigkeit, 25 bis 100 m).
- Mehr Details: Setze
LOG_LEVEL=debugin den Variablen des Containers; die Protokolle zeigen jede Abfrage, ohne Position oder Geheimnis.
Grenzen
- Die Karte von Gladys 5.2 zeigt nur die Benutzer, Häuser und Zonen von Gladys, keine Geräte: Die Position wird als Text veröffentlicht, die Karte öffnet sich über einen OpenStreetMap-Link.
- Die Zone berechnet Gladys aus der letzten Position und den Zonen der Weenect-App (Mittelpunkt und Radius) und kann daher um einige Meter von den Alarmen der Weenect-App abweichen.
- Gladys kennt Super-Live nur, wenn es aus Gladys gestartet wurde; seine Dauer (etwa 5 Minuten) ist eine Schätzung.
- Keine Einstellung des Ortungsmodus, der Zonen, der SOS-Kontakte oder des SOS-Knopfs aus Gladys, das bleibt alles in der Weenect-App.
- Die Weenect-API ist nicht öffentlich und kann sich ohne Vorankündigung ändern.
- Ohne die Hardware entwickelt: Modelle nur gegen die API-Antworten getestet,
die die Bibliothek
aioweenectveröffentlicht.
Konfigurationseinstellungen
Diese Einstellungen fragt Weenect in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Weenect-Konto | section | Nein | Nutze die E-Mail und das Passwort der Weenect-App. Gladys liest deine Tracker aus der Weenect-Cloud. Nicht mit Weenect verbunden. |
| Weenect-E-Mail | string | Ja | |
| Weenect-Passwort | secret | Ja | |
| Was Gladys von der Position behält | select | Nein | „Nur Zonen“: Gladys weiß, ob ein Tracker in einer Zone ist, aber nie seine Koordinaten (kein Kartenlink). |
| Aktualisierungsintervall | select | Nein | Wie oft Gladys das Weenect-Konto abfragt. Der Tracker sendet Positionen im Rhythmus, der in der Weenect-App eingestellt ist. |
| Sprache der Texte | select | Nein | Sprache der Funktionsnamen (beim Hinzufügen eines Geräts festgelegt) und der Texte, die die Integration veröffentlicht. |
So installierst du Weenect in Gladys
- Öffne in Gladys Integrationen: Weenect erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-weenect: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-weenect.
Weenect 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
Weenect 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