Projekt loxHueBridge - Bidirektionale Philips Hue V2 Anbindung

[Ulairi]

Ich bräuchte Hilfe, weil ich sonst nicht weiß wo ich fragen könnte.

Hat zufällig schon jemand diese Lampen in Hue integriert und in weiterer Folge in Loxone? https://www.lampenwelt.at/p/luumr-sm...-10010339.html

Mein Elektriker hat bei der Außenbeleuchtung für den Garten einen Blödsinn aufgeführt und ich muss da jetzt eine Lösung dafür finden. Mein Plan wäre Außenleuchten mit G9 Lampe zu nehmen und diese Lampe dann in Hue integrieren und in weiterer Folge in Loxone.

Habe bis jetzt nur originale Hue Lampen integriert, deswegen weiß ich nicht, ob das ohne Probleme funktioniert.

[bausi2k]

Keine Ahnung, wenn sie HUE Kompatibel sind, werden sie funktionieren. Aber am besten mal eine bestellen und testen
sofern du mein System zum laufen bringst bzw. dich damit auskennst, wie du das zum laufen bringst?

[Ulairi]

Dein System habe ich schon am Laufen, funktioniert spitze. Aber eben nur mit Originalen Hue Lampen. Mit Lampen von Drittherstellern habe ich keine Erfahrung.

[Philip Cetl]

So, ich war kurz davor die alten Bridges auszupacken! Nun hab ich Dein Script auf meinen ungenutzten Rasbperry gepackt und es auch ohne Probleme alles installiert bekommen per Docker Methode. Alle Lampen hinzugefügt und auch gestet die Reaktion ist super schnell. Nun aber mein ABER jetzt wollte ich Exportieren und in Loxone importieren... da hänge ich - ich gehe mal davon aus das in der aktuellen Version der Weg sich geändert hat. Geräte Vorlagen zu finden, das konnte ich ja finden. Nun sagt er mir wenn ich den Export auswähle das es ein falsches Format ist.. also kann mir hier jemand helfen? Irgendwo mach ich doch sicher was falsch...

Ja, ich zähle zu den nicht Experten..

[bausi2k]

2.3.0] - 2026-05-04

🌟 New Features

• Hue Effekte & Alert: Lampen können jetzt per einfachem Befehl in spezielle Effektmodi versetzt werden – vollständig rückwärtskompatibel zu allen bestehenden Steuerungen.
  • /{name}/alert → Einmaliges Breathe-Blinken (ideal für Alarmierung, Türklingel-Bestätigung, etc.)
  • /{name}/candle → Kerzenflackern 🕯️ (persistent bis zum Stoppen)
  • /{name}/fire → Feuereffekt 🔥 (persistent, nur neuere Lampen)
  • /{name}/prism → Regenbogen-Farbwechsel 🌈 (persistent, nur Farblampen)
  • /{name}/sparkle, /opal, /glisten → weitere atmosphärische Effekte
  • /{name}/noeffect → Aktiven Effekt stoppen
  • /{name}/sunrise/30 → 30-Sekunden Sonnenaufgang-Simulation 🌅 (oder beliebige Dauer in Sekunden)
• Erweiterter Diagnose-Tab: Der Diagnose-Tab zeigt jetzt drei Abschnitte:
  1. 📋 Geräte & Batterien (bekannt)
  2. 🌐 Bridge & Zigbee Netzwerk – Verbindungsstatus (connected / connectivity_issue) jedes einzelnen Zigbee-Geräts, Bridge-ID und Zeitzone
  3. 🎭 Lampen-Fähigkeiten – Übersichtstabelle zeigt pro Lampe, ob Dimmen ✅, Farbe ✅ und Weißton ✅ unterstützt werden, sowie alle verfügbaren Effekte.
