Wallos Smart-Home-Integration, kostenlos und Open Source
Deine Wallos-Abonnements in Gladys: monatliche Kosten, nächste Zahlungen und Erinnerungen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Hol deine Abonnements in Gladys: was sie pro Monat und pro Jahr kosten, die nächsten Zahlungen und eine Erinnerung vor jeder, gelesen aus deinem eigenen Wallos, dem selbst gehosteten Abo-Tracker.
Die Integration liest nur: sie schreibt nie in Wallos, legt kein Abonnement an und ändert keines. Die Integration spricht direkt in deinem Netzwerk mit deinem Wallos, mit deinem API-Schlüssel. Nicht mit Wallos verbunden.
Was du bekommst
- Ein Gerät Wallos: monatliche Kosten und geschätzte Jahreskosten deiner aktiven Abonnements (in deiner Hauptwährung), Anzahl aktiver Abonnements, Tage bis zur nächsten Zahlung und ihr Name.
- Ein Gerät pro aktivem Abonnement: Preis einer Zahlung, Tage bis zur nächsten Zahlung und ihr Datum.
- Ein Dashboard-Widget: die monatlichen und jährlichen Kosten, dann die nächsten 8 Zahlungen.
- Ein Szenenauslöser: eine Zahlung heute, morgen, in 3 oder 7 Tagen.
- Eine Szenenaktion: die Zahlungen der nächsten 7, 14 oder 31 Tage lesen, als Satz zum Senden per Nachricht oder zum Vorlesen.
Voraussetzungen
- Gladys Assistant 5.1 oder neuer.
- Wallos (getestet mit 5.10.0), vom Gladys-Rechner aus erreichbar (gleiches Netzwerk, VPN oder öffentliche Adresse).
- Der API-Schlüssel deines Wallos-Benutzers.
Konfiguration
Den API-Schlüssel finden
- Öffne in Wallos dein Profil (das Menü unter deinem Avatar).
- Der Abschnitt API Key zeigt deinen Schlüssel: kopiere ihn vollständig.
Der Schlüssel gibt Zugriff auf alle Abonnements deines Benutzers: halte ihn so geheim wie dein Passwort. Die Integration sendet ihn im Rumpf ihrer Anfragen, nie in der Adresse: er erscheint daher nicht in den Protokollen eines Reverse-Proxys.
Einstellungen
| Einstellung | Wirkung |
|---|---|
| Adresse von Wallos | Die Adresse, unter der du Wallos öffnest, z. B. http://192.168.1.20:8282 oder https://abos.mein.zuhause |
| API-Schlüssel | Der oben kopierte Schlüssel |
| Selbstsigniertes Zertifikat akzeptieren | Nur für eine https-Adresse, deren Zertifikat du selbst erstellt hast |
| Aktualisierungsintervall | 15 oder 30 Minuten, 1 Stunde (Standard), 3 oder 6 Stunden |
| Sprache der Texte | Namen der Funktionen (bei ihrer Erstellung) und Sätze der Szenen |
Speichere und klicke dann auf Verbindung testen: die Antwort nennt die Version von Wallos, die Anzahl aktiver Abonnements und ihre monatlichen Kosten. Öffne dann den Tab Entdecken und füge das Gerät Wallos und die Abonnements hinzu, denen du in Gladys folgen willst.
Geräte
| Gerät | Funktionen |
|---|---|
| Wallos | Monatliche Kosten, Geschätzte Jahreskosten, Aktive Abonnements, Tage bis zur nächsten Zahlung, Nächste Zahlung (Name und Datum) |
| Abonnement | Preis, Tage bis zur Zahlung, Datum der nächsten Zahlung |
Die monatlichen Kosten werden wie auf der Statistikseite von Wallos berechnet: eine wöchentliche Zahlung zählt 4,35-mal im Monat, eine jährliche zu einem Zwölftel, eine einmalige gar nicht; Preise in einer anderen Währung werden mit den Wechselkursen von Wallos umgerechnet (richte sie in Wallos mit einem Fixer-Schlüssel ein, sonst zählen sie 1 zu 1). Die Jahreskosten sind das Zwölffache der monatlichen Kosten.
Beträge in Euro, Dollar oder Pfund zeigen ihre Einheit; eine andere Währung wird an den Gerätenamen gehängt
(Fitnessstudio (CHF)). Nur aktive Abonnements werden aufgeführt. Liegt das Zahlungsdatum eines Abonnements
in der Vergangenheit (automatische Verlängerung aus), bleibt das Datum, die Anzahl Tage wird nicht mehr aktualisiert: sie behält ihren letzten Wert.
Um gewarnt zu werden, wenn die monatlichen Kosten eine Schwelle überschreiten, nutze den Standardauslöser von Gladys „Gerätezustand ändert sich“ auf den Monatlichen Kosten des Geräts Wallos, mit der Bedingung „größer“: kein Auslöser der Integration nötig.
Dashboard-Widget
Wallos: nächste Zahlungen zeigt die monatlichen und geschätzten Jahreskosten, dann die nächsten 8 Zahlungen, die nächste zuerst: das Abonnement, Preis und Datum, und ein Abzeichen „heute“ in Rot, „morgen“ oder innerhalb von 3 Tagen in Orange. Tippe auf eine Zahlung, um ihre Kategorie zu sehen. Die Fußzeile nennt die Uhrzeit der letzten Abfrage. Es umfasst alle aktiven Abonnements von Wallos, ob zu Gladys hinzugefügt oder nicht.
Szenenauslöser
Wallos: Zahlung bald fällig: eine Zahlung eines aktiven Abonnements ist heute, morgen, in 3 oder 7 Tagen fällig (eins davon wählen). Lass Abonnement leer, um für alle gewarnt zu werden, oder wähle ein zu Gladys hinzugefügtes Abonnement (nicht das Gerät Wallos, das nie passt). Er löst einmal pro Abonnement und Zahlungsdatum aus, an diesem Tag, bei der ersten Abfrage des Tages. Variablen: Name des Abonnements, Preis, Währung, Zahlungsdatum (JJJJ-MM-TT) und ein fertiger Satz.
Was ausgelöst wurde, bleibt in den Daten der Integration: ein Neustart löst nichts zweimal aus.
Szenenaktionen
Wallos: nächste Zahlungen lesen: die Zahlungen der nächsten 7, 14 oder 31 Tage, die nächste zuerst, mit
Preis, dann die Summe in deiner Hauptwährung. Ausgaben: text, count, total.
Die Aktion liest Wallos erneut, wenn die letzte Abfrage älter als das Aktualisierungsintervall ist.
Szenenbeispiele
- Erinnerung vor einer Zahlung: Auslöser „Zahlung bald fällig“, 3 Tage, alle Abonnements; Aktion: eine
Nachricht mit
{{triggerEvent.data.text}}senden. - Überblick am Montagmorgen: jeden Montag um 8 Uhr Aktion „nächste Zahlungen lesen“, 7 Tage, dann ihren
textvom Lautsprecher in der Küche vorlesen lassen. - Budget im Blick: Auslöser „Gerätezustand ändert sich“ auf den monatlichen Kosten, größer als 100; Aktion: die Familie auf Telegram benachrichtigen.
Datenschutz und Daten
- Die Integration liest Wallos und schreibt nie hinein.
- Der API-Schlüssel wird von Gladys wie jede geheime Einstellung gespeichert und nie in die Protokolle geschrieben.
- Die Protokolle enthalten nie einen Betrag, einen Abonnementnamen oder die Adresse von Wallos, auch nicht auf Debug-Ebene: nur Anzahlen, Kennungen und Anzahlen von Tagen.
- Die Namen der Abonnements werden zu Gerätenamen, die du umbenennen kannst.
- Das Datenvolumen der Integration behält nur die schon gesendeten Erinnerungen (Kennungen und Daten).
Fehlerbehebung
| Meldung | Was zu tun ist |
|---|---|
| Wallos lehnt den API-Schlüssel ab | Der Schlüssel wurde nur teilweise kopiert oder stammt aus einem anderen Wallos: kopiere ihn erneut |
| Wallos antwortet nicht | Prüfe die Adresse vom Gladys-Rechner aus (Port, http/https) und ob Wallos läuft |
| Das Zertifikat von Wallos ist nicht vertrauenswürdig | Nutze die http-Adresse im lokalen Netz oder aktiviere „Selbstsigniertes Zertifikat akzeptieren“ |
| Diese Adresse antwortet nicht wie die API | Die Adresse führt auf eine andere Seite (Anmeldeportal, Reverse-Proxy): gib die von Wallos an |
| Ein Gerät hat keinen Wert | Füge es im Tab „Entdecken“ hinzu: nur hinzugefügte Geräte erhalten Zustände |
Die Protokolle der Integration (Integrationen → Wallos → Protokolle) sagen, was passiert ist; setze
LOG_LEVEL=debug für mehr Details.
Grenzen
- Nur lesend: von Gladys aus lässt sich kein Abonnement anlegen oder ändern.
- Ein Wallos, ein Benutzer (der des API-Schlüssels); die anderen Mitglieder eines Haushalts werden nicht getrennt gelesen.
- Die Zahlungsdaten sind die, die Wallos führt: Wallos schiebt sie einmal täglich mit einer eigenen Aufgabe weiter.
- Die Erinnerung kommt bei der ersten Abfrage des Tages: bis zu ein Aktualisierungsintervall nach Mitternacht.
- Getestet mit einem echten Wallos 5.10.0 in Docker, noch nicht auf einer Gladys-Installation mit einem echten Wallos: Rückmeldungen willkommen.
Konfigurationseinstellungen
Diese Einstellungen fragt Wallos in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Verbindung zu Wallos | section | Nein | Öffne in Wallos dein Profil, kopiere deinen API-Schlüssel und füge ihn unten mit der Adresse von Wallos ein. Füge dann das Gerät Wallos und die gewünschten Abonnements im Tab „Entdecken“ hinzu. |
| Adresse von Wallos | string | Ja | Die Adresse, unter der du Wallos öffnest, von Gladys aus erreichbar. |
| API-Schlüssel | secret | Ja | Wallos → Profil → API Key. Nur lesend: die Integration schreibt nie in Wallos. Von Gladys gespeichert, nie in die Protokolle geschrieben. |
| Selbstsigniertes Zertifikat akzeptieren | boolean | Nein | Nur für eine https-Adresse, deren Zertifikat du selbst erstellt hast. |
| Aktualisierungsintervall | select | Nein | Wie oft Wallos gelesen wird. Abonnements ändern sich selten: eine Stunde reicht. |
| Sprache der Texte | select | Nein | Namen der Funktionen (bei ihrer Erstellung) und Texte für die Szenen. |
So installierst du Wallos in Gladys
- Öffne in Gladys Integrationen: Wallos erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-wallos: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-wallos.
Wallos 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
Wallos 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