Juwel aquarium light in Home AssistantJuwel-Aquarienlicht in Home Assistant

Your aquarium light,
fully local.Dein Aquarienlicht,
ganz lokal.

HeliaLux talks to the Juwel HeliaLux SmartControl over its own web server: every channel as a slider, real transitions, profiles, clouds and a sun cycle, and it keeps the colour Home Assistant set. Robust, complete, no cloud.HeliaLux spricht mit der Juwel HeliaLux SmartControl über ihren eigenen Webserver: jeder Kanal als Schieberegler, echte Übergänge, Profile, Wolken und Sonnenverlauf, und sie hält die Farbe, die Home Assistant eingestellt hat. Robust, vollständig, ohne Cloud.

Install with HACSMit HACS installieren Read the READMEZur Anleitung

Version 26.10.2 Home Assistant 2026.9 or newer · English and German · Apache 2.0Home Assistant 2026.9 oder neuer · Deutsch und Englisch · Apache 2.0

Just arrivedGerade neu

Steadier profiles,
quieter logs.Verlässlichere Profile,
ruhigeres Log.

The latest releases make the integration tougher against odd answers from the lamp and more careful with your profiles.Die letzten Releases machen die Integration robuster gegen seltsame Antworten der Lampe und vorsichtiger mit deinen Profilen.

26.10.2

True to the profileTreu zum Profil

Before the first point of a profile the value of that point applies, exactly as on the lamp, instead of a wrongly extrapolated one.Vor dem ersten Punkt eines Profils gilt der Wert dieses Punkts, genau wie an der Lampe, statt eines falsch hochgerechneten.

26.10.2

Safe profile namesSichere Profilnamen

Names with characters the lamp cannot store are rejected before saving, so a profile on the lamp is never mangled.Namen mit Zeichen, die die Lampe nicht speichern kann, werden vor dem Speichern abgelehnt, ein Profil in der Lampe geht so nie kaputt.

26.10.2

Wind in any unitWind in jeder Einheit

Clouds from weather convert knots and feet per second correctly.Wolken nach Wetter rechnen Knoten und Fuß pro Sekunde richtig um.

26.10.2

One run, not twoEin Lauf, nicht zwei

Holding the state starts only once, even for two polls in quick succession.Das Halten des Zustands startet nur einmal, auch bei zwei Abfragen kurz hintereinander.

26.10.1

Calendar versionsKalender-Versionen

Releases count year.month.number: 26.10.2 is the second release of October 2026.Releases zählen Jahr.Monat.Nummer: 26.10.2 ist das zweite Release im Oktober 2026.

Everything that changed, release by release: the changelog.Alles, was sich geändert hat, Release für Release: das Changelog.

What it doesWas sie kann

Every channel, every profile.
Right in Home Assistant.Jeder Kanal, jedes Profil.
Direkt in Home Assistant.

Built and tried out on a Juwel Trigon 190 with a HeliaLux SmartControl, firmware 2.2.2.Gebaut und ausprobiert an einem Juwel Trigon 190 mit HeliaLux SmartControl, Firmware 2.2.2.

Every channel a sliderJeder Kanal ein Regler

White, blue, green and red from 0 to 100 %, right on the device page, plus the service set_channels.Weiß, Blau, Grün und Rot von 0 bis 100 %, direkt auf der Geräteseite, dazu der Dienst set_channels.

An RGBW light with transitionsRGBW-Licht mit Übergängen

Brightness keeps the mix, transition fades in gentle steps, switching on brings back the last mix.Helligkeit behält die Mischung, transition blendet in sanften Schritten, Einschalten bringt die letzte Mischung zurück.

Holds what you setHält, was du einstellst

After a power cut the colour comes back by itself, the manual colour simulation is extended before it runs out.Nach einem Stromausfall kommt die Farbe von selbst zurück, die manuelle Farbsimulation wird vor dem Ablaufen verlängert.

No fight with the appKein Kampf mit der App

Changes in the Juwel app are taken over; start the daytime simulation and Home Assistant steps back.Änderungen in der Juwel-App werden übernommen; startet die Tagsimulation, gibt Home Assistant ab.

Clouds, sun and weatherWolken, Sonne und Wetter

Cloud strength and motion, a cloud window, clouds from a weather entity and a sun cycle that follows sunrise and sunset.Wolkenstärke und -zug, ein Wolken-Fenster, Wolken nach einer Wetter-Entität und ein Sonnenverlauf nach Sonnenauf- und -untergang.

Diagnostics that helpDiagnose, die hilft

Reachable, lamp clock offset with a repair issue, remaining colour simulation time and a download without IP or MAC address.Erreichbar, Uhrabweichung der Lampe mit Reparatur-Hinweis, Restzeit der Farbsimulation und ein Download ohne IP- oder MAC-Adresse.

ProfilesProfile

