An ESP32-S3, an LED strip, a browser. That's it.

...and a 24V PSU, an XL4015 DC-DC module, a 330Ω resistor and a few solder joints.
But those are details.

Not sure how you got here? The README has the full story.

GitHub · MIT / GPL-3.0 / CC0 ·

Install the CLI

rleds is the terminal tool for managing devices, provisioning WiFi over Bluetooth and running the WebSocket proxy.

npm install -g @reactive-leds/cli

After installing, run rleds --help to see the list of available commands.

Start the proxy as described in Live Preview, and open to start controlling your devices.

CLI README →

Install the Firmware

Chrome or Edge only.

Use the "Connect" button below to install the latest firmware release directly from your browser.

Your browser doesn't support Web Serial. Try Chrome or Edge.

Configure WiFi via USB

Network Password

After flashing, configure WiFi via Web Serial above, run rleds credential from the or use rleds bt-credential over Bluetooth.

Firmware README →

PROXY

Start the local proxy, then connect below.

Devices

The proxy lists your devices on startup — copy the addresses here to control them.

view source

Mapping

Canvas mapping projects what you draw on a canvas onto the strips — made for live coding. Place each strip on the virtual grid, then copy the ready-to-use snippet from the Usage panel below.

PROXY

Start the local proxy, then connect below.

Devices

Grid

Cols × Rows

Export

Usage

Ready to paste into your sketch: connects to the proxy, keeps only the devices that answer, and streams the canvas — sampled along each polygon's centerline — to the strips.

Hydra

Generated from this mapping and ready to run in the Hydra web editor.

Background

Click to select · Drag to move · Drag corner to scale · Shift+corner = free vertex