• Nativer "Alles" Befehl: Der Befehl /all (bzw. /alles) nutzt nun die native bridge_home Ressource der Hue Bridge, um das gesamte Zuhause nahezu verzögerungsfrei zu schalten. Im UI ist die Option „🏠 Alle Lichter (bridge_home)" jetzt im Dropdown wählbar.
• Batterie-Warnsystem: Geräte mit einem Batteriestand von ≤ 10 % werden im Dashboard optisch hervorgehoben (rotes Badge + Leer-Symbol 🪫).
• Automatisierte Tests: Einführung einer robusten Test-Infrastruktur basierend auf dem nativen Node.js Test-Runner (node:test) mit 16 Tests und > 85 % Abdeckung der Kernmodule.

[herdan]

Hallo zusammen,

einfach genial, wie hier alles am Laufen gehalten wird. Tolle Arbeit! Habe die loxHueBridge auf dem Loxberry seit kurzem am Laufen. Super! Mich hat hingegen das Docker- Plugin gestört. Resp. habe ich nur eine alte Version gefunden, die nur bedingt Loxberry 3.x kompatiebel, resp. das Loxberry- Webinterface nicht aufrufbar ist. Habe das Plugin für Loxberry 3.x angepasst und einige Features hinzugefügt zwecks Überwachung etc.
Das Ganze ist hier zu finden wenn Ihr interesse habt.

herdan75/loxberry-docker-diagnostics: Docker & Portainer integration plugin for LoxBerry with system diagnostics and ARM64 support

Läuft bei mir aktuell auf einem Odroid N2+ (aarch64 Kernel). Siehe nachfolgende Details aus der Systemdiagnose des Plugins.
Das ganze sollte auch unter anderen Plattformen laufen.
Könnte gerne mal reinschauen (ggf. vorher eine Sicherung machen).

[serenity]

Hallo und Frage in die Runde, wie aktualisiere ich die LoxHueBridge auf eine neue Version ohne die bisherige Konfiguration zu verlieren?
Sie läuft bei mir im Synology NAS im Container Manager.

Vielen Dank schonmal für die Unterstützung und danke bausi2k für die tolle Arbeit!

[bausi2k]

gerne und ich errinnere immer wieder gerne, dass ich auch viel von meiner FamilienZeit investiere. https://www.buymeacoffee.com/bausi2k

[serenity]

Lass Dir den Kaffee schmecken

Habe es selbst gelöst. Einfach im Container Manager --> Projekt die loxhuebridge stoppen.
Dann unter Details in der .yaml statt :latest :2.3.0 eintragen, speichern und die Frage ob neu geladen werden soll bestätigen. Dann wird der Container mit dem Image neu erstellt. Konfiguration blieb wie erwartet erhalten (liegt ja im data Ordner).

[herdan]

Update: 18.05.2026:

Version: V2.5.0-dev (Develop)

Ich habe zusätzlich einen develop-Branch angelegt
main bleibt der stabile Stand, neue Funktionen werden zuerst in develop getestet.

Neu in develop für Mehrlampensynchronisation in verschiedenen Gruppen/ Räumen:

• Mehrlampensynchronisierung jetzt mit Gruppen A-E
• Gruppen frei benennbar, z. B. Wohnzimmer, Büro, Küche
• eigene Timing-/Rate-Einstellungen pro Gruppe
• globale Bridge-Sicherheitsgrenze über alle Gruppen
• README und CHANGELOG entsprechend ergänzt

Anleitung zum Installieren des develop wie auch wechsel zwischen develop und main wie auch weitere Beschreibungen findet Ihr unter README: loxhuebridge_mehrlampensteuerung/README.md at develop · herdan75/loxhuebridge_mehrlampensteuerung

Wenn alles stabil läuft, wird develop später nach main gemerged.

Viel Spass

*************************************************


Update: 17.05.2026:

Hallo zusammen,

ich möchte hier kurz meinen Fork der loxHueBridge vorstellen, da bei mir beim gleichzeitigen Steuern vieler Hue-Lampen Probleme aufgetreten sind:

