LED Matrix Planner
Preview a WLED LED matrix behind a diffuser before you build it. Change the strip density, row count and diffuser gap, and see what happens when sockets get in the way.
Planner
Pick an effect and adjust the strip. The figures update as you go.
The preview is an approximation. Real blending depends on the diffuser material, and the effects are stand-ins for WLED's own. “Gap to blend” is a rule of thumb (about 1.05 × the larger LED spacing), not a measured value.
Downloads
Files for the 42 × 16, 634-LED splashback (30 LEDs/m, 16 rows, sockets on). They do not change with the planner's settings.
Use one WLED map or the other, never both. WLED ignores the gap file when a ledmap is present. Neither file has been tested on hardware yet, and the 2D ledmap format changed between WLED 0.14 and 0.15, so test on the actual controller with a simple effect before final assembly.
WLED LED map
ledmap.json: the physical LED index for every matrix position from the top-left, with −1 where a socket leaves a gap. It already holds the serpentine order, so it replaces the panel's serpentine setting.
WLED gap file
2d-gaps.json: the simpler alternative. 1 for a fitted LED and −1 for a missing one, used with a normal 42 × 16 serpentine panel set-up.
Layout data
layout.json: the panel, sockets, every row, which LEDs are kept and the two controller outputs, in millimetres from the bottom-left corner.
Kitchen splashback build
Proof of concept for one side of the kitchen, the side without cooking. If it works, the other side follows.
Summary
| Panel | 1400mm wide × 550mm high |
|---|---|
| Purpose | Ambient effects behind a diffuser |
| Strip | 12V WS2815, 30 LEDs/m, IP65 |
| Matrix | 42 columns × 16 rows |
| LED spacing | 33.3mm along the strip, 34.4mm between rows |
| LEDs fitted | 634 (672 on the full grid, 38 removed for sockets) |
| Diffuser gap | About 35 to 40mm, to be confirmed by testing |
| Control | WLED on an ESP32, two outputs |
Wiring outputs
| Output 1 | Rows 1 to 8, 298 LEDs, fed at the left end of row 1 |
|---|---|
| Output 2 | Rows 9 to 16, 336 LEDs, fed at the left end of row 9 |
- Serpentine: row 1 runs left to right, row 2 right to left, and so on. Rows count from the bottom.
- Rows 4 and 5 are cut around the sockets, keeping columns 1–2, 11–26, 34–37 and 42; the pieces are bridged with four-core wire.
- WS2815 links carry 12V, ground, data and backup data. Tie the backup data pad of the first LED on each output to ground.
- Inject 12V and ground at the start, middle and end, each feed fused at about 5A.
- WLED: output lengths 298 and 336; 2D set-up as one 42 × 16 panel.
Parts
- Five 5m reels of 12V WS2815, 30 LEDs/m, IP65 (one row from joined offcuts).
- ESP32 WLED controller with level shifter, fuse and at least two outputs.
- 12V power supply, 10A or more (for example Mean Well LRS-150-12, 12.5A), with WLED's current limiter set to match.
- 1.0mm² (18AWG) cable, Wago 221 connectors, inline fuses.
- Backing board, 1400 × 550mm.
- 3mm opal acrylic front panel, fixed with mirror screws so it lifts off for access.
- Black frame around each socket and the perimeter, acting as the spacer.
Still to do
- Measure the real faceplate and back-box sizes and update the socket layout. The current sizes come from a hand sketch.
- Design and make the socket and perimeter frames.
- Tape up three or four rows and test the diffuser gap with the actual sheet.
- Draw the wiring diagram.
- Electrician to bring the sockets forward to the new surface.