Homebridge, HomeKit und npm-Plugins

01Allgemein

Kurz erklärt: Ziel ist, die Homebridge auf einem Raspberry Pi mit npm-Plugins zu erweitern, damit Philips Hue, Netatmo-Wetterdaten, Fritzbox (Gäste-WLAN, DECT-Steckdosen), Bose SoundTouch und Synology in Apple HomeKit erscheinen und per Siri steuerbar sind. Jedes Plugin wird installiert und als Platform oder Accessory in der config.json eingetragen. Heute erledigt man das bequemer über die Homebridge UI; einige der Plugins sind inzwischen veraltet. (Stand: November 2026)"Hey Siri…, Gäste Wlan einschalten"!
oder
"Hey Siri…, Bose Soundtouch 30 einschalten"!
oder
"Hey Siri…, wie hoch ist der CO2 Gehalt im Wohnzimmer?"
In dieser Anleitung geht es darum, die Homebridge, die z. B. auf einem Raspberry Pi läuft, durch weitere hilfreiche npm-Plugins zu erweitern. Ich stelle hier die Plugins vor, die ich selbst verwende und für interessant halte. Gerne könnt Ihr mir auch über die Kommentare oder Kontakt Wünsche für Plugins äußern. Voraussetzung für diese Plugins ist eine bereits installierte Homebridge. Ich habe in diesem Artikel beschrieben, wie man diese installiert. Jedes Plugin wird z. B. auf dem Pi global per npm installiert (sudo npm install -g …). Heute geht das noch bequemer über die Weboberfläche der Homebridge (Homebridge UI). Bitte vorher auf npmjs.com prüfen, ob ein Plugin noch gepflegt wird – einige der hier genannten Plugins sind inzwischen veraltet. Außerdem muss die config.json für jedes Plugin angepasst werden: Sie wird um jede weitere Platform bzw. jedes weitere Accessory ergänzt. Dabei unbedingt auf die korrekte JSON-Schreibweise achten – schon ein fehlendes Komma oder eine fehlende Klammer verhindert den Start der Homebridge. Zur Kontrolle benutze ich diesen JSON-Validator.

02NPM Plugins

• Philips Hue
• Netatmo
• Fritzbox
• Bose SoundTouch
• Synology Diskstation

Philips Hue Plugin für Homebridge und Homekit(Bridge 2. Generation – die Bridge der 1. Generation wird von Philips nicht mehr unterstützt)

Funktionen

Integration und Steuerung der Hue Komponenten in Homebridge und Apple´s Homekit. Dieses Plugin hat es in sich – ich würde behaupten, dass es das beste auf der Homebridge ist. Gerade für Nutzer der Hue Bridge der 1. Generation lohnte sich dieses Plugin, weil erst dadurch die Steuerung der Lampen mit Siri möglich wurde (die Bridge der 2. Generation unterstützt HomeKit inzwischen auch direkt). Gelungen ist auch die Integration in Apples HomeKit. (Die Einrichtungszeit beträgt ca. 30 Min.)

Unterstützung

• Hue Lampen (+ Scenen, Gruppen)
• Hue Dimmer
• Hue Bewegungsmelder
• Hue Schalter
• Timer
• Regeln

Installation

• Mit Pi via SSH verbinden ssh pi@192.168.178.xxx

sudo npm install -g homebridge-hue

• Homebridge stoppen sudo service homebridge stop
• Config anpassen sudo nano ~/.homebridge/config.json
• In Platforms muss dann die Hue Platform angelegt werden. Dort dann die IP der Hue Bridge eintragen und mit Strg+X, dann Y (yes) und Enter speichern. Dort sind noch viele weitere Einstellungen möglich, um die eigenen Hue-Komponenten zu aktivieren – hier lohnt sich etwas Ausprobieren. Setzt man z. B. groups auf true, stehen auch die angelegten Hue-Gruppen in der Homebridge zur Verfügung.

{
	"bridge": {
		"name": "Homebridge",
		"username": "CC:22:3D:E3:CE:30",
		"port": 51826,
		"pin": "031-45-154"
	},

	"platforms": [{
		"platform": "HomeMatic",
		"name": "HomeMatic CCU2",
		"ccu_ip": "192.168.178.XXX",
		"filter_device": [],
		"filter_channel": [],
		"outlets": [],
		"doors": [],
		"programs": [],
		"subsection": "Homekit",
		"variables": ["Garagen Tor", "Licht Garten"]
	}, {
		"platform": "Hue",
		"name": "Hue",
		"host": "192.168.178.XXX",
		"users": {
			"USER": "KEY SECRET"
		},
		"heartrate": 5,
		"timeout": 5,
		"lights": true,
		"philipslights": true,
		"ct": false,
		"groups": false,
		"group0": true,
		"rooms": false,
		"sensors": false,
		"excludeSensorTypes": [],
		"schedules": false,
		"rules": false
	}],
	"accessories": []
}

• Neustart der Homebridge homebridge

