Zum Hauptinhalt springen

Home Assistant Smart-Home-Integration, kostenlos und Open Source

Home Assistant-Integration für Gladys Assistant

Brücke zu Home Assistant: Lampen, Rollläden, Thermostate und Sensoren importieren und steuern.

Auf GitHub ansehenAlle Integrationen

Diese Integration verbindet Gladys mit deinem Home Assistant und bietet dessen Geräte im Reiter Entdecken von Gladys an: Lampen, Schalter und Steckdosen, Rollläden, Thermostate, Sensoren, Melder, Mediaplayer, Ventilatoren und Schlösser. Sobald ein Gerät hinzugefügt ist, folgen seine Zustände Home Assistant live, und Gladys steuert es über Home Assistant, das seine Zigbee-, Z-Wave-, Matter-, WLAN- und Cloud-Integrationen behält. Wechsle in deinem Tempo zu Gladys, Raum für Raum, oder betreibe beide nebeneinander. Alles bleibt in deinem lokalen Netzwerk. Inoffiziell, nicht mit dem Projekt Home Assistant oder Nabu Casa verbunden.

Getestet mit Home Assistant 2026.10 (seinen Demo-Entitäten), noch nicht mit vielen echten Installationen: Deine Rückmeldungen sind im GitHub-Repository willkommen.

Voraussetzungen​

  • Ein aktuelles Home Assistant (getestet mit 2026.10), von der Gladys-Maschine aus erreichbar (gleiches Netzwerk oder VPN).
  • Ein langlebiges Zugriffstoken, am besten von einem Administratorkonto: Nur ein Administrator kann die Geräte und Bereiche von Home Assistant lesen. Ohne ihn wird jede Entität ein eigenes Gerät, und der Bereichsfilter wirkt nicht.

Konfiguration​

Adresse und Token​

  1. Öffne in Home Assistant dein Profil (unten links), Reiter Sicherheit, dann Langlebige Zugriffstoken → Token erstellen. Nenne es „Gladys“ und kopiere das Token: Home Assistant zeigt es nur einmal.
  2. Öffne in Gladys die Integration, Konfiguration:
    • Adresse von Home Assistant: zum Beispiel http://192.168.1.20:8123 oder https://ha.example.org hinter einem Reverse-Proxy. Kein .local-Name, nicht localhost: Die Integration läuft in ihrem eigenen Container.
    • Langlebiges Zugriffstoken: einfügen.
  3. Klicke auf Verbindung testen: Die Version von Home Assistant, die Zahl der angebotenen Geräte und die nicht importierten Entitätstypen werden angezeigt.
  4. Öffne den Reiter Entdecken und füge die gewünschten Geräte hinzu. Deren Werte werden sofort nach dem Hinzufügen gesendet.

Auswahl des Imports​

Eine Home-Assistant-Installation hat oft Hunderte von Entitäten. Gladys bietet nur an:

  • die angekreuzten Entitätstypen (Lampen, Schalter, Rollläden, Thermostate, Sensoren, Melder, Mediaplayer, Ventilatoren, Schlösser, Schalter-Helfer);
  • in den aufgeführten Bereichen, falls angegeben (Namen durch Kommas getrennt, wie Wohnzimmer, Küche);
  • nie die Entitäten aus Auszulassende Entitäten (sensor.*_signal_strength, * steht für beliebigen Text);
  • dazu die trotzdem zu importierenden Entitäten, unabhängig von Typen und Bereichen.

Deaktivierte und ausgeblendete Entitäten sowie Konfigurations- und Diagnose-Entitäten (Helligkeit einer LED, Signalstärke) werden ausgelassen, außer den Batteriestand-Werten. Nur die in Gladys hinzugefügten Geräte erhalten Zustände: Die anderen kosten nichts.

Schlösser, Garagentore und Tore​

