HomeKit Controller Smart-Home-Integration, kostenlos und Open Source

Kopple und steuere dein HomeKit-WLAN-/Ethernet-Zubehör mit Gladys, ohne Apple-Hub.
Diese Integration macht Gladys zu einem HomeKit-Controller: Sie koppelt sich direkt mit deinem WLAN-/Ethernet-HomeKit-Zubehör und steuert es lokal, ohne iPhone, Apple TV oder HomePod und ganz ohne Cloud.
Bevor du beginnst
- Ein HomeKit-Zubehör akzeptiert nur einen Controller gleichzeitig. Wenn es bereits in Apples Home-App (oder in Home Assistant…) eingerichtet ist, entferne es dort zuerst. Andernfalls setze das Zubehör auf die Werkseinstellungen zurück.
- Halte den 8-stelligen Setup-Code (
123-45-678) bereit: Er ist auf dem Zubehör, seiner Verpackung oder seiner Anleitung aufgedruckt. - Das Zubehör muss sich im selben lokalen Netzwerk wie Gladys befinden.
- Nur IP-Zubehör (WLAN, Ethernet) wird unterstützt. Bluetooth- und Thread-Zubehör nicht.
- Gladys 5.3.0 oder neuer ist erforderlich.
Ein Zubehör koppeln
- Öffne die Registerkarte Konfiguration der Integration.
- Klicke auf Zubehör suchen. Die Liste zeigt für jedes Zubehör:
seinen Namen, Typ, die HomeKit-ID, die IP-Adresse und den Status
(
bereit zum Koppeln,anderweitig gekoppelt,mit Gladys gekoppelt). - Klicke auf Zubehör koppeln und fülle aus:
- Zubehör: den Namen, die ID oder die IP-Adresse aus der Suche. Wenn
die Suche es nicht findet, gib seine Adresse als
IP:portein (zum Beispiel192.168.1.20:51826); - Setup-Code: die 8 Ziffern, mit oder ohne Bindestriche.
- Zubehör: den Namen, die ID oder die IP-Adresse aus der Suche. Wenn
die Suche es nicht findet, gib seine Adresse als
- Das Koppeln dauert einige Sekunden (bei kleinen Modulen bis zu einer Minute). Öffne dann die Registerkarte Entdecken: Die Geräte des Zubehörs können hinzugefügt werden.
Eine HomeKit-Bridge ergibt ein Gladys-Gerät pro angebundenem Zubehör.
Unterstützte Geräte
| HomeKit-Dienst | In Gladys |
|---|---|
| Lampe | Ein/Aus, Helligkeit, Farbe, Farbtemperatur |
| Schalter, Steckdose, Ventil | Ein/Aus |
| Energiemessung (Eve) | Leistung (W), Energie (kWh), Spannung, Strom |
| Ventilator | Ein/Aus, Geschwindigkeit |
| Thermostat | Temperatur, Solltemperatur, Luftfeuchtigkeit, Modus, Betriebszustand |
| Klimagerät (Heizen / Kühlen) | Ein/Aus, Modus, Solltemperatur, Temperatur |
| Rollladen, Fenster, Tür | Position, öffnen / stoppen / schließen |
| Schloss | Verriegelt / entriegelt |
| Sensoren | Temperatur, Luftfeuchtigkeit, Helligkeit, |
| Bewegung, Anwesenheit, Kontakt, Leck, Rauch, | |
| CO, CO2, Feinstaub PM2.5 / PM10, VOC, NO2, Ozon, SO2 | |
| Batterie | Ladestand, niedriger Batteriestand |
| Taste, Türklingel | Drücken |
Eine Taste ergibt eine Funktion „Taste“, deren Wert sich bei jedem
Drücken ändert: 1 einfach, 2 doppelt, 6 lang. Eine Türklingel
ergibt eine Funktion „Türklingel“ (1 bei jedem Klingeln). Nutze sie mit
dem üblichen Auslöser
für den Zustand eines Geräts oder mit dem
Auslöser HomeKit-Taste gedrückt (siehe unten).
Klimagerät: Der Modus ist 0 Auto, 1 Kühlen, 2 Heizen (HomeKit kennt
weder Entfeuchten noch reinen Lüfterbetrieb). Die Solltemperatur folgt dem
Modus: Heizschwelle im Heizmodus, sonst Kühlschwelle.
Nach einem Update der Integration kann ein bereits angelegtes Gerät neue Funktionen erhalten: Die Registerkarte Entdecken bietet dann an, es zu aktualisieren.
Andere Dienste (Kameras, Fernseher…) werden vorerst ignoriert. Bei jeder
Verbindung listen die Protokolle die nicht unterstützten Dienste jedes
Zubehörs (HomeKit service(s) not supported: …) und die herstellereigenen
Merkmale (vendor characteristic(s) not supported: …) auf: Füge diese
Zeilen einer Anfrage zur Unterstützung bei.
Energiemessung: HomeKit hat kein Standardmerkmal für die Leistung. Die Integration liest die Merkmale von Eve (Eve-Zubehör, viele Homebridge-Plugins). Eine Steckdose, die ihren Verbrauch nur in ihrer eigenen App zeigt (Aqara…), liefert nur Ein/Aus.
Sichtbar ist nur, was die Bridge über HomeKit veröffentlicht: Ein Gerät, das ein Hub nur über Matter teilt, erscheint hier nicht. Das gilt für die Infrarot-Klimageräte der Aqara-Hubs (M2, M3): Füge sie mit der Matter-Integration von Gladys hinzu.
Einstellungen
- Aktualisierungsintervall: HomeKit überträgt Änderungen in Echtzeit. Gladys liest zusätzlich das gesamte Zubehör in diesem Intervall neu ein, als Absicherung (standardmäßig 60 s).
- Suchdauer: wie lange das Netzwerk während einer Suche abgehört wird (standardmäßig 10 s).
Aktionen
- Zubehör suchen: listet das HomeKit-Zubehör im Netzwerk auf.
- Zubehör koppeln: siehe oben.
- Gerät identifizieren: Das Zubehör macht sich bemerkbar (blinkt, piept…), praktisch, um es zu finden.
- Zubehör entkoppeln: entfernt die Kopplung vom Zubehör und aus Gladys. Bei einer Bridge sind alle ihre Geräte betroffen. Lösche anschließend die Geräte in Gladys.
Szenen
Auslöser (in einer Szene Auslöser hinzufügen → Integrationen):
- HomeKit-Taste gedrückt: Eine Taste oder eine Türklingel wurde gedrückt. Optionale Filter: das Gerät, die Art des Drückens (einfach, doppelt, lang) und die Tastennummer (bei einer Fernbedienung mit mehreren Tasten). Variablen: Zubehör, Taste, Tastennummer, Tastendruck, Türklingel.
- HomeKit-Zubehör offline / zurück: Ein Zubehör ist nicht mehr erreichbar oder wieder da. Optionale Filter: das Gerät und der Status. Bei einer Bridge sendet jedes angebundene Gerät sein eigenes Ereignis.
Um eine Taste im Filter „Gerät“ auszuwählen, lege zuerst ihr Gerät in Gladys an (Registerkarte Entdecken). Andernfalls lass den Filter leer.
Aktionen (in einer Szene Neue Aktion → Integrationen):
- HomeKit-Gerät identifizieren: Das Zubehör macht sich bemerkbar.
- HomeKit-Gerät neu einlesen: liest sofort alle seine Werte (praktisch vor einer Bedingung).
Dashboard-Widget
Das Widget HomeKit-Zubehör zeigt, wie viele Zubehörteile online und offline sind, die Liste der Zubehörteile (nicht erreichbare zuerst) und, wenn eines offline ist, eine Schaltfläche Neu verbinden.
Fehlerbehebung
- Die Suche findet das Zubehör nicht: Prüfe, ob es eingeschaltet
ist und sich im selben Netzwerk (selben VLAN) wie Gladys befindet.
Versuche eine längere Suchdauer oder kopple es mit
IP:port. - „anderweitig gekoppelt“: Entferne es aus der Home-App oder setze es auf die Werkseinstellungen zurück.
- Nicht erreichbares Zubehör: Die Registerkarte Konfiguration der Integration zeigt, welches Zubehör offline ist. Die Integration versucht es selbstständig erneut und findet das Zubehör wieder, wenn sich seine IP-Adresse geändert hat. Um das zu vermeiden, gib dem Zubehör eine feste IP-Adresse (DHCP-Reservierung).
- Die Kopplungen werden im Volume
/datader Integration gespeichert: Sie bleiben bei Updates erhalten. - Für Details prüfe die Protokolle der Integration (
LOG_LEVEL=debug).
Konfigurationseinstellungen
Diese Einstellungen fragt HomeKit Controller in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | 1. Entferne das Zubehör aus der Home-App von Apple (ein HomeKit-Zubehör akzeptiert nur einen Controller). 2. Klicke unten auf „Zubehör suchen“. 3. Klicke auf „Zubehör koppeln“ und gib seinen Namen und den darauf aufgedruckten 8-stelligen Setup-Code ein. 4. Füge seine Geräte über die Registerkarte „Entdecken“ hinzu. |
| Aktualisierungsintervall (s) | number | Nein | HomeKit überträgt Änderungen in Echtzeit; diese vollständige Aktualisierung ist nur eine Absicherung. |
| Suchdauer (s) | number | Nein | Wie lange Gladys im Netzwerk nach HomeKit-Zubehör sucht. |
So installierst du HomeKit Controller in Gladys
- Öffne in Gladys Integrationen: HomeKit Controller erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-homekitcontroller:1.4.3) 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/prohand/gladys-homekitcontroller.
HomeKit Controller benötigt Gladys >=5.3.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
HomeKit Controller 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 prohand 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