Migrating from WLED

RavLight runs on the same hardware WLED runs on — QuinLED, Gledopto, generic ESP32 boards. Switching over is a full re-flash, and takes a few minutes.

What's different from WLED?

WLED treats the device as a generic LED strip with effects. RavLight treats it as a DMX fixture: it has personalities, a patch address, multi-universe Art-Net/sACN reception, wired DMX512 in/out on supported boards, and a scene recorder. If your workflow is a lighting console, Resolume, MadMapper or xLights driving the device as a fixture, that's what RavLight is built for. Ethernet is a first-class citizen — WiFi is the fallback, not the default.

1 · Erase the flash — this is not optional

WLED and RavLight use different partition tables and different filesystems. Flashing RavLight on top of a WLED install without erasing leaves stale data that can cause boot loops or corrupted config. Always start clean.

Option A — web installer

Open the web installer in Chrome or Edge, connect the board over USB, pick your board, and make sure "Erase device" is checked before you click Install. That single pass wipes the WLED install and writes the complete RavLight image.

Option B — esptool

pip install esptool
esptool --chip esp32 --port COM5 erase_flash
esptool --chip esp32 --port COM5 --baud 460800 write_flash 0x0 elyon_quinled_octa_vX.Y.Z.bin

Use the merged binary (bootloader + partition table + firmware + web UI in one file, flashed at address 0x0) from release/latest. Replace COM5 with your port (/dev/ttyUSB0 on Linux).

2 · Reconfigure — WLED settings do not carry over

There is no config import from WLED. WiFi credentials, LED output settings and E1.31/Art-Net settings all need to be entered again — the models are different enough that automatic conversion would do more harm than good.

1. After flashing, the board boots into a WiFi access point named RavLight-XXXX (fixture-prefixed, e.g. Elyon-RVXXXX).
2. Connect to it and open http://4.3.2.1.
3. Set up Ethernet or WiFi in the Network section, then configure your LED outputs in the fixture section.

3 · Re-create your output layout

What WLED calls "LED outputs" maps to Elyon's per-output configuration: LED type, pixel count, color order, start universe and channel, grouping, and brightness — see the Elyon guide. One thing to double-check: universe numbering. RavLight universes are 0-based like raw Art-Net; if your WLED setup used 1-based E1.31 universes, shift accordingly (details in Protocols).