Standardmäßig sind Schlösser und die Rollläden, die Home Assistant als Garagentor, Tor oder Tür einstuft, in Gladys schreibgeschützt: Du siehst, ob sie verriegelt, offen oder geschlossen sind, aber weder ein Gerät noch eine Szene noch ein mit Gladys verbundener Sprachassistent kann sie öffnen. Kreuze Befehle für Schlösser, Garagentore und Tore erlauben an, um sie zu steuern (dann im Reiter Entdecken bei diesen Geräten auf „Aktualisieren“ klicken). Alarmanlagen werden nie importiert; die Szenenaktion, die einen Home-Assistant-Dienst aufruft, lehnt jeden Befehl an sie, an Alarmanlagen und an alle Rollläden auf einmal (all, ein Bereich, ein Gerät) ab, solange dieses Feld nicht angekreuzt ist.

Optionen​

  • Mindestabstand zwischen zwei Werten eines Sensors: standardmäßig 10 Sekunden. Eine Steckdose, die ihre Leistung jede Sekunde meldet, wird in diesem Takt an Gladys gesendet. Schalter, Lampen, Rollläden und Melder werden nie verzögert.
  • Sprache der Funktionsnamen: die Wörter, die an die Namen der Nebenfunktionen angehängt werden („Küche – Helligkeit“). Standardmäßig Französisch.
  • Ereignistypen, auf die gehört wird und Zu beobachtende, nicht importierte Entitäten: siehe die Szenenauslöser unten.

Was du bekommst​

Geräte​

Ein Gladys-Gerät pro Home-Assistant-Gerät, mit den Funktionen seiner Entitäten; eine Entität ohne Gerät (ein Helfer, eine Vorlage) ist ein eigenes Gerät. Der Name ist der aus Home Assistant, mit seinem Bereich („Decke (Wohnzimmer)“).

Home AssistantIn Gladys
lightEin/Aus, Helligkeit, Farbe, Farbtemperatur (falls unterstützt)
switch, input_booleanein Schalter
coverein Rollladen (oder Vorhang): öffnen, schließen, stoppen, Position
cover Garagentor, Tor, Türoffen oder geschlossen (schreibgeschützt, sofern nicht erlaubt)
climateSolltemperatur, Modus (aus, heizen, kühlen, auto), Raumtemperatur
sensor nach GeräteklasseTemperatur, Feuchtigkeit, Druck, Helligkeit, CO2, PM2,5, PM10
Leistung, Energie (Zählerstand), Spannung, Strom, Batterie, Gas, Wasser
Lärm, Windgeschwindigkeit, Entfernung, Dauer, Regenintensität, AQI
binary_sensor Tür, Fenster, Garagentor, Öffnungein Öffnungsmelder
binary_sensor Bewegung, Belegung, Anwesenheitein Bewegungs- oder Anwesenheitsmelder
binary_sensor Rauch, Feuchtigkeit, CO, Sabotage, usw.Rauch-, Wasser-, CO-, Sabotagemelder; sonst ein allgemeiner Eingang
media_playerEin/Aus, Wiedergabe, Pause, weiter, zurück, Lautstärke, Wiedergabestatus
fanEin/Aus, Geschwindigkeit in %
lockverriegelt oder nicht (schreibgeschützt, sofern nicht erlaubt)

Die Solltemperatur eines Thermostats bleibt innerhalb der Grenzen, die Home Assistant dafür angibt (min_temp, max_temp): Ein Wert außerhalb wird abgelehnt, nie in einen anderen umgewandelt. Ein Thermostat, das nur einen Bereich annimmt (heat_cool), zeigt Modus und Temperatur, keine Solltemperatur. Eine Farblampe zeigt im Farbmodus ihre Farbe und im Weißmodus ihre Farbtemperatur.

Dashboard-Widget​

Home Assistant: die angebotenen Geräte, die hinzugefügten Geräte, die verfolgten Entitäten, die Verbindung und die Version von Home Assistant sowie eine Taste Neu laden, die die Geräteliste neu liest.