• Nun erscheint in der Konsole ein Fehler. Er bedeutet, dass noch kein Hue-User angelegt wurde.

• Jetzt drückt man den Link-Button (Connect-Taste) auf der Bridge, und es wird ein neuer User auf der Bridge angelegt. Diesen User und den Key trägt man anschließend in die config.json ein, damit sich die Homebridge beim nächsten Start automatisch mit der Hue verbindet. Vorher die Homebridge wieder stoppen.

• Neustart der Homebridge homebridge

• Jetzt sollten alle Hue-Komponenten erscheinen.

Abbildung vergrößern

Abbildung vergrößern

• In der Eve-App (oder der Home-App) erscheinen nun alle Hue-Komponenten im Standardraum.

Abbildung vergrößern

Abbildung vergrößern

Siri richtig ansprechen

• Hey Siri… Wohnzimmer Licht einschalten

• Hey Siri… Küche Licht 20% dimmen

• Hey Siri… Wohnzimmer Licht grün

03Netatmo Plugin für Homebridge und Homekit

Wer die Netatmo-Wetterdaten auch in der Homebridge und damit in HomeKit verfügbar haben will, installiert dieses npm-Plugin.

Funktionen

• Temperatur innen/außen
• Luftfeuchtigkeit innen/außen
• Luftqualität außen
• CO2 Gehalt in ppm innen
• Lautstärke innen
• Luftdruck innen

Installation

• Mit Pi via SSH verbinden ssh pi@192.168.178.xxx

sudo npm install -g homebridge-netatmo

• Homebridge stoppen sudo service homebridge stop
• Config anpassen sudo nano ~/.homebridge/config.json
• In der Config muss man nun die Client ID und das Client Secret seiner Netatmo eintragen (früher zusätzlich Username und Passwort – Netatmo hat die API-Anmeldung inzwischen auf OAuth2-Token umgestellt, daher bitte die aktuelle Plugin-Beschreibung beachten). Dazu sind einige Schritte auf der Netatmo-Entwicklerseite notwendig. Die Schritte habe ich schon mal hier unter ID´s beschaffen beschrieben.

Abbildung vergrößern

"platforms": [
 {
"platform": "netatmo",
"name": "netatmo platform",
"ttl": 5,
"auth": {
"client_id": "XXXXX ",
"client_secret": "XXXXX ",
"username": "your netatmo username",
"password": "your netatmo password"
            }
        }
    ],

• Neustart der Homebridge homebridge

Siri richtig ansprechen

• Hey Siri… Wie ist die Temperatur im Garten

• Hey Siri… Wie ist CO2 Gehalt im Wohnzimmer

• Hey Siri… Wie ist die Luftfeuchtigkeit im Garten

• Hey Siri… …

04Fritzbox Plugin für Homebridge und Homekit

Integration und Steuerung der Fritz!-Komponenten in Homebridge und Apple´s Homekit. Mit diesem Plugin lassen sich einige interessante Fritzbox-Funktionen über die Homebridge steuern.

Funktionen

• Gäste-WLAN aktivieren/deaktivieren
• Fritz!DECT outlets (100, 200, 210)
• Fritz!Powerline outlets (510, 540)
• Comet!DECT thermostats

Installation

• Mit Pi via SSH verbinden ssh pi@192.168.178.xxx

sudo npm install -g homebridge-fritz

• Homebridge stoppen sudo service homebridge stop
• Config anpassen sudo nano ~/.homebridge/config.json
• Hier trägt man Benutzername und Passwort der Fritzbox ein – am besten einen eigenen Fritzbox-Benutzer nur für die Homebridge anlegen.

Abbildung vergrößern

{
	"bridge": {
		"name": "Homebridge",
		"username": "CC:22:3D:E3:CE:30",
		"port": 51826,
		"pin": "031-45-154"
	},
	"platforms": [{
		"platform": "HomeMatic",
		"name": "HomeMatic CCU2",
		"ccu_ip": "192.168.178.xxx",
		"filter_device": [],
		"filter_channel": [],
		"outlets": [],
		"doors": [],
		"programs": [],
		"subsection": "Homekit",
		"variables": ["Alarm Status", "Garagen Tor"]
	}, {
		"platform": "Fritz!Box",
		"name": "My FritzBox",
		"username": "admin",
		"password": "xxx",
		"url": "http://fritz.box",
		"interval": 300,
		"options": {
			"strictSSL": false
		}
	}],
	"accessories": []
}

• Neustart der Homebridge homebridge

Siri richtig ansprechen

• Hey Siri… Gäste Wlan einschalten

05Bose Soundtouch Plugin für Homebridge und Homekit

Funktionen

• Bose Soundtouch aktivieren/deaktivieren
• Status Abfrage
• Lautstärkeregelung war damals leider nicht möglich

Installation

• Mit Pi via SSH verbinden ssh pi@192.168.178.xxx

sudo npm install -g homebridge-soundtouch

