WLED Apple Home HomeKit Matter iOS Smart Home

WLED in Apple Home und HomeKit: Die Wege, die heute funktionieren

WLED hat kein eingebautes HomeKit und kein Matter. Hier sind alle echten Wege, WLED-Lichter in die Home-App zu bringen (Home Assistant, Homebridge, Matter-Bridges), und was jeder davon kann und nicht kann.

Von

Kurze Antwort: WLED lässt sich nicht aus eigener Kraft in Apple Home einbinden. Keine WLED-Version bis 16.0.1 spricht HomeKit oder Matter. Um ein WLED-Licht in die Home-App zu bekommen, brauchen Sie eine Bridge, die auf einem dauerhaft laufenden Gerät sitzt: Home Assistant mit HomeKit Bridge, Homebridge mit einem WLED-Plugin oder eine Matter-Bridge. Wenn Sie nur Siri wollen, kann die Kurzbefehle-App ganz ohne Bridge direkt mit WLED kommunizieren.

Welche Bridge Sie auch wählen: Apple Home versteht nur ein einfaches Licht, also An und Aus, Helligkeit, Farbe und bei den meisten Bridges Farbtemperatur. Home hat keine eigene Effektsteuerung. Die meisten Bridges lassen Effekte und Paletten weg, ein Homebridge-Plugin kann ausgewählte Effekte aber als TV-Eingänge auflisten (wie die Eingangsliste eines Fernsehers). WLED-Szenen kommen je nach Bridge als Schalter, Steckdosen, Lichter oder solche TV-Eingänge an.

Warum WLED Apple Home nicht direkt unterstützt

Der Wunsch besteht seit Jahren. Die Matter-Anfrage auf GitHub (Issue #2871) ist weiterhin offen und mit "help wanted" markiert. Die Erklärung der Maintainer ist praktisch: Matter braucht eine neuere Version des Espressif-Frameworks als jede bisherige WLED-Version (der Entwicklungszweig ist im Juli 2026 darauf gewechselt, eine Version damit gibt es aber noch nicht), und ältere Chips wie der ESP8266 haben dafür nicht genug Speicher. Ein Prototyp, der Matter als Benutzermodul auf dem ESP32-S3 ergänzte, wurde im März 2026 eröffnet und ohne Merge wieder geschlossen.

Für den Moment, und für jedes Board, das Sie bereits besitzen, führt der Weg also über eine Bridge.

Was Apple Home anzeigen kann

In der Home-AppGeht über eine Bridge?
An und Ausja
Helligkeitja
Farbeja
Farbtemperatur (Warmweiß bis Kaltweiß)bei den meisten Bridges, wenn der Streifen einen Weißkanal hat oder WLED eine Farbtemperatur meldet
Effekte (Fireworks, Twinkle und so weiter)nicht als Effekte; ein Homebridge-Plugin listet ausgewählte als TV-Eingänge
Palettennein
WLED-Szenenals Schalter oder Steckdosen, je nach Bridge (siehe unten)
Segmenteals separate Lichter, bei einigen Bridges

Der praktische Trick ist überall derselbe: Legen Sie die gewünschte Lichtstimmung als WLED-Szene an und holen Sie diese Szene dann als Schalter in Home. "Movie" wird so zu einer Taste in einer Home-Szene oder Automation.

Einen Weg wählen

WegLäuft aufWLED-Szenen in HomeSegmenteAufwand
Home Assistant + HomeKit BridgeIhrem Home Assistantja, als "Steckdosenleiste" mit einer Steckdose pro Szeneja, ein Licht pro Segmentgering, wenn Sie Home Assistant schon betreiben
Homebridge + WLED-Plugineinem Raspberry Pi, NAS oder dauerhaft laufenden Rechnerja, als Schalter, Lichter oder TV-Eingänge (je nach Plugin)einige Pluginsmittel
Matter-BridgeHome-Assistant-App oder Dockerkaum, nur Lichterüber Home Assistantmittel
Kurzbefehle und Siri, ohne BridgeIhrem iPhoneals Kurzbefehle, nicht in der Home-Apppro Kurzbefehlgering

Wenn Sie Home Assistant schon betreiben, fangen Sie dort an. Wenn nicht, ist Homebridge kleiner und macht genau diese eine Aufgabe.

Home Assistant mit HomeKit Bridge

Das ist der vollständigste Weg, weil Home Assistant bereits viel über WLED weiß.

  1. Fügen Sie in Home Assistant die Integration WLED hinzu. Sie findet Ihre Lichter meist von selbst (sie braucht WLED 0.14.0 oder neuer). Unsere Anleitung zu Home-Assistant-Problemen hilft, falls nicht.

  2. Fügen Sie die Integration HomeKit Bridge hinzu: Settings›Devices & services›Add integration, dann nach HomeKit Bridge suchen. Sie steht unter Apple.

    Home Assistant 2026.10
    Dialog Add integration in Home Assistant nach der Auswahl von Apple mit dem Titel What do you want to add und den Einträgen Apple iCloud, Apple TV, Apple WeatherKit, HomeKit Bridge, HomeKit Device, iBeacon Tracker und Apple iTunes
    Wählen Sie HomeKit Bridge. HomeKit Device ist die Gegenrichtung (HomeKit-Geräte in Home Assistant).
  3. Begrenzen Sie, was freigegeben wird. Nehmen Sie in den Optionen der Bridge die Domäne light auf (und select, wenn Sie Szenen wollen), und wählen Sie dann nur die WLED-Entitäten aus, die Sie brauchen. Sonst taucht jeder Sensor und jeder Schalter in Ihrem Haus in der Home-App auf.

    Home Assistant 2026.10
    Einrichtungsschritt Select domains to be included der HomeKit Bridge, Domains to include steht auf Light, Select, darunter eine Submit-Schaltfläche
    Entfernen Sie bei der Einrichtung die vorausgewählten Domänen und behalten Sie Light und Select.
    Home Assistant 2026.10
    Optionsschritt Select the entities to be included der HomeKit Bridge mit zwei gewählten Entitäten: Porch Lights (das Licht) und Preset (Porch Lights)
    Öffnen Sie dann Configure an der Bridge, wählen Sie den Modus include und dann das WLED-Licht und sein Select Preset.
  4. Öffnen Sie die Kopplungsbenachrichtigung in Home Assistant, tippen Sie in der Home-App auf +, Gerät hinzufügen und scannen Sie den QR-Code.

    Home Assistant 2026.10
    Benachrichtigung HomeKit Pairing in Home Assistant: To set up HASS Bridge in the Home App, scan the QR code or enter the following code, mit einem achtstelligen Code und einem QR-Code
    Die Kopplungsbenachrichtigung unter Notifications in der Seitenleiste. Diese stammt aus einer Wegwerf-Testinstallation, der Code ist also nutzlos.

Das bekommen Sie in Home:

  • Ein Licht pro WLED-Licht, mit Farbe. Hat das Licht mehr als ein Segment, legt Home Assistant ein Licht Main an (nur Ein/Aus und Gesamthelligkeit, keine Farbe) plus ein Licht pro Segment. Geben Sie das Main-Licht für An, Aus und Dimmen und das Licht des ersten Segments frei, wenn Sie Farben aus der Home-App setzen möchten.
  • Farbe und Helligkeit, und Farbtemperatur, wenn das Licht sie unterstützt.
  • WLED-Szenen und Szenenfolgen kommen als Select-Entitäten an, die HomeKit Bridge als Steckdosenleiste mit einer Steckdose pro Option zeigt. Geben Sie das Select Preset frei, dann können Sie in der Home-App auf "Christmas" tippen oder es in einer Home-Szene verwenden.
Tipp

Eine HomeKit-Bridge fasst höchstens 150 Geräte. Bei vielen WLED-Lichtern, Segmenten und Selects hält eine zweite Bridge-Instanz nur für Lichter die Sache übersichtlich.

Homebridge mit einem WLED-Plugin

Homebridge ist ein kleiner Server, dessen Aufgabe darin besteht, Geräte ohne HomeKit in Apple Home zu bringen. Er läuft auf einem Raspberry Pi, einem NAS oder jedem dauerhaft laufenden Rechner.

  1. Installieren Sie Homebridge mit seiner Weboberfläche (die Homebridge-Website hat Images und Installer).

  2. Suchen Sie im Tab Plugins nach WLED und installieren Sie eines der Plugins unten.

    Homebridge UI 5.29
    Plugins-Tab von Homebridge mit der Suche nach wled, angezeigt werden Homebridge Wled Ws, Homebridge WLED Presets, Homebridge Simpler Wled und Homebridge Script2, jeweils mit Version und Download-Schaltfläche
    Das grüne Schild kennzeichnet ein verifiziertes Plugin. Über den Download-Pfeil wählen Sie die Version zum Installieren.
  3. Tragen Sie die IP-Adressen Ihrer Lichter in den Plugin-Einstellungen ein (geben Sie ihnen vorher DHCP-Reservierungen im Router, damit sie sich nicht ändern).

    homebridge-wled-ws 0.0.25
    Einstellungen von homebridge-wled-ws, Abschnitt Controllers: Name Porch Lights, IP Address or Hostname 192.168.1.50, List of presets Warm White,Christmas,Movie und eine nicht angehakte Option Realtime Mode Button
    homebridge-wled-ws öffnet dieses Formular direkt nach der Installation. Szenen werden mit Namen aufgelistet, durch Kommas getrennt.
  4. Fügen Sie das Gerät in der Home-App hinzu, indem Sie den QR-Code auf dem Homebridge-Dashboard scannen. Wenn Sie die Child Bridge behalten haben, die Homebridge beim ersten Speichern der Plugin-Einstellungen anbietet (sie ist standardmäßig eingeschaltet), bekommt dieses Plugin einen eigenen QR-Code: Tippen Sie auf das QR-Symbol (Connect to HomeKit) auf der Karte des Plugins.

    Homebridge UI 5.29
    Child-Bridge-Einstellungen von Homebridge für das WLED-Plugin mit eingeschaltetem Enable HAP (Apple Home), einem QR-Code, dem Setup-Code und dem Status Not Paired, Scan to add to HomeKit
    Der eigene Kopplungscode der Child Bridge. Eine Child Bridge muss getrennt von der Haupt-Bridge zu Home hinzugefügt werden.
Homebridge UI 5.29
Accessories-Tab von Homebridge, Default Room: ein Licht Porch Lights bei 49 Prozent und drei Schalter namens Warm White, Christmas und Movie, alle aus
Was homebridge-wled-ws an Apple Home übergibt: ein Licht plus ein Schalter pro aufgelisteter Szene.

Stand Oktober 2026 sind das die Plugins, die einen Blick lohnen. Das Homebridge-Label "Verified" bedeutet, dass das Homebridge-Team das Plugin anhand seiner Richtlinien geprüft hat.

PluginVerifiziertWas Sie bekommen
homebridge-wled-wsjaEin Licht mit Ein/Aus, Helligkeit und Farbe; ein Schalter pro aufgelisteter Szene; optional ein Schalter für den Echtzeitmodus. Steuert nur das Hauptsegment
homebridge-simpler-wledjaEin/Aus, Helligkeit und Farbe; Szenen als TV-Eingangsliste; optional Zubehör pro Segment
@ncovercash/homebridge-wled-presetsjaNur Szenen: Jede Szene ist ein eigenes Licht mit An, Aus und Helligkeit, und das Einschalten einer Szene schaltet die anderen aus. Keine Farbsteuerung. Version 1.1.4, letzte Aktualisierung April 2026
homebridge-simple-wledneinEin/Aus, Helligkeit und Farbe; ausgewählte Effekte oder Szenen als TV-Eingangsliste (entweder das eine oder das andere, nicht beides)

homebridge-wled-ws listet die WLED-Versionen auf, mit denen es getestet wurde (bis 0.15.4 im Oktober 2026, noch nichts für 16); die anderen nennen höchstens eine Mindestversion. Prüfen Sie das, bevor Sie Ihre Lichter auf eine neue Hauptversion aktualisieren.

Matter-Bridges

Matter ist der neuere Smart-Home-Standard, und Apple Home unterstützt Matter-Lichter. Eine Matter-Bridge nimmt Lichter, die sie bereits kennt, und bietet sie als Matter-Geräte an. Für WLED heißt das derzeit eine dieser Lösungen:

  • Home Assistant Matter Hub, als Home-Assistant-App (früher Add-on genannt). Das ursprüngliche Projekt wird seit Januar 2026 nicht mehr gepflegt und ist archiviert; die Abspaltung von RiDDiX wird weiter gepflegt.
  • Matterbridge mit seinem Plugin matterbridge-hass, ebenfalls auf Home Assistant aufgesetzt.
  • wled-matter-bridge, ein kleines eigenständiges Projekt auf GitHub, das WLED-Lichter in Ihrem Netzwerk findet und ohne Home Assistant über Matter anbietet. Es läuft in Docker.

Alle drei geben Apple Home ein Licht mit An, Aus, Helligkeit und Farbe. Keines überträgt Effekte oder Paletten. Zwei davon weisen auf eine Apple-Eigenheit hin: Die Home-App behält den Namen, den ein Gerät beim Koppeln hatte, eine spätere Umbenennung des Lichts kommt also nicht an.

Matter ist dann am sinnvollsten, wenn Sie auch Google Home oder Alexa nutzen, weil eine Bridge alle bedient. Nur für Apple Home erledigen HomeKit Bridge oder Homebridge dieselbe Aufgabe mit weniger Komponenten.

Ohne Bridge: Siri und Kurzbefehle

Wenn Sie nur "Hey Siri, Filmlicht" sagen wollen, sparen Sie sich die Bridge. Die Kurzbefehle-App kann mit Inhalte von URL abrufen Befehle direkt an die JSON-API des Lichts senden, zum Beispiel {"ps":5}, um Szene 5 zu laden. Unsere Anleitung zu Kurzbefehlen und Siri hat die Schritte und eine Tabelle mit Befehlen.

Der Haken: Kurzbefehle sind keine Home-Geräte. Sie erscheinen nicht in der Home-App, in Home-Szenen oder in den Home-Steuerelementen des Kontrollzentrums, und sie erreichen die Lichter nur, solange Ihr iPhone im selben Netzwerk ist.

Auch unsere App WLED Max gehört in diese Kategorie. Auf iOS ergänzt sie Siri-Sätze und Kurzbefehle-Aktionen (ein- oder ausschalten, Helligkeit, Farbe, Szene, Effekt), ohne dass Sie URLs tippen müssen, sie bringt die Lichter aber nicht in die Home-App.

Eine Steuerzentrale für Automationen

Apple Home braucht eine Steuerzentrale (ein Apple TV oder einen HomePod), um Automationen auszuführen und Geräte zu steuern, wenn Sie unterwegs sind. Ohne sie funktioniert ein über eine Bridge angebundenes WLED-Licht zu Hause vom Handy aus, aber "Verandalicht bei Sonnenuntergang einschalten" läuft nicht. Die eigenen Timer von WLED brauchen nichts davon: siehe Zeitpläne für Sonnenaufgang und Sonnenuntergang.

Häufige Probleme

Das Licht zeigt in Home "Keine Antwort". Die Bridge erreicht das Licht nicht. Meist hat das Licht nach einem Router-Neustart eine neue IP-Adresse bekommen. Geben Sie ihm eine DHCP-Reservierung und aktualisieren Sie die Bridge.

Zu viele Geräte. HomeKit Bridge gibt alles frei, was Sie aufnehmen. Beschränken Sie es auf die WLED-Licht-Entitäten und ein Select Preset pro Licht.

Ein umbenanntes Licht behält in Home den alten Namen. Benennen Sie es auch in der Home-App um. Bridges setzen den Namen beim Koppeln.

FAQ

Unterstützt WLED HomeKit? Nicht nativ. Sie brauchen eine Bridge wie die HomeKit Bridge von Home Assistant oder Homebridge.

Unterstützt WLED Matter? In keiner Version bis 16.0.1. Die Funktionsanfrage ist offen, und Matter-Bridges schließen die Lücke.

Kann ich WLED-Effekte aus der Home-App auswählen? Nicht als Effekte. Speichern Sie den Effekt als WLED-Szene und geben Sie die Szene als Schalter oder Steckdose frei, oder nutzen Sie homebridge-simple-wled, das ausgewählte Effekte als TV-Eingänge auflisten kann.

Was ist der einfachste Weg, wenn ich kein Home Assistant betreibe? Homebridge auf einem Raspberry Pi mit homebridge-wled-ws oder homebridge-simpler-wled.