Szenenauslöser​

  • Home-Assistant-Ereignis: Ein Ereignis eines in Ereignistypen, auf die gehört wird aufgeführten Typs ist eingetreten (zha_event einer Zigbee-Fernbedienung, tag_scanned eines NFC-Tags, eigene Ereignisse). Filter: Ereignistyp, Entität. Die Szene erhält den Typ, die Entität und die Ereignisdaten (JSON).
  • Home-Assistant-Entität geändert: Eine in Zu beobachtende, nicht importierte Entitäten aufgeführte Entität hat ihren Zustand geändert (Alarm scharf, Sauger reinigt, Person zu Hause). Filter: Entität, neuer Zustand. Die Szene erhält die Entität, ihren Namen, den neuen und den vorherigen Zustand.

Für die in Gladys importierten Entitäten nutze den üblichen Auslöser „Gerätezustand“.

Szenenaktionen​

  • Home-Assistant-Aktion aufrufen: ein beliebiger Dienst als domain.service (light.turn_on, notify.mobile_app_handy), mit Entitäten und Daten in JSON ({"brightness_pct": 50}).
  • Home-Assistant-Skript ausführen: script.good_night, mit optionalen Variablen in JSON.
  • Home-Assistant-Szene aktivieren: scene.movie_time.
  • Home-Assistant-Taste drücken: button.restart_router.

Szenenbeispiele​

  • Zigbee-Fernbedienung bleibt in Home Assistant: Auslöser „Home-Assistant-Ereignis“, Typ zha_event; Aktion: eine Gladys-Szene des Wohnzimmers starten.
  • Alarm in Home Assistant scharf geschaltet: beobachte alarm_control_panel.home; Auslöser „Home-Assistant-Entität geändert“, neuer Zustand armed_away; Aktion: die Lampen von Gladys ausschalten und dir eine Nachricht senden.
  • Gute Nacht: um 23 Uhr Aktion „Home-Assistant-Skript ausführen“ script.good_night, danach schließt Gladys ihre eigenen Rollläden.

Fehlerbehebung​

StatusmeldungWas tun
Gib die Adresse und ein Zugriffstoken einFülle beide Felder der Konfiguration aus.
Die Adresse von Home Assistant ist ungültigGib http://IP:8123 (oder https://…) ein, ohne Benutzername oder Passwort.
Home Assistant lehnt das Zugriffstoken abErstelle ein neues Token in deinem Profil, Reiter Sicherheit, und füge es ein.
Home Assistant ist nicht erreichbarPrüfe die Adresse von der Gladys-Maschine aus (nicht localhost) und ob Home Assistant läuft.
„kein Administrator“ im VerbindungstestErstelle das Token mit einem Administratorkonto, um Geräte und Bereiche zu erhalten.
Ein Gerät fehltPrüfe gewählte Typen und Bereiche oder trage die Entität unter „Trotzdem importieren“ ein.

Wenn Home Assistant neu startet, werden seine Geräte in Gladys „nicht erreichbar“; die Integration verbindet sich innerhalb von Sekunden bis zu einer Minute neu und sendet die inzwischen geänderten Werte. Ein Gerät, dessen Entitäten in Home Assistant alle nicht verfügbar sind, wird ebenfalls als nicht erreichbar angezeigt. Die Protokolle der Integration (Gladys, Integrationsseite) geben die Details.