The whole day.
Written from Home Assistant.Der ganze Tag.
Aus Home Assistant geschrieben.

  • Read and writeLesen und schreibenget_profile and set_profile with up to 16 points, saved permanently in the lamp.get_profile und set_profile mit bis zu 16 Punkten, dauerhaft in der Lampe gespeichert.
  • Weekly scheduleWochenplanOne profile for all days or one per weekday, Monday to Sunday.Ein Profil für alle Tage oder eines je Wochentag, Montag bis Sonntag.
  • Curve as dataVerlauf als DatenPoints per channel, clouds and what the profile would show right now, for charts in dashboards.Punkte je Kanal, Wolken und was das Profil gerade zeigen würde, für Diagramme in Dashboards.
  • AcclimatizationEingewöhnungA new tank starts dimmed and reaches full brightness after 1 to 12 weeks.Ein neues Becken startet gedimmt und erreicht nach 1 bis 12 Wochen volle Helligkeit.

EntitiesEntitäten

The IDs you already use.Die IDs, die du schon nutzt.

All IDs start with the tank name, for example light.trigon_190_light, and match the previous integration. Names in English and German.Alle IDs beginnen mit dem Beckennamen, zum Beispiel light.trigon_190_light, und entsprechen der bisherigen Integration. Namen auf Deutsch und Englisch.

PlatformPlattformEntityEntitätNoteHinweis
LightLichtlightRGBW, absolute channel values, transitionRGBW, absolute Kanalwerte, Übergang
NumberZahlwhite blue green redOne channel each, 0 to 100 %Je ein Kanal, 0 bis 100 %
SwitchSchaltermanual_color_simulation manual_daytime_simulation keep_manualHome Assistant or the lamp's profile decidesHome Assistant oder das Profil der Lampe bestimmt
SwitchSchaltersun_cycle acclimatization weather_cloudsRewrite the active profile at nightSchreiben das aktive Profil nachts um
SelectAuswahlprofil profile_monday … _sundayAll days or per weekdayAlle Tage oder je Wochentag
SelectAuswahlcloud_intensity cloud_motionClouds in the active profileWolken im aktiven Profil
TimeZeitcloud_from cloud_to sun_earliest sun_latestCloud window and sun cycle limitsWolken-Fenster und Grenzen des Sonnenverlaufs
Sensorcurrent_profile device_time profilesAttributes curve, profile_now, weekAttribute curve, profile_now, week
DiagnosticsDiagnosereachable clock_offset color_simulation_remainingWith the last errorMit dem letzten Fehler

How it worksWie es funktioniert

The lamp's own web server.
No cloud in between.Der Webserver der Lampe.
Keine Cloud dazwischen.

State every 15 seconds, profile names every 10 minutes. One request after the other, because the lamp only handles one at a time.Zustand alle 15 Sekunden, Profilnamen alle 10 Minuten. Eine Anfrage nach der anderen, denn die Lampe verträgt nur eine gleichzeitig.

Home AssistantHTTP, every 15 salle 15 s
statusvars.js
StateZustandchannels, mode, lamp clockKanäle, Modus, Lampenuhr
Home Assistanton changebei Änderung
POST /stat
ColourFarbechannels, colour and daytime simulationKanäle, Farb- und Tagsimulation
Home AssistantprofilesProfile
/pedit · /week.html
ScheduleZeitplanprofile points, clouds, weekly planProfilpunkte, Wolken, Wochenplan

It replaces MrSleeps' Juwel HeliaLux integration with the same domain and IDs. A rewrite, no code taken over; thanks for the groundwork.Sie ersetzt die Juwel-HeliaLux-Integration von MrSleeps mit gleicher Domain und gleichen IDs. Ein Neubau ohne übernommenen Code; danke für die Vorarbeit.

InstallInstallation

Three steps.
One IP address.Drei Schritte.
Eine IP-Adresse.

With HACSMit HACS

As a custom repository.Als benutzerdefiniertes Repository.

  1. In HACS, add a custom repository of type Integration:
  2. Füge in HACS ein benutzerdefiniertes Repository vom Typ Integration hinzu:
https://github.com/SH1FT-W/helialux
  1. Download Juwel HeliaLux and restart Home Assistant.
  2. Add the lamp. Settings, Devices & services, Add integration, Juwel HeliaLux; enter its IP address and the tank name.
  3. Lade Juwel HeliaLux herunter und starte Home Assistant neu.
  4. Füge die Lampe hinzu. Einstellungen, Geräte & Dienste, Integration hinzufügen, Juwel HeliaLux; IP-Adresse und Beckennamen eingeben.

New IP address later? Three dots, Reconfigure.Später eine neue IP-Adresse? Drei Punkte, Neu konfigurieren.

What you needWas du brauchst

No cloud account, no YAML.Kein Cloud-Konto, kein YAML.

  • Home Assistant 2026.9+RequiredNötig
  • A Juwel HeliaLux SmartControl in your Wi-FiEine Juwel HeliaLux SmartControl im WLANRequiredNötig
  • A fixed IP address for the lampEine feste IP-Adresse für die LampeRecommendedEmpfohlen
  • NTP (UDP 123) for the lamp's clockNTP (UDP 123) für die LampenuhrRecommendedEmpfohlen

Tested with firmware 2.2.2 (hardware 1.1C) and four channels. Lamps with fewer channels get fewer sliders.Getestet mit Firmware 2.2.2 (Hardware 1.1C) und vier Kanälen. Lampen mit weniger Kanälen bekommen weniger Regler.

Coming from MrSleeps' integrationUmstieg von der Integration von MrSleeps

  1. Remove "Juwel Helialux Smart Controller" in HACS, but keep the integration entry.
  2. Install Juwel HeliaLux and restart Home Assistant.
  3. Done. The existing entry is taken over: entity IDs, history, device and automations stay.
  4. „Juwel Helialux Smart Controller“ in HACS entfernen, den Integrationseintrag aber behalten.
  5. Juwel HeliaLux installieren und Home Assistant neu starten.
  6. Fertig. Der vorhandene Eintrag wird übernommen: Entity-IDs, Verlauf, Gerät und Automationen bleiben.

Three old entities stay behind as "no longer provided" (sensor.<name>_combined_sensor and two duplicate binary_sensor.<name>_manual_*) and can be deleted.Drei alte Entitäten bleiben als „nicht mehr bereitgestellt“ übrig (sensor.<name>_combined_sensor und zwei doppelte binary_sensor.<name>_manual_*) und können gelöscht werden.

Without HACSOhne HACS

Download the latest release, copy its custom_components/juwel_helialux folder into /config/custom_components/, restart Home Assistant and add the lamp.Lade das neueste Release herunter, kopiere den Ordner custom_components/juwel_helialux nach /config/custom_components/, starte Home Assistant neu und füge die Lampe hinzu.

Good to knowGut zu wissen

What the lamp
does its own way.Was die Lampe
auf ihre Art macht.

Why does the colour jump back?Warum springt die Farbe zurück?

Usually the lamp's web interface is still open in a browser. While it is open, it sends its own slider values every second and overwrites Home Assistant.Meist ist die Weboberfläche der Lampe noch im Browser offen. Solange sie offen ist, schickt sie jede Sekunde ihre eigenen Reglerwerte und überschreibt Home Assistant.

Why does the profile run at the wrong time?Warum läuft das Profil zur falschen Zeit?

The lamp sets its clock by NTP. Without internet access UDP 123 has to be allowed outwards. From 10 minutes off, a repair issue appears.Die Lampe stellt ihre Uhr per NTP. Ohne Internetzugang muss UDP 123 nach außen erlaubt sein. Ab 10 Minuten Abweichung erscheint ein Reparatur-Hinweis.

Why does a change in the app take a moment?Warum dauert eine Änderung in der App einen Moment?

The state is polled every 15 seconds (5 to 300 in the options). The lamp only handles one request at a time, so all commands run one after the other.Der Zustand wird alle 15 Sekunden abgefragt (5 bis 300 in den Optionen). Die Lampe verträgt nur eine Anfrage gleichzeitig, alle Befehle laufen nacheinander.

What happens to my profile with the sun cycle?Was passiert mit meinem Profil beim Sonnenverlauf?

Sun cycle and acclimatization recalculate the active profile every night at 03:05. Home Assistant keeps the original and writes it back when both are switched off.Sonnenverlauf und Eingewöhnung rechnen das aktive Profil jede Nacht um 03:05 neu. Home Assistant merkt sich das Original und schreibt es zurück, wenn beide aus sind.

All entities are unavailable. What now?Alle Entitäten sind nicht verfügbar. Was nun?

The lamp did not answer three times in a row. Check its IP address in your router and enter it with Reconfigure. Single lost requests are bridged.Die Lampe hat dreimal hintereinander nicht geantwortet. IP-Adresse im Router prüfen und über Neu konfigurieren eintragen. Einzelne verschluckte Anfragen werden überbrückt.

Is it discovered automatically?Wird sie automatisch gefunden?

No, each lamp is set up by its IP address, one lamp per entry.Nein, jede Lampe wird per IP-Adresse eingerichtet, eine Lampe je Eintrag.

How do I report a bug?Wie melde ich einen Fehler?

Download the diagnostics (Settings, Devices & services, Juwel HeliaLux, three dots) and attach them to a GitHub issue. IP address and MAC address are left out.Diagnose herunterladen (Einstellungen, Geräte & Dienste, Juwel HeliaLux, drei Punkte) und an ein GitHub-Issue hängen. IP- und MAC-Adresse sind nicht enthalten.

HeliaLux

Let there be light.
Locally.Es werde Licht.
Lokal.

One integration, every channel, no cloud.Eine Integration, jeder Kanal, keine Cloud.

Install HeliaLuxHeliaLux installieren ReleasesReleases