https://github.com/herdan75/loxhuebridge_mehrlampensteuerung

Der Fork basiert auf dem genialen Projekt von bausi2k und erweitert die Bridge vor allem um zwei Punkte:

1. robustere Hue EventStream/SSE-Verarbeitung
2. einstellbare Mehrlampensynchronisierung für mehrere einzelne Hue-Lampen

Behobenes Problem: Hue EventStream JSON Parsing

Beim gleichzeitigen Steuern mehrerer Hue-Lampen, in meinem Fall ca. 11 Lampen mit Farbwechseln, traten sporadisch Fehler im EventStream auf, z. B.:

• Unexpected end of JSON input
• Unterminated string in JSO
• Expected double-quoted property name in JSON

Die Ursache war vermutlich, dass TCP-Chunks nicht zwingend vollständige SSE-Events enthalten. Der ursprüngliche Code hat einzelne empfangene Chunks bzw. Zeilen direkt geparst. Bei größeren Events oder vielen gleichzeitigen Updates kann dadurch ein JSON-Fragment geparst werden.

Im Fork wird der EventStream nun gepuffert und erst verarbeitet, wenn ein vollständiges SSE-Event vorhanden ist. Dadurch sollten diese sporadischen JSON-Parsing-Fehler bei großen Hue-Events behoben sein.


Neue Mehrlampensynchronisierung

Zusätzlich gibt es jetzt eine Mehrlampensynchronisierung pro einzelner Hue-Lampe. Ziel ist, mehrere einzelne Hue-Lampen möglichst zeitnah zu steuern, ohne die Hue Bridge komplett mit gleichzeitigen REST-Requests zu überfahren.

Die Steuerung ist bewusst einstellbar, weil die offiziellen Herstellerlimits eher konservativ sind und jede Installation etwas anders reagieren kann.

Neu einstellbar sind u. a.:

• Sammelfenster, in dem mehrere Loxone-Kommandos gesammelt werden
• Batchgröße
• Batch-Pause
• maximale Lichtbefehle pro Sekunde
• Timing-Test / Simulation
• pro Lampe aktivierbare Mehrlampensynchronisierung
• Sync-Offset pro Lampe
• Wichtig: Der Startzeitpunkt jeder Lampe kann über den Sync-Offset feinjustiert werden. Damit lässt sich z. B. eine Lampe, die etwas träger reagiert, früher ansteuern, oder eine schnell reagierende Lampe etwas verzögern.

Der Timing-Test zeigt direkt an:

• wie viele Lampen aktiv sind
• welcher Mindestabstand zwischen Befehlen verwendet wird
• wann der letzte Befehl gesendet wird
• welche effektive Befehlsrate entsteht

Für 10-11 Lampen ist z. B. ein Start mit 20/s sinnvoll, danach kann man 25/s oder optional 30/s testen. Bei 429-Fehlern, verzögerten Reaktionen oder nicht sauber übernommenen Farben reduziert man den Wert wieder.

Weitere Details sind im README auf GitHub beschrieben.


Screenshots

Neue globale Einstellungen:



Geräte-Details pro Lampe:


Installation

Per Docker/Portainer oder SSH, z. B.:

git clone https://github.com/herdan75/loxhuebr...nsteuerung.git cd loxhuebridge_mehrlampensteuerung docker compose up -d --build

Falls bereits eine alte loxHueBridge läuft, sollte der alte Container vorher gestoppt werden. Den vorhandenen data-Ordner kann man übernehmen, wenn bestehende Config/Mappings erhalten bleiben sollen.


Status

Der Fork wurde mit Syntaxchecks und Tests geprüft. Die SSE-Verarbeitung und die neue Multi-Sync-Scheduler-Logik sind mit Tests abgesichert.

Vielleicht ist das für alle interessant, die mehrere einzelne Hue-Lampen gleichzeitig aus Loxone heraus steuern und dabei sporadische EventStream-Fehler oder verzögerte/falsche Updates gesehen haben.

