Matrix Setup
WLED has a handy 2d-matrix setup feature that will take care of the mapping for you on a rectangular matrix. This matrix is 8x8, which is the default setting in WLED, making it easy.
You can chain two of these matrices together and get a 16x8 matrix with 128 pixels, or chain more than that for more lights. The WLED interface makes it easy to set up any size of rectangular matrix you'd like.
Go back to Config and choose the 2D Configuration tab.
Change the dropdown to read 2d Matrix, and additional options will appear. If you want to sync more than one panel, you can do it here.
Set up your layout numbers to match the number of rows and columns in your project. You can also change orientation here - my pixels start in the lower left corner and finish in the upper right.
Matrix Effects
WLED has a hefty number of matrix effects that appear in the list when you've got your 2d matrix set up. Click the little square in the "filters" popup to see only the 2d matrix effects. Many of them can be customized with speed and intensity sliders, or different color palettes. Go wild!
For even more options and patterns, check out the Matrix Portal Stained Glass with WLED guide. This will walk you through installing MoonModules code with a lot more kaleidoscopic effects for your matrix.
Page last edited February 03, 2026
Text editor powered by tinymce.
