Homebridge Smart-Home-Integration, kostenlos und Open Source
Brücke zu Homebridge: Zubehör (Steckdosen, Lampen, Sensoren, Rollos…) in Gladys, steuerbar.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Diese Integration verbindet Gladys mit deinem Homebridge und bietet das Zubehör all seiner Plugins im Reiter Entdecken von Gladys an: Lampen, Schalter und Steckdosen, Thermostate und Klimaanlagen, Rollos und Fenster, Ventilatoren, Ventile, Sensoren und Melder, Schlösser und Garagentore. Sobald ein Gerät hinzugefügt ist, folgen seine Werte Homebridge live, und Gladys steuert es über Homebridge, das seine Plugins behält (Hue, Tuya, Shelly, Ring, Cloud-Geräte…). Alles bleibt in deinem lokalen Netzwerk. Inoffiziell, nicht mit dem Homebridge-Projekt oder mit Apple verbunden.
Der Gladys-Kern hat bereits eine HomeKit-Integration, die in die andere Richtung arbeitet (Gladys-Geräte in der Apple-Home-App). Diese hier holt das Homebridge-Zubehör in Gladys.
Entwickelt mit Homebridge 2.4.0 und Homebridge UI 5.29.0 in Docker, mit dem virtuellen Zubehör von homebridge-dummy, nicht mit echter Hardware: Rückmeldungen sind im GitHub-Repository willkommen.
Voraussetzungen
- Homebridge mit seiner Weboberfläche (Homebridge UI, homebridge-config-ui-x 5.x), von der Gladys-Maschine aus erreichbar (gleiches Netzwerk oder VPN).
- Homebridge im Insecure-Modus: in der Homebridge-Oberfläche Einstellungen → Homebridge Settings → Homebridge Insecure Mode (mit hb-service standardmäßig an), dann Homebridge neu starten. Das braucht auch die Zubehör-Seite der Oberfläche: Diese liest und steuert das Zubehör über das HomeKit-Protokoll deiner eigenen Bridges, mit deren PIN. Jedes Programm in deinem Netzwerk, das die PIN kennt, kann dann dasselbe, ohne HomeKit-Kopplung.
- Ein Benutzer der Homebridge-Oberfläche für Gladys, ohne Zwei-Faktor-Authentifizierung (ein Einmalcode kann von einem Container nicht erneut eingegeben werden). Er muss kein Administrator sein: Lege in User Accounts einen eigenen Benutzer an.
Konfiguration
Adresse und Benutzer
- In der Homebridge-Oberfläche User Accounts → Add: ein Benutzer
gladys, ein starkes Passwort, kein Administrator. - Öffne in Gladys die Integration, Konfiguration:
- Adresse der Homebridge-Oberfläche: etwa
http://192.168.1.40:8581. Kein.local-Name, nichtlocalhost: Die Integration läuft in ihrem eigenen Container. - Benutzername und Passwort dieses Benutzers. Lass sie leer, wenn deine Oberfläche ohne Anmeldung läuft (Authentifizierung deaktiviert).
- Adresse der Homebridge-Oberfläche: etwa
- Klicke auf Verbindung testen: Die Homebridge-Version, die Zahl der angebotenen Geräte und die nicht importierten Dienste werden angezeigt.
- Öffne den Reiter Entdecken und füge die gewünschten Geräte hinzu. Deren Werte werden gleich nach dem Hinzufügen gesendet.
Auswählen, was importiert wird
Gladys bietet ein Gerät pro Homebridge-Zubehör an, mit den Funktionen all seiner Dienste (ein Sensor mit Temperatur, Luftfeuchtigkeit und Batterie ist ein Gerät).
- Nur dieses Zubehör: Namen durch Kommas getrennt,
*steht für beliebigen Text (Wohn*, Garage). Leer: alles Zubehör. - Auszulassendes Zubehör: nie importiert (
* battery, Test*).
Ein Name passt zum Namen des Zubehörs oder zu einem seiner Dienstnamen, unabhängig von Groß- und Kleinschreibung. Nur die in Gladys hinzugefügten Geräte erhalten Werte: Die anderen kosten nichts.
Schlösser, Garagentore und Alarmanlagen
Standardmäßig sind Schlösser, Garagentore, motorisierte Türen und Alarmanlagen (Sicherheitssysteme) in Gladys schreibgeschützt: Du siehst, ob sie verriegelt, offen oder geschlossen sind, aber Gladys kann sie weder öffnen noch entriegeln noch entschärfen, weder über ein Gerät noch über eine Szene noch über einen mit Gladys verbundenen Sprachassistenten. Jede Familie hat ihren eigenen Schalter in der Konfiguration: Befehle für Schlösser erlauben, Befehle für Garagentore und motorisierte Türen erlauben, Scharfschalten und Entschärfen der Alarmanlagen erlauben. Schalte nur das Nötige ein: Ein Fehler in einer Szene könnte dann dein Haus öffnen.
Optionen
- Mindestabstand zwischen zwei Werten eines Sensors: Ein Sensor, der jede Sekunde meldet, wird in diesem Takt gesendet (standardmäßig 10 Sekunden). Schalter, Lampen, Rollos und Melder werden nie verzögert.
- Sprache der Funktionsnamen: die Zusätze der Nebenfunktionen („Helligkeit“, „Batterie“…). Die Zubehörnamen bleiben wie in Homebridge.
Was du bekommst
Geräte
| Homebridge-Dienst (HAP) | In Gladys |
|---|---|
| Lightbulb | Lampe: Ein/Aus, Helligkeit, Farbe, Farbtemperatur (je nach Angebot) |
| Switch, Outlet | Schalter Ein/Aus |
| Fan, Fanv2, AirPurifier, HumidifierDehumidifier | Schalter Ein/Aus, Lüftergeschwindigkeit (%) |
| Valve, Faucet, IrrigationSystem, Television | Schalter Ein/Aus |
| Thermostat | Sollwert, Modus (aus, heizen, kühlen, auto), aktuelle Temperatur |
| HeaterCooler | Klimaanlage: Ein/Aus, Modus, Sollwert des aktuellen Modus |
| WindowCovering, Window | Rollo: öffnen, schließen (stoppen, wenn das Zubehör es kann), Position |
| Door | Position und offen oder geschlossen; Befehle nur, wenn erlaubt |
| LockMechanism | Schloss: verriegelt oder nicht; Befehle nur, wenn erlaubt |
| GarageDoorOpener | offen oder geschlossen; öffnen/schließen nur, wenn erlaubt |
| Temperatur-, Feuchte-, Licht-, CO2-, Feinstaubsensoren | Sensoren mit ihrer Einheit |
| Bewegungs-, Anwesenheits-, Öffnungs-, Leck-, Rauch-, CO-Melder | Binärsensoren (eine Öffnung ist 0, wenn offen, wie überall in Gladys) |
| Batterie, Batterie schwach, Manipulation | Batteriestand, Warnungen bei schwacher Batterie und Manipulation |
Andere Dienste (Kameras, Lautsprecher, TV-Eingänge…) listet der Verbindungstest als „nicht importiert“. Die Szenenaktion unten erreicht ihre Eigenschaften trotzdem.
Dashboard-Widget
Das Widget Homebridge zeigt die Verbindung, wie die Werte ankommen („Live“ über den Socket der Oberfläche oder „Abfrage“), die Homebridge-Version, die angebotenen und hinzugefügten Geräte, die verfolgten Dienste und einen Knopf Neu laden, der die Zubehörliste neu liest.
Szenen-Auslöser
- Homebridge-Taste gedrückt: Ein programmierbarer Schalter (StatelessProgrammableSwitch) oder eine Türklingel wurde gedrückt. Filter: Zubehör, Druck (einfach, doppelt, lang). Variablen: Zubehör, Taste, Druck. Braucht die Live-Aktualisierung: Ein Druck ist ein Ereignis, die Abfrage sieht ihn nicht.
- Homebridge-Alarm geändert: Ein Sicherheitssystem wurde scharf geschaltet (zu Hause, abwesend, Nacht), entschärft oder ausgelöst. Filter: Alarmanlage, neuer Zustand. Variablen: Zubehör, Zustand, vorheriger Zustand.
Szenen-Aktionen
- Homebridge-Alarm scharf schalten oder entschärfen: zu Hause, abwesend, Nacht oder entschärfen. Braucht Scharfschalten und Entschärfen der Alarmanlagen erlauben. Der Name ist nur bei mehreren Sicherheitssystemen nötig.
- Homebridge-Eigenschaft setzen: eine beliebige schreibbare Eigenschaft
eines beliebigen Zubehörs, auch eines nicht in Gladys hinzugefügten: den
Eingang eines Fernsehers (
ActiveIdentifier), das Schwenken eines Ventilators (SwingMode), einen Schalter (On,true). Die Namen sind die des HomeKit-Protokolls, wie die Homebridge-Oberfläche sie in den Details eines Zubehörs zeigt. Die Sicherheitsschalter gelten auch hier.
Szenen-Beispiele
- Wenn die Türklingel gedrückt wird (Auslöser), ein Kamerabild aufnehmen und an dein Handy senden.
- Wenn der Homebridge-Alarm „ausgelöst“ wird, alle Lampen einschalten und eine Nachricht senden.
- Werktags um 7 Uhr mit „Homebridge-Eigenschaft setzen“ den Eingang des Wohnzimmer-Fernsehers auf 3 stellen und den Thermostat-Sollwert auf 20 °C.
Fehlerbehebung
- „Homebridge läuft nicht im Insecure-Modus“: Aktiviere Homebridge Insecure Mode in den Homebridge-Einstellungen und starte Homebridge neu. Jede Minute folgt ein neuer Versuch.
- „Homebridge verweigert die Anmeldung“: Prüfe Benutzername und Passwort; ein Benutzer mit Zwei-Faktor-Authentifizierung ist nicht nutzbar. Nach 10 Fehlversuchen in 5 Minuten sperrt die Oberfläche das Konto für 5 Minuten: Die Integration versucht es nur alle 5 Minuten erneut.
- „Homebridge ist nicht erreichbar“: Prüfe die Adresse von der
Gladys-Maschine aus (
curl http://<Adresse>:8581/api/auth/settings). Ein neuer Versuch folgt nach 5 Sekunden, dann bis zu jede Minute. - Das Widget zeigt „Abfrage“: Der Socket der Oberfläche (
/socket.io) kommt nicht durch, oft wegen eines Reverse-Proxys ohne WebSocket. Die Werte kommen trotzdem alle 30 Sekunden an, Tastendrücke nicht. - Ein Zubehör fehlt: Starte den Verbindungstest, er listet die nicht importierten Dienste. Prüfe die einzuschließenden und auszulassenden Namen, und ob das Zubehör auf der Zubehör-Seite der Homebridge-Oberfläche erscheint.
- Logs: Setze
LOG_LEVEL=debug, um jeden empfangenen Wert zu sehen.
Grenzen
- Ohne echte Hardware entwickelt, mit homebridge-dummy: Rückmeldungen willkommen.
- Matter-Zubehör von Homebridge 2 wird nicht importiert (die REST-API der Oberfläche listet nur HomeKit-Zubehör).
- Das Lesen der Liste fragt jedes Zubehör nach seinen Werten: Ohne Socket geschieht das alle 30 Sekunden, was manche Cloud-Plugins schlecht vertragen.
- Das Zurücksetzen des Homebridge-Zubehör-Caches (oder ein geänderter Bridge-Benutzername) ergibt neue Kennungen: Die Geräte müssen neu hinzugefügt werden. Ein Umbenennen des Zubehörs nicht.
- Die Funktionsnamen werden beim Hinzufügen des Geräts in Gladys festgelegt.
- Die Sicherheitsschalter erkennen Schlösser, Garagentore, motorisierte Türen und Alarmanlagen an ihrem HomeKit-Typ: Ein Tor oder ein Türöffner, den ein Plugin als einfachen Schalter anbietet, bleibt ein gewöhnlicher Schalter. Lass ihn aus (Auszulassendes Zubehör nimmt ihn aus dem Reiter Entdecken; die Szenenaktion erreicht ihn weiter über seinen Namen).
Datenschutz
Die Brücke spricht nur mit deiner Homebridge-Oberfläche, in deinem Netzwerk. Das Passwort bewahrt Gladys in seiner Konfiguration auf, es wird nie in die Logs geschrieben; das Sitzungstoken lebt nur im Speicher. Nichts wird ins Internet gesendet.
Konfigurationseinstellungen
Diese Einstellungen fragt Homebridge in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Homebridge-Zubehör in Gladys | section | Nein | Gladys liest das Zubehör aller Homebridge-Plugins über die Homebridge-Oberfläche und verfolgt seine Änderungen live. Homebridge muss im Insecure-Modus laufen (Homebridge-Einstellungen), wie für die Zubehör-Seite der Oberfläche. Lege dort einen eigenen Benutzer ohne Zwei-Faktor-Authentifizierung an. Das Zubehör erscheint dann im Reiter Entdecken: Füge das gewünschte hinzu. |
| Adresse der Homebridge-Oberfläche | string | Ja | IP-Adresse und Port, von der Gladys-Maschine aus gesehen. Kein .local-Name, nicht localhost. |
| Benutzername | string | Nein | Ein Benutzer der Homebridge-Oberfläche; er muss kein Administrator sein. Leer, wenn die Oberfläche ohne Anmeldung läuft. |
| Passwort | secret | Nein | |
| Nur dieses Zubehör | string | Nein | Zubehörnamen, durch Kommas getrennt; * steht für beliebigen Text. Leer: alles Zubehör. |
| Auszulassendes Zubehör | string | Nein | Zubehörnamen, durch Kommas getrennt; * steht für beliebigen Text. Nie importiert. |
| Sicherheit | section | Nein | Schlösser, Garagentore, motorisierte Türen und Alarmanlagen zeigen immer ihren Zustand. Ausgeschaltet kann Gladys sie weder öffnen noch entriegeln noch entschärfen, über Gerät, Szene oder Sprachassistent. |
| Befehle für Schlösser erlauben | boolean | Nein | |
| Befehle für Garagentore und motorisierte Türen erlauben | boolean | Nein | |
| Scharfschalten und Entschärfen der Alarmanlagen erlauben | boolean | Nein | |
| Mindestabstand zwischen zwei Werten eines Sensors (s) | number | Nein | Ein Sensor, der jede Sekunde meldet, wird in diesem Takt an Gladys gesendet. Schalter und Melder werden nie verzögert. |
| Sprache der Funktionsnamen | select | Nein |
So installierst du Homebridge in Gladys
- Öffne in Gladys Integrationen: Homebridge erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-homebridge: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-homebridge.
Homebridge 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
Homebridge 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