WLED on ESP8266 NodeMCU

wled Dec 11, 2020

Just a little description on how I flashed WLED onto my NodeMCU ESP8266 4MB Flash using Linux Mint 19.3 (Ubuntu 18.04.3 LTS).

The NodeMCU Board:

  • NodeMCU ESP8266 version 2.0.
  • 80 MHz 32 bit RISC processor with WiFi.
  • 4 MB flash.
  • 16 IO ports.
  • Hardware SPI.
  • AD converter.
  • Onboard UART for flashing via USB.
  • Needs 5V - or driven by the USB port.

Get the WLED Binary bin file:

https://wled.me goes to:

Releases · Aircoookie/WLED
Control WS2812B and many more types of digital RGB LEDs with an ESP8266 or ESP32 over WiFi! - Aircoookie/WLED

Download the *.bin applicable to your board, I chose the following for the 4MB-flash NodeMCU board I have:


Get The HomeFlasher:

Choose the one which works for your OS. I'm on 64bit Ubuntu so I downloaded this executable one:


Yes I know, it would probably be easier to install it on Windows, but I'd rather use my Linux daily driver for everything if I can. If you are in the same position then this is how you do it on Linux Mint.

Install the WxPython stuff for the UI on Ubuntu:

Linux Notes

Installing wxpython for linux can be a bit challenging (especially when you don't want to install from source). You can use the following command to install a wxpython suitable with your OS:

# Go to https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ and select the correct OS type# here, we assume ubuntu 18.03 bionic:

pip3 install -U \     -f https://extras.wxpython.org/wxPython4/extras/linux/gtk3/ubuntu-18.04 \     wxPython

Connect your NodeMCU to the USB-port on your computer.

Right-click on the the ESPHome-Flasher-1.3.0-Ubuntu-x64.exec file and choose "open", or run it as stated on your OS.

Choose the serial port and the firmware file location. Click "Flash ESP".

The window should render like this:

After the flash ends you should get a computer with wifi and find the wireless network from the NodeMCU, it is called something like wled:WLED when you look for the SSID. The password to the WLED wifi-ap is "wled1234". Change the wifi settings in WLED so that you can connect the NodeMCU to your own wifi-network, login to the WLED homepage on the new IP after it has connected to your wifi lan.

Setup the LED specifications in WLED and what else you need to change, such a NTP timezone, passwords, etc.

Set a static IP for the NodeMCU or use your routers DHCP to assign a static IP to the NodeMCU MAC address.

Connect your LED data-cable to D4 on the NodeMCU.

This is how my test-setup looks like:

On the breadboard you see two NodeMCU ESP8266 and a YwRobot voltage regulator with two 5V rails, I feed it with a 5V 2.5A transformer.

The YwRobot is a power supply module for experimenters who have to test/prototype electronic circuits on breadboard or perforated/veroboards. It has a maximum output current of: <700 mA.

WLED is fantastic - from Zero to Hero in 5 min!

You know what... take a look at this video on how to do it all:

Amazing stuff :)

WLED really is a fantastic project and achievement and it runs fast without any lag. How is it even possible to run it on such a small device? I think RISC is really offering something great here and we will hear more about RISC in the future as it is the future of IoT.

Now the next step is to add it to HomeAssistant and controlling it from there, but you can use it as is, the UI is really good. WLED is actually build for mobile users first but you can click on PC-Mode in the UI for PC user experience. How cool is that!

Checkout Dr.Zzs Youtube content for good ideas: https://www.youtube.com/c/DrZzs

Also checkout Bitluni on YouTube, great stuff: https://www.youtube.com/c/bitlunislab

Why do we need light? Without beautiful light life is sad!

Now let's build some nice Christmas light!!!


Flemming Frederiksen

Currently focusing on building microservices and provide a low-latency Radio Broadcasting Network in Copenhagen. Doing extensive research, studying, etc. This is a personal site for your pleasure.

Great! You've successfully subscribed.
Great! Next, complete checkout for full access.
Welcome back! You've successfully signed in.
Success! Your account is fully activated, you now have access to all content.