WLed: A binding for controlling LED strips and strings from an opensource esp8266 project

This binding is now merged into openHAB V3.x and the binding should be installed as per normal. There is a newer version in the marketplace addon available whilst it goes through the review process. This newer version has better segment support and uses the JSON API.

If you dont have the marketplace in your openHAB version, the newer jar can be downloaded here

Index of /openhab/wled/ (pcmus.com)

There is also a jar available for openHAB 2.x which you can find links to in this thread, however if you want segment support you will need to upgrade to V3.1 and newer.

The GitHub project for the firmware for an ESP device and plenty of info on how to get the hardware going:


To build some great Christmas lights that have built in FX the WLED project is great. All you need is…

  • 5v 2 amp power supply (old phone charger that is 2a is perfect and easy to find a free one)
  • Wemos D1 mini clone $3
  • WS2811 Strings of LED which cost $10 per 50 leds all wired up with plugs. 4 strings plug end to end to give you 200 LEDs which is great for a 7+ foot tree.
  • plugs and heatshrink to make it all neat.

A case you can print to house it all in…

1 Like

Post away young man, post away…

1 Like

Please post I will give it a try

Yes I will try this binding.

Segment support would be nice

With which project on esp8266 will this work?

Source code and precompiled jar is now linked in the first post. If you wish to use google/Alexa to control colours and brightness you need to select the SOLID fx and also the fader that selects how long to take to transition a change should be at the min setting for this to really shine.

This one which is covered in multiple videos on youtube if you wish to learn more or see it in action.


Just uploaded a newer version today that…

  • Fixes an issue in the android app due to dimmers giving a decimal place that caused an error.
  • FX list fixed and should be correct now.
  • Numbers added to the start of the FX to help know the number to use in rules.
  • Logging should not mention milight anymore.

New version uploaded today 2019-12-13

  • Updated FX list as version 0.9 firmware now has FX with different names and other changes.
  • Fixed bug that sent palettes to the preset list.
  • Now will show up correctly as off if turned off in the app or the sleep timer.

Can be used on the older firmwares with no problems just some of the FX will be named differently.

1 Like

Exelent work

I have installed newest jar file from wled-2019-12-13.zip
Thing comes to life easily.

In http://openhabianpi:8080/paperui/index.html#/control?tab=OTHER
I can’t see or use all of the functions like on/off

I suspect that is because there is no channel for on off only dimmer (not a problem)

I use VS Code to autogenerate Items and they don’t all show up properly as all channels are not defined in the thing I suspect. (not a problem)

Note to people other than matt1 this is not how you setup items yet.

I am super happy at your progress

How do you do that?
Another thread perhaps?

1 Like


A colour channel can be bound/linked to a “Switch” a “Dimmer” and a “Color” Element, and once you do that you will have all the controls showing up. See the examples in the readme file.

This has the advantage that when you ask Google or Alexa to control X light, you can call it the same thing for on/off and changing colour if you only tag the colour channel all the controls work through that one channel.

My color items are as per the Readme

Color WLedStringTest "WLED" ["Lighting"] {channel="wled:wled:001:0eb121:colour"}
Switch WLedStringTestSwitch   "on/off"    {channel="wled:wled:001:0eb121:colour"}
Dimmer WLedStringTestDimmer   "level"     {channel="wled:wled:001:0eb121:colour"}

and contol section looks like

This binding is going to make it so easy to setup wled thanks for all the work you are putting in.

You will find there are some errors in the logs warning you your syntax is wrong.

What is correct 0eb121 VS test
Auto001 VS 001

It works so if it does not for you then look what is different between the ones that do and the ones that do not.

Ok that a rookie cut paste mistake on my part.

Its all working accept for trying to select FX in basic ui sitemap

Works fine selecting fx for me and if it cycles it will keep updating the fx name if another control is moved.

I uploaded a newer version which now updates the brightness fader. I am probably done with this binding until they make the mqtt topic changes.


It is all working now.

I running openhabian on PI3 / openHAB 2.4.0-1 (Release Build)
Presets works perfectly. When I selected FX or presets in Basic UI it would freeze.

  • I loaded your latest jar file from wled-2019-12-13.zip
  • Made separate sitmap to isolate code.
  • Restarted openhab
    openhabian@openHABianPi:~$ sudo systemctl restart openhab2.service
  • Celebrate in success :partying_face:

I will now wait paitently for Wled MQTT topics to be finnished so we can start this all over again. Thankyou and have a well deserved break.

What a great binding. It works really well to control my outdoor LED strips. And I learned a great trick using VS code to generate items and sitemaps. Thanks @matt1 and @denominator.