Grenzen​

  • Home Assistant bleibt für die Geräte zuständig: Lass es laufen.
  • Nicht importiert: Alarmanlagen, Sauger, Kameras, Ventile, Luftbefeuchter, Warmwasserbereiter, Sirenen, Zahlen und Auswahllisten, Text- und Aufzählungssensoren, Lamellenneigung, Thermostat-Voreinstellungen und Lüftermodi. Der Verbindungstest listet die ausgelassenen Typen auf; beobachte sie mit dem Auslöser „Entität geändert“ und steuere sie mit der Szenenaktion „Home-Assistant-Aktion aufrufen“.
  • Die Funktionsnamen werden beim Hinzufügen des Geräts in Gladys festgelegt: Ein später in Home Assistant geänderter Name erscheint im unter Entdecken angebotenen Namen, nicht im bereits hinzugefügten Gerät.
  • Die Kennungen hängen vom Token ab: Das eines Administrators ergibt ein Gladys-Gerät pro Home-Assistant-Gerät, ein anderes ein Gerät pro Entität. Ein Wechsel bietet die Geräte unter Entdecken neu an: Behalte dieselbe Art von Token.
  • Szenenereignisse sind auf 120 pro Minute begrenzt: Ein sehr gesprächiger Ereignistyp wird darüber hinaus gekappt, mit einer Zeile im Protokoll.

Datenschutz​

Alles bleibt in deinem lokalen Netzwerk: Die Integration spricht nur mit deinem Home Assistant, über dessen WebSocket-API. Das Token wird von Gladys als Geheimnis gespeichert und nie in die Protokolle geschrieben. Home Assistant ist ein Projekt der Open Home Foundation; diese Integration ist weder mit ihr noch mit Nabu Casa verbunden.

Konfigurationseinstellungen​

Diese Einstellungen fragt Home Assistant in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Deine Home-Assistant-Geräte in GladyssectionNeinGladys verbindet sich über die WebSocket-API mit deinem Home Assistant. Erstelle in Home Assistant ein langlebiges Zugriffstoken (dein Profil, Reiter Sicherheit, ganz unten), am besten mit einem Administratorkonto: Nur damit sind Geräte und Bereiche lesbar. Die Geräte erscheinen dann im Reiter Entdecken: Füge die gewünschten hinzu.
Adresse von Home AssistantstringJaIP-Adresse und Port, von der Gladys-Maschine aus gesehen. Kein .local-Name, nicht localhost.
Langlebiges ZugriffstokensecretJa
Zu importierende Entitätstypenmulti_selectNein
Zu importierende BereichestringNeinNamen der Home-Assistant-Bereiche, durch Kommas getrennt. Leer: alle Bereiche und die Entitäten ohne Bereich.
Trotzdem zu importierende EntitätenstringNeinEntitäts-IDs, durch Kommas getrennt; * steht für beliebigen Text. Unabhängig von gewählten Typen und Bereichen importiert.
Auszulassende EntitätenstringNeinEntitäts-IDs, durch Kommas getrennt; * steht für beliebigen Text. Nie importiert.
Befehle für Schlösser, Garagentore und Tore erlaubenbooleanNeinAus: Schlösser, Garagentore, Tore und Türen zeigen ihren Zustand, aber Gladys kann sie weder öffnen noch eine Alarmanlage entschärfen, über Gerät, Szene oder Sprachassistent.
Mindestabstand zwischen zwei Werten eines Sensors (s)numberNeinEin Zähler, der jede Sekunde meldet, wird in diesem Takt an Gladys gesendet. Schalter und Melder werden nie verzögert.
Home-Assistant-Ereignisse in deinen SzenensectionNeinGladys hört nur auf die hier aufgeführten Ereignisse und Entitäten, um deine Szenen zu starten (Auslöser „Home-Assistant-Ereignis“ und „Home-Assistant-Entität geändert“).
Ereignistypen, auf die gehört wirdstringNeinDurch Kommas getrennt. Beispiele: zha_event, deconz_event, tag_scanned oder eigene Ereignisse.
Zu beobachtende, nicht importierte EntitätenstringNeinEntitäts-IDs, durch Kommas getrennt; * steht für beliebigen Text. Jede Zustandsänderung kann eine Szene starten.
Sprache der FunktionsnamenselectNein

So installierst du Home Assistant in Gladys​

  1. Öffne in Gladys Integrationen: Home Assistant erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-homeassistant:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-homeassistant.

Home Assistant 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​

Home Assistant 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am