Feedback und Tests in anderen Setups sind natürlich willkommen.


************************************************** ****************************


Alte Nachricht mit festgestelltem Problem resp. obige Anpassungen aufgrund der nachfolgenden Feststellungen:

Hallo bausi2k

Deine Idee wie auch Umsetzung ist echt toll. Es haben doch recht viele Loxone- Smarthomebesitzer Hue eingebunden. Dank Deiner Idee lebt das Ganze weiter. Auch ich habe loxhuebridge auf meinem Loxberry am Laufen. Funktioniert soweit alles super.
In meinem Setup steuere ich sehr viele einzelne Lampen auf einmal. Dies geht leider nicht via Hue- Szenen, da ich im Lichtbaustein von Loxone eine Abient- Szene habe mit verschiedenen Farben. Daher sind die Lampen einzeln zu steuern.
Beim Testen ist mir ein möglicher Fehler im SSE/EventStream Parsing aufgefallen.

Aktuell wird der EventStream in hue.js so verarbeitet:
response.data.on('data', (chunk) => {
const lines = chunk.toString().split('\n');

lines.forEach(line => {
if (line.startsWith('data: ')) {
processHueEvents(JSON.parse(line.substring(6)));
}
});
});

Anscheinend funktioniert das meist, führt wahrscheinlich aber unter Last (viele gleichzeitige Farbwechsel / große Events) zu sporadischen JSON Parsing Fehlern wie in meinem Fall mit gleichzeitiger Steuerung von 11 Lampen:

• Unexpected end of JSON input
• Unterminated string in JSON
• Expected double-quoted property name

Der Grund scheint zu sein, dass TCP Chunks nicht mit vollständigen SSE Events identisch sind.

SSE Events werden laut Spezifikation über eine Leerzeile (\n\n) terminiert. Aktuell wird jedoch direkt pro empfangenem TCP chunk bzw. pro Zeile geparsed.

Dadurch gönnen ggf. potentiell fragmentierte JSON Payloads entstehen, insbesondere bei grösseren Hue Farb-/XY Updates.

Möglicherweise wäre ein gepufferter SSE Parser robuster, z. B.:
let eventBuffer = '';

response.data.on('data', (chunk) => {
eventBuffer += chunk.toString();

const events = eventBuffer.split('\n\n');

eventBuffer = events.pop();

events.forEach(event => {
event.split('\n').forEach(line => {
if (line.startsWith('data: ')) {
const jsonStr = line.substring(6).trim();
processHueEvents(JSON.parse(jsonStr));
}
});
});
});

Hier noch die espliziten Fehlerloggs:

13:24:05.022 SYSTEMERROR
EventStream JSON Parsing Fehler:
Unterminated string in JSON at position 4073
(line 1 column 4074)

oder

13:24:04.010 SYSTEMERROR
EventStream JSON Parsing Fehler:
Expected double-quoted property name in JSON
at position 4073
(line 1 column 4074)

oder

10:35:05.105 SYSTEMERROR
EventStream JSON Parsing Fehler:
Unexpected end of JSON input


Dies als kleiner Hinweis. Ggf. ist das für alle Anderen die die loxhuebridge benutzen kein Problem.
Ist warschienlich auch absult kein Beinbruch.

Lieben Gruss und nochmals herzliches Dankeschön für die tolle Arbeit!

Vielen lieben Gruss aus der Schweiz.

[bausi2k]

danke, ich schau mir das mal mit Gemini an ;-)

Edit: DAs hab ich falsch gelesen… danke für deine eigene Erweiterung

[SchmuFoo]

Titel: Feature-Request: Kerzenschein für die Masse (Effekte auf Gruppen) 🕯️🤖

danke, ich schau mir das mal mit Gemini an ;-)

Hallo bausi2k,

dein KI-Assistent hat ja aktuell Hochkonjunktur, da dachte ich, ich füttere deine Pipeline direkt mit der nächsten "Side-Quest"! 😉

Ich habe gestern Abend mal die neuen Hue Effects angefeuert. Ergebnis:

• Einzelne Lampe: http://loxhuebridge:8555/wohnzimmer_...k_links/candle -> Läuft! Absolute Romantik. ✅
• Ganze Gruppe: http://loxhuebridge:8555/wz_group/candle -> Dunkelkammer / Keine Reaktion. ❌

Das technische "Warum": Die Hue API v2 ist bei Effekten wie candle oder fireplace eine ziemliche Diva. Sie akzeptiert diese payloads nativ nur auf dem /resource/light Endpunkt, streikt aber, wenn man sie auf /resource/grouped_light abfeuern will (weil eine Gruppe strukturell wohl nicht synchron wie eine einzelne Kerze flackern kann/darf/soll).

Die Idee / Der Feature-Request: Können wir der Bridge beibringen, bei Effekt-Keywords einen ähnlichen Sequenz-Fallback hinzulegen, wie du ihn in der routes.js schon für die normalen numerischen Werte (Helligkeit/Farbe) drin hast?

Wenn entry.hue_type === 'group', müsste die Bridge das Mapping einfach nach den zugehörigen light-IDs auflösen und den Effekt per Schleife an die einzelnen Lampen verteilen.

Hier wäre der "Arbeitsauftrag", den du deiner Gemini direkt in den CLI-Rachen werfen könntest:

 "Der Effekt-Aufruf für Gruppen schlägt fehl, da die Hue-API v2 Effekte nur auf /resource/light und nicht auf /resource/grouped_light erlaubt. Bitte passe executeEffect in hue.js so an, dass bei Typ group das Mapping nach allen zugehörigen light-IDs durchsucht wird und der Effekt als Schleife an die einzelnen Lampen-IDs verteilt wird (analog zum Sequenz-Fallback bei den regulären Dimm-Befehlen)."

Wäre verdammt cool, wenn demnächst das ganze Wohnzimmer auf einen Schlag im Kerzenschein erstrahlt, ohne dass ich jede Funzel einzeln an-CURL-n muss!

Danke dir für deinen genialen Einsatz bei der Bridge! 🚀

[herdan]

Hallo SchmuFoo

Finde die Idee der loxhuebridge von bausi2k echt genial.
Habe mich daher entschieden einen fork zu erstellen, da ich Probleme mit der Steuerung / Ansprechen vieler einzelnen Lampen hatte. Wollte das nicht als Raum oder Zone über Hue machen, da ich im Ambientmodus (Lichtszene Loxone) je Lampe verschiedene Farben habe und doch alle miteinander pro Raum schalten möchte. Dies hat jeweils zu den Fehlern
- Unexpected end of JSON input
- Unterminated string in JSON
- Expected double-quoted property name
geführt.
Dies wurde mittels der Fork- Version 2.5.0 mit Integration einer Merlampensynchronisation inkl. Raumzuordung (wenn verschiedene Merlampensynchronisationen in verschiedenen Räumen) umgesetzt. Zudem den SSE/EventStream Parser robuster gemacht. Siehe https://github.com/herdan75/loxhuebr...main/README.md

Finde die Idee, Effekte wie candle light an gruppen zu senden interessant.Schau mal hier im develop branch des forks nach: https://github.com/herdan75/loxhuebr...elop/README.md
Vielleicht ist das die Lösung die Du oben angefragt hast. Wenn alles funktioniert wird einfach der jeweilige Effekt bei allen Lampen gestartet. Dass dann aber alle Lampen gleichzeitig resp. im Glechtakt "flackern" ist wahrscheinlich nicht möglich, da diese nach meinen Recherchen direkt aus der jeweiligen Lampe heraus gesteuert wird.

Bei Lust und Laune einfach mal testen.

Gruss