Homebox Smart-Home-Integration, kostenlos und Open Source
Dein Homebox-Inventar: Gegenstände, Gesamtwert, ablaufende Garantien, fällige Wartungen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Verfolge das Inventar deines Zuhauses in Gladys mit Homebox, dem selbst gehosteten Inventar- und Ordnungssystem: wie viele Gegenstände du besitzt, was sie wert sind, welche Garantien bald ablaufen und welche Wartungen anstehen. Alles bleibt in deinem lokalen Netzwerk: Gladys spricht direkt mit Homebox und liest es nur.
Getestet mit echten Homebox-Servern, 0.26.2 und 0.21.0 (das offizielle Docker-Image). Rückmeldungen sind im Gladys-Forum willkommen.
Voraussetzungen
- Gladys Assistant 5.1 oder neuer.
- Ein Homebox-Server, der vom Gladys-Rechner aus erreichbar ist, standardmäßig auf Port 7745, oder hinter einem Reverse-Proxy.
- Ab Homebox 0.26: ein API-Schlüssel (Homebox → dein Profil → API-Schlüssel). Bei einem älteren Homebox: E-Mail und Passwort eines Homebox-Benutzers. Die Integration sieht das Inventar (die „Gruppe“) dieses Benutzers.
Konfiguration
- Öffne den Reiter Konfiguration der Integration.
- Gib unter Homebox-Adresse die IP-Adresse des Servers ein, zum Beispiel
192.168.1.50: Die Integration nutzt dann Port 7745. Füge einen Port hinzu, wenn deiner abweicht (192.168.1.50:3100). Hinter einem Reverse-Proxy gibst du die vollständige Adresse ein (https://example.org/homebox). - Füge einen API-Schlüssel ein, oder fülle E-Mail und Passwort aus. Der API-Schlüssel hat Vorrang, wenn beides ausgefüllt ist.
- Garantie endet innerhalb (Tage): Eine Garantie gilt so viele Tage vor ihrem Ende als bald ablaufend (standardmäßig 30).
- Anstehende Wartung innerhalb (Tage): wie weit im Voraus eine geplante Wartung als anstehend gilt (standardmäßig 7).
- Ein Gerät pro Ort (standardmäßig aus) fügt für jeden Hauptort von Homebox ein Gerät hinzu.
- Homebox lesen alle: 5, 15 (Standard), 30 oder 60 Minuten.
- Sprache der Namen und Meldungen legt die Namen der Funktionen (beim Hinzufügen des Geräts festgelegt), die Texte und die Daten der Szenenvariablen fest. Standardmäßig Französisch.
- Speichere, dann nutze Verbindung testen: Das zeigt die Homebox-Version und die Anzahl der Gegenstände und Orte.
- Füge im Reiter Entdecken die Geräte hinzu, die du verfolgen willst.
Geräte
Homebox (ein Gerät für dein Inventar):
| Funktion | Wert |
|---|---|
| Gegenstände | Anzahl der Gegenstände, ohne archivierte |
| Orte | Anzahl der Orte |
| Gesamtwert | Kaufpreis × Menge jedes Gegenstands, in der Währung der Gruppe |
| Bald ablaufende Garantien | Gegenstände, deren Garantie im eingestellten Fenster endet |
| Überfällige Wartungen | geplante Wartungen, deren Datum vorbei ist |
| Anstehende Wartungen | geplante Wartungen im eingestellten Fenster |
| Nächste Wartung | Name, Gegenstand und Datum der nächsten Wartung, oder „Keine“ |
| Nächstes Garantieende | Gegenstand und Datum der nächsten ablaufenden Garantie, oder „Keine“ |
Gladys hat eine Einheit für Euro, Dollar und Pfund Sterling; eine andere Währung erscheint im Namen der Funktion, zum Beispiel „Gesamtwert (CHF)“. Lebenslange Garantien enden nie; bereits abgelaufene Garantien werden nicht gezählt.
Ein Ort (Option): Gegenstände (Anzahl der dort gelagerten Gegenstände, Unterorte eingeschlossen) und Wert. Nur die Hauptorte bekommen ein Gerät.
Dashboard-Widget
Hausinventar: vier Kacheln (Gegenstände, Wert, Garantien, fällige Wartungen) und die Liste dessen, was als Nächstes ansteht, das Früheste zuerst: überfällige Wartungen (rot), anstehende Wartungen, ablaufende Garantien. Nur lesend.
Szenen-Auslöser
- Garantie läuft bald ab: Die Garantie eines Gegenstands erreicht das eingestellte Fenster. Einmal pro Gegenstand und Enddatum. Variablen: Gegenstand, Ort, Enddatum, verbleibende Tage.
- Wartung fällig: Eine geplante Wartung erreicht ihr Datum, ohne erledigt zu sein. Einmal pro Wartung. Variablen: Wartung, Gegenstand, geplantes Datum, Tage überfällig.
Das erste Lesen nach der Installation ist still: Was bereits ansteht, wird am Gerät angezeigt, nicht angekündigt. Die Auslöser feuern beim ersten Lesen nach der Änderung (nach Mitternacht, im eingestellten Intervall).
Szenen-Aktionen
Gegenstand in Homebox suchen: Gib einen Namen an (AA-Batterien); die
Aktion liest Homebox und liefert Gefunden, Passende Gegenstände,
Gegenstand, Ort (der vollständige Pfad, Garage / Regal) und
Menge. Der genaue Name hat Vorrang, dann die Namen, die ihn enthalten;
archivierte Gegenstände werden ignoriert.
Szenen-Beispiele
- Wartungserinnerung: Auslöser „Wartung fällig“ → Nachricht senden „Zeit für {{triggerEvent.data.maintenance}} an {{triggerEvent.data.item}}“.
- Garantie: Auslöser „Garantie läuft bald ab“ → Nachricht „Die Garantie von {{triggerEvent.data.item}} endet am {{triggerEvent.data.expires}}“.
- Bestand prüfen: jeden Sonntag um 10:00 → „Gegenstand in Homebox suchen“
(
AA-Batterien) → nur fortfahren, wenn die Menge unter 4 liegt → Nachricht „Nur noch wenige AA-Batterien (gelagert in …)“.
Fehlerbehebung
- „Zugriff verweigert“: Prüfe den API-Schlüssel (er kann abgelaufen oder in Homebox gelöscht sein), oder E-Mail und Passwort. API-Schlüssel gibt es erst ab Homebox 0.26: Bei einer älteren Version nutzt du E-Mail und Passwort.
- „Homebox antwortet nicht“: Prüfe Adresse und Port vom Gladys-Rechner
aus. Der Container läuft in einem Bridge-Netzwerk:
localhostist der Container selbst, gib stattdessen die IP-Adresse des Servers ein. - „Diese Adresse antwortet nicht wie Homebox“: Eine Anmeldeseite eines Proxys antwortet anstelle von Homebox. Gib die Adresse von Homebox selbst ein, oder lass den Gladys-Rechner durch den Proxy.
- Für mehr Details in den Protokollen der Integration setze
LOG_LEVEL=debug.
Grenzen
- Nur lesend: Die Integration ändert dein Inventar nie.
- Jedes Lesen sind etwa fünf Anfragen (darunter der CSV-Export des ganzen Inventars): Wähle bei einem sehr großen Inventar ein langes Intervall.
- Eine einzige Homebox-Gruppe, die des API-Schlüssels oder Benutzers.
- Nicht mit dem Homebox-Projekt verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Homebox in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Homebox verbinden | section | Nein | Gib die Adresse deines Homebox-Servers ein (standardmäßig Port 7745). Ab Homebox 0.26 erstellst du in deinem Homebox-Profil einen API-Schlüssel und fügst ihn unten ein. Bei einem älteren Homebox gibst du stattdessen E-Mail und Passwort eines Homebox-Benutzers ein. Die Integration liest dein Inventar nur. |
| Homebox-Adresse | string | Ja | |
| API-Schlüssel (Homebox 0.26+) | secret | Nein | Profil → API-Schlüssel in Homebox. Leer lassen, um E-Mail und Passwort zu nutzen. |
| E-Mail (ohne API-Schlüssel) | string | Nein | |
| Passwort (ohne API-Schlüssel) | secret | Nein | |
| Garantie endet innerhalb (Tage) | number | Nein | Eine Garantie gilt so viele Tage vor ihrem Ende als bald ablaufend. |
| Anstehende Wartung innerhalb (Tage) | number | Nein | |
| Ein Gerät pro Ort | boolean | Nein | Anzahl der Gegenstände und Wert jedes Hauptorts, Unterorte eingeschlossen. |
| Homebox lesen alle | select | Nein | |
| Sprache der Namen und Meldungen | select | Nein | Die Namen der Funktionen werden beim Hinzufügen eines Geräts zu Gladys festgelegt. |
So installierst du Homebox in Gladys
- Öffne in Gladys Integrationen: Homebox erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-homebox:1.0.0) 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-homebox.
Homebox 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
Homebox 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