Build a Smart LED Matrix with WLED

A beginner guide to addressable LEDs.

Smart LEDs look amazing, but getting started can feel overwhelming. What controller do you need? How do you calculate power requirements?

This guide walks you through building an 8x32 LED matrix running WLED. WiFi-controlled, 100+ built-in effects, controllable from any phone. No soldering, no coding.

Components

You need three things: LEDs, a controller, and a power supply.

1. LEDs

BTF-Lighting 8x32 WS2812B matrix

I'm using a BTF-Lighting 8x32 WS2812B matrix - 256 addressable LEDs at 5V.

When shopping, pay attention to LED count and voltage. These determine your other components.

2. Controller

ESP32 microcontroller

The controller runs the software that drives the LEDs. You can go full DIY with an ESP32 for a couple of euros, but then you're dealing with level shifting, fuses, and flashing firmware yourself.

Athom WLED High Power Addressable LED Strip Controller

For beginners: get an Athom WLED Controller. Pre-installed with WLED, proper power handling included.

Power Supply

Your power supply depends on LED count. Each WS2812B draws up to 60mA at full brightness. For 256 LEDs: potentially 15A at 5V - so you need at least 75W.

👉 I built a calculator at ledlab.io to work this out for any project.

I'm using a 5V 10A laptop-style adapter. Combined with a barrel jack connector, it plugs straight into the Athom controller - no wire crimping needed.

Shopping List

Component

Amazon

Alternative

BTF-Lighting 8x32 Matrix

Athom WLED Controller

5V 10A Power Adapter

Barrel Jack Connector

Assembly

The Athom controller comes with two cables: 4-pin and 3-pin. The 4-pin is for LEDs that need a clock signal. WS2812B doesn't, so use the 3-pin (power, ground, data).

The matrix has matching JST connectors - plug and play. Connect the barrel jack to the controller, plug in the adapter.

Done. Under 2 minutes.

BTF-Lighting Matrix, Athom WLED Controller, Barrel Jack Connector, 5V 10A Power Adapter

WLED Configuration

WiFi Setup

The Athom creates its own WiFi network on first boot. Connect with your phone, enter your home WiFi credentials in the popup (or browse to 4.3.2.1).

Set a hostname like christmas - you can then access it at christmas.local instead of an IP address.

LED Settings

Open WLED in your browser and go to Config > LED Preferences:

  • Maximum current: 8000mA (below the adapter's 10A limit)

  • Voltage: 5V

  • LED type: WS2812B

  • Color order: GRB (not RGB - common mistake)

  • LED count: 256

  • GPIO: 1 (default for Athom)

2D Matrix Configuration

Go to Config > 2D Configuration:

  • Width: 32

  • Height: 8

  • Layout: Serpentine

If your effects look wrong, you probably need to adjust:

  • Starting corner (mine: bottom right)

  • Direction (mine: vertical)

Test tip: Use the "Scrolling Text" effect. If text reads correctly left-to-right, your config is right.

Effects

WLED has dozens of built-in effects. Save your favorites as presets for quick access.

You don't even need a browser - the WLED app (iOS / Android) finds any WLED device on your network automatically.

Done

That's it. The power calculations and WLED configuration apply to any addressable LED project - Christmas lights, ambient lighting, whatever you're building.

Resources:

Keep Reading

No posts found