• Homebridge stoppen sudo service homebridge stop
• Config anpassen sudo nano ~/.homebridge/config.json
• Nun trägt man alle SoundTouch-Geräte als kommagetrennte Einträge unter „accessories“ ein
• "accessory" muss SoundTouch sein
• "name" kann frei vergeben werden. Man sollte aber auf den Namen „SoundTouch“ verzichten, da Siri sonst die Bose-App öffnet
• "room" muss exakt der Gerätename aus der Bose App sein

Abbildung vergrößern

{
	"bridge": {
		"name": "Homebridge",
		"username": "CC:22:3D:E3:CE:30",
		"port": 51826,
		"pin": "031-45-154"
	},
	"platforms": [{
		"platform": "HomeMatic",
		"name": "HomeMatic CCU2",
		"ccu_ip": "192.168.178.xxx",
		"filter_device": [],
		"filter_channel": [],
		"outlets": [],
		"doors": [],
		"programs": [],
		"subsection": "Homekit",
		"variables": []
	}],
	"accessories": [{
			"accessory": "SoundTouch",
			"name": "Bose 30",
			"room": "Bose 30"
		}, {
			"accessory": "SoundTouch",
			"name": "Bose 20",
			"room": "Bose 20"
		}, {
			"accessory": "SoundTouch",
			"name": "Bose Garten",
			"room": "Bose Garten"
		}
	]
}

• Neustart der Homebridge homebridge

Siri richtig ansprechen

• Hey Siri… Bose 30 einschalten
• Hey Siri… Ist Bose 30 eingeschaltet?

06Synology Plugin für Homebridge und Homekit

Funktionen

• Synology Diskstation ausschalten
• Wake up on lan
• CPU Auslastung anzeigen
• Diskspace anzeigen
• Temperatur anzeigen

Installation

• Mit Pi via SSH verbinden ssh pi@192.168.178.xxx

sudo npm install -g homebridge-synology

• Homebridge stoppen sudo service homebridge stop
• Config anpassen sudo nano ~/.homebridge/config.json
• Nun gibt man IP-Adresse, MAC-Adresse, Benutzerkonto und Passwort der Synology ein

Abbildung vergrößern

{
	"bridge": {
		"name": "Homebridge",
		"username": "CC:22:3D:E3:CE:30",
		"port": 51826,
		"pin": "031-45-154"
	},
	"platforms": [{
		"platform": "HomeMatic",
		"name": "HomeMatic CCU2",
		"ccu_ip": "192.168.178.xxx",
		"filter_device": [],
		"filter_channel": [],
		"outlets": [],
		"doors": [],
		"programs": [],
		"subsection": "Homekit",
		"variables": []
	}],
	"accessories": [{
			"accessory": "Synology",
			"name": "Diskstation",
			"ip": "192.168.178.xxx",
			"mac": "00:11:32:23:68:87",
			"secure": false,
			"account": "admin",
			"password": "passwort",
			"version": 6
		}
	]
}

• Neustart der Homebridge homebridge

Siri richtig ansprechen

• Hey Siri… wie viel grad hat die Diskstation Temperatur
• Hey Siri… Diskstation ausschalten

07Tipps aus der Praxis

• Plugins heute über den Reiter „Plugins“ der Homebridge UI suchen und installieren. Die Einstellungen lassen sich dort meist per Formular eintragen, Tippfehler in der config.json werden so seltener.
• Vor jeder größeren Änderung eine Sicherung der config.json bzw. ein Backup über die Homebridge UI anlegen. Ein vergessenes Komma reicht, damit die Homebridge nicht mehr startet.
• Plugins, die gelegentlich abstürzen, als eigene „Child Bridge“ laufen lassen. Dann bleibt der Rest der Homebridge erreichbar, auch wenn ein einzelnes Plugin Probleme macht.
• Den Benutzernamen (MAC-ähnliche Kennung) und die PIN aus den Beispielen nicht übernehmen, sondern eigene Werte verwenden. Jede Homebridge im Netz braucht eine eindeutige Kennung.
• Zugangsdaten für Fritzbox, Synology und Co. stehen im Klartext in der config.json. Für die Homebridge deshalb eigene Benutzerkonten mit möglichst wenigen Rechten anlegen und den Raspberry Pi mit einem sicheren Passwort schützen.
• Für Siri eindeutige Namen vergeben, die nicht wie eine App heißen – beim Namen „SoundTouch“ öffnet Siri sonst die Bose-App statt den Lautsprecher zu schalten.

08Häufige Fragen

09Passende Anleitungen

• Homematic mit Siri und HomeKit steuern (Homebridge)Homebridge installieren und Homematic einbinden
• Siri und Homematic über Apple TV 4 von unterwegs steuernHomeKit auch von unterwegs nutzen
• Philips Hue mit Homematic steuernHue direkt mit Homematic verbinden
• Fritzbox mit Homematic steuernFritzbox-Funktionen in Homematic-Programmen nutzen