home/ atoms/ wled-multiple-ledmaps-per-preset

WLED supports multiple named ledmaps selectable per preset

Beyond a single ledmap.json, WLED’s recent firmware supports additional maps named ledmap1.json, ledmap2.json, etc. A preset can specify which map to use by including {"ledmap":x,...} in its JSON payload. This lets a single WLED device switch between entirely different logical pixel arrangements at runtime — useful for performance rigs that re-purpose the same LED matrix for different visual setups or songs without touching hardware.

Examples

A preset that activates map 2: {"ledmap":2,"on":true,"bri":128}.

Assessment

Describe a live-performance scenario in which switching ledmaps mid-set would be useful, and write the preset snippet that would select ledmap 3.

“Multiple maps are supported in the latest versions by using `ledmapx.json` where x is a number. Maps can be selected in a preset using `{"ledmap":x,...`.”
corpus · wled-led-mapping-documentation-pixel-matrices · chunk 1