You can use a button in WLED to control various settings.
Open up the LED settings screen in WLED under "Config". Scroll to the button setup section and set button 1 to use pin 18 (Sparkle Motion) or pin 13 for the QT Py Pico (also known as M0 -- find the number on the pinout diagram), with the type set as "Pushbutton".
Click Save. Try pressing your button and see if your effects change.
Assigning to Presets
The default behavior for button 1 is to cycle through effects. However, you can change this and set up the button for any number of behaviors using the Button Actions.
For your button, enter the number assigned to the your control presets.
For example, here an "advance effect" preset is number 22, so 22 is setup under "short press". Then, a "toggle" preset is number 21, so 21 is setup as a "long press". A "playlist toggle" to preset 20, so a double-click of the button will turn sound reactive mode on or off.
Troubleshooting
If your button isn't working, here are some things to try:
- Double check both the LED preferences page and the Time & Macros page to be sure your settings are correct, and have saved.
- Be sure your presets are correctly numbered. WLED gets confused if the presets have non-sequential IDs (so make sure they're numbered 1, 2, 3 rather than 2, 5, 7).
Page last edited December 16, 2025
Text editor powered by tinymce.
