Juwel HeliaLux Smart Controller

This is a custom component for Home Assistant that creates sensors to show details about your Juwel HeliaLux Smart Controller. It is (heavily) based on pyHelialux by moretea, but has been adapted to play nicer with Home Assistant (tested against 2025.1).

Once installed it gives you a bunch of sensors and a new light that you can turn on and off.

Available sensors

• tankname_blue
• tankname_green
• tankname_red
• tankname_white
• tankname_current_profile
• tankname_manualcolorsimulationenabled
• tankname_manualdaytimesimulationenabled
• tankname_tropical_tank_profile
• tankname_tank_sensor (this combines all the above sensors into one)

How to install

Before we head down the install route, if you are upgrading from the original rubbish version I wrote years back, please read the upgrade guide.

Once you have done that...

You can either install it via Hacs (search for Juwel Helialux) or download this repo and copy it to your config/custom_components folder on your Home Assistant install.

Once you've done either of those, restart your Home Assistant. Once Home Assistant is back up, head over to Settings -> Integrations and add Juwel Helialux. Fill out the information (you'll need to know the host/ip). Your sensors and light should (hopefully) appear.

Once installed

You'll have your sensors listed above and a new light (light.tankname_light) to play with.

Things to be aware of

The Juwel Helialux unit is a bit clunky and is easily overloaded (mine at least). So when you are changing colours it can get overloaded and not do what you want it to do. Also, Home Assistants way of dealing with colours on the colour wheel doesn't play overly well with the Juwel Helialux Controller. If you are having trouble getting just RGB colours then drag the white brightness down and have a wiggle with the colour wheel. I'm working to fix it but tbh, I don't really know what I am doing. Any other bugs then please post on GitHub.

Check your firmware version!

jakerol pointed out that v1 firmware don't appear to work with this custom component, please make sure your HeliaLux firmware is at least v2.1 (why wouldn't you be on v2.. v1 was ugly). You can update by heading over to your Juwel HeliaLux controller webpage, click on the settings click and click the info link at the bottom of the page (in the middle, possible an "i" icon) and then click firmware.