Ambilight-PI.de · aktualisiert 21.11.2026

Hyperion mit WLED und ESP32 verbinden – Schritt für Schritt

Redaktion: Ambilight-PI.de · geprüft anhand offizieller Projekt-Dokumentationen

Hyperion mit WLED auf einem ESP32 verbinden: Hyperion berechnet aus dem Bild die Farben, ein ESP32 mit WLED gibt diese über einen LED-Streifen aus. Die Steuerdaten laufen über dein lokales Netzwerk – in modernen Hyperion-Versionen standardmäßig per DDP. So kannst du die LEDs unabhängig von den GPIO-Pins des Raspberry Pi betreiben.

Aktueller Versionsstand 21.11.2026: WLED 16.0.1 ist ein Wartungsrelease vom 7. Juli 2026. Hyperion unterstützt WLED seit Langem; ab Hyperion 2.0.13 verwendet die WLED-Anbindung standardmäßig das Distributed Display Protocol (DDP). WLED allein kann nicht das HDMI-Bild deines Fernsehers auswerten.

So arbeiten Raspberry Pi, WLED und ESP32 zusammen

Bei diesem Aufbau muss der Pi nicht mehr jede LED direkt per SPI oder PWM ansteuern. Stattdessen berechnet Hyperion die Farben und überträgt sie an WLED:

HDMI-Quelle → HDMI-Abzweig/UVC-Grabber → Raspberry Pi mit Hyperion → WLAN oder LAN → ESP32 mit WLED → adressierbarer LED-Streifen

Der normale TV-Hauptpfad bleibt vom LED-Steuersignal getrennt. Wenn du nur einen PC-Bildschirm aufnimmst, kann die Bildquelle auch eine passende Desktop-Erfassung sein.

Ein ESP32 ersetzt also den LED-Controller, nicht automatisch den Raspberry Pi oder den HDMI-Grabber. Details zum Signalweg findest du in Teil 4 unserer HDMI-Anleitung.

Welche Hardware brauchst du?

Prüfe zuerst die LED-Typen im Vergleich und unsere Einkaufsliste. Ein für APA102 geeigneter Ausgangsaufbau ist nicht identisch mit einem WS2812B-Anschluss.

Schritt 1: ESP32 und LED-Streifen sicher verdrahten

  1. Strom abschalten: Vor dem Verdrahten Netzteil und ESP32 spannungsfrei machen. Passende Spannungswerte für den LED-Streifen ablesen; niemals pauschal 5 V an einen unbekannten Streifen legen.
  2. LED-Spannung bereitstellen: Die Versorgung der LEDs entsprechend dem Strombedarf dimensionieren. Viele LEDs dürfen nicht über den USB-Anschluss oder den 3,3-V-Pin des ESP32 versorgt werden.
  3. Masse verbinden: GND des ESP32-Signals und LED-Netzteils verbinden, damit die digitalen Daten ein gemeinsames Bezugspotential besitzen.
  4. Datenleitung anschließen: Einen im jeweiligen WLED-Boardprofil unterstützten GPIO über einen geeigneten Pegelwandler an DIN des LED-Streifens führen. Bei APA102/SK9822 zusätzlich die Taktleitung korrekt anschließen.
  5. Datenrichtung und Sicherung prüfen: Pfeilrichtung der LEDs, Kabelquerschnitt, Stromabsicherung und gegebenenfalls zusätzliche Einspeisung kontrollieren. Erst danach einschalten.

Die offizielle WLED-Schnellstartanleitung zeigt die Grundlagen. GPIO-Nummern unterscheiden sich nach ESP32-Board. Stelle deshalb keine fremde Pinbelegung ungeprüft nach.

Schritt 2: WLED 16.0.1 installieren

  1. Gehe zum offiziellen WLED-Webinstaller und verwende einen dafür unterstützten Desktop-Browser.
  2. ESP32 per USB anschließen und die zum Board passende Firmware auswählen. Vor dem Flashen relevante vorhandene WLED-Einstellungen sichern.
  3. Nach der Installation die WLAN-Zugangsdaten einrichten; den ESP32 und Hyperion im selben erreichbaren Netzwerk betreiben.
  4. WLED im Browser öffnen und bei Config → LED Preferences LED-Typ, GPIOs, LED-Anzahl und Farbreihenfolge entsprechend deiner Verkabelung einstellen.
  5. LEDs in WLED mit einer statischen Farbe prüfen, bevor du Hyperion hinzuschaltest. Die Leistungsbegrenzung sinnvoll zum Netzteil einstellen.

WLED 16.0.1 aktualisiert unter anderem die ESP32-Softwarebasis. Bei vorhandenen WLED-Installationen sind Backup und Kompatibilitätsprüfung vor dem Update sinnvoll; eine funktionierende Anlage muss nicht blind neu geflasht werden.

Schritt 3: WLED als LED-Ausgabe in Hyperion einrichten

  1. Die Hyperion-Weboberfläche aufrufen und die Konfiguration der passenden Hyperion-Instanz öffnen.
  2. Unter LED-Hardware / LED-Geräte als Ausgabetyp WLED auswählen.
  3. Das automatisch gefundene Gerät verwenden. Falls es nicht erscheint, Suche/Browser aktualisieren oder den Hostnamen beziehungsweise die IP-Adresse des WLED-Geräts manuell eintragen.
  4. Für einen aktuellen WLED-Controller nach Möglichkeit den von Hyperion vorgesehenen DDP-Stream nutzen. DDP wird ab WLED 0.11.0 unterstützt; der dokumentierte Hyperion-WLED-Treiber verwendet ihn ab Hyperion 2.0.13.
  5. LED-Anzahl, Laufrichtung, Bildzonen und Farb-Reihenfolge auf dein reales TV-Layout abstimmen. Danach Konfiguration speichern.

Segment-Hinweis: Hyperion kann standardmäßig sämtliche WLED-LEDs ansprechen. Das gezielte Streaming zu nur einem Segment erfordert passende WLED-Versionen und Optionen; die Hyperion-Dokumentation beschreibt unter anderem die Einstellung Realtime – Use main segment only.

Schritt 4: Farben und Alltagstauglichkeit testen

  1. Rot, Grün, Blau: Jede Farbe in Hyperion einzeln senden. Falsche Zuordnung deutet meist auf falsche LED-Farbreihenfolge oder Verkabelung hin.
  2. Alle Seiten: Das LED-Layout im Uhrzeigersinn gegen die tatsächliche Laufrichtung prüfen.
  3. Netzwerk: WLED während des Tests im WLAN erreichbar halten, idealerweise mit gutem Empfang oder einer kabelgebundenen Ethernet-Lösung.
  4. Capture: Erst nach erfolgreichen statischen LED-Tests die HDMI-/Desktop-Bildaufnahme zuschalten.
  5. Neustart: Pi und ESP32 neu starten und kontrollieren, ob Geräteerkennung, LED-Anzahl und Status-Wiederherstellung wie erwartet funktionieren.

Die erreichbare Aktualisierungsrate und Latenz hängen vom WLAN, der LED-Anzahl und der jeweiligen Hardware ab. Eine pauschale Millisekunden-Zusage wäre ohne Messung irreführend.

Typische Fehler: Das kannst du zuerst prüfen

ProblemErster Check
WLED wird in Hyperion nicht gefundenIP/Hostname, gleiches erreichbares Netz, mDNS/Multicast sowie Gerätestatus prüfen; IP manuell setzen
LEDs bleiben dunkelLED-Netzteil, GND, DIN, GPIO und Datenrichtung prüfen; zuerst WLED allein testen
Falsche Farben oder SeitenRGB-/GRB-Reihenfolge und Hyperion-LED-Layout korrigieren
Ruckler, Aussetzer oder VerzögerungWLAN-Signal, Kanalbelastung, LED-Anzahl und Ausgaberate isoliert testen
Nur ein Teil des Streifens leuchtetLED-Anzahl, WLED-Segmente, Stromversorgung und Einspeisung kontrollieren
Bild ist nicht dynamischHyperion-Capture/Quelle prüfen; WLED liefert keine eigene HDMI-Bildanalyse

Weitere Hilfen: LEDs bleiben dunkel, Ambilight flackert und Falsche Farben.

Wann lohnt sich WLED statt direkter Pi-Verkabelung?

WLED + ESP32

Sinnvoll, wenn die LEDs an einem vom Pi entfernten Standort sitzen oder du sie separat für WLED-Effekte nutzen möchtest. Der Controller ist unabhängig vom Pi-GPIO, benötigt aber eine stabile Netzwerkverbindung.

Direkter GPIO-/SPI-Anschluss

Weniger Netzwerkkomponenten und ein einheitlicher Hardwareaufbau. Für APA102/SK9822 bleibt das eine gut dokumentierte Alternative, wenn Pi und LED-Streifen am selben Ort sind.

Falls du gleichzeitig HyperHDR und Hyperion vergleichen möchtest, gilt: Beide können WLED integrieren, doch die konkreten Treiber und Projekt-Schwerpunkte unterscheiden sich. Diese Anleitung beschreibt bewusst den offiziell dokumentierten Hyperion-WLED-Weg.

Offizielle Quellen

Hyperion: WLED-LED-Ausgabe und DDP · WLED 16.0.1 – Release vom 07.07.2026 · WLED: Quick Start · WLED: Wiring Guides · WLED: unterstützte LED-Typen.

Redaktioneller Stand: 21.11.2026. Die Schritte beruhen auf der offiziellen Dokumentation und sind keine Behauptung eines eigenen Hardware- oder Leistungstests. Elektrische Sicherheit und Board-Pinout immer vor dem Einschalten prüfen.

Passend dazu

Diese Anleitungen passen dazu