I soldered my button touch wire to pin 18.
In the LED Settings screen, scroll to the button setup section and set button 1 to use pin 18, with the type set as "Pushbutton".
I advise against using button 0. WLED's buttons have some default behaviors written in, and one of button 0's default behaviors is that when it's pressed for more than a few seconds, it resets your microcontroller to factory settings. I originally had button 0 selected, and I held the button down a bit too long while I was sewing it onto the hat, and .. POOF. All my settings and presets were wiped out.Â
Check out the "Backup" section under the Additonal Settings page to learn to back up your configuration and presets, in case this kind of thing happens to you.
In WLED, the default actions for button 1Â are designed to provide basic control without custom programming.
Button 1 Behaviors:
- Short Press:Â Cycles to the next effect.
- Long Press:Â Ramps brightness up/down.
- Double Press:Â Cycles through color palettes.
- Default State: If no custom macro is defined, the button defaults to these built-in functions, as outlined in the WLED documentation.Â
If you're happy with this, you're done! But if you want to take control of your button to do custom actions of your choosing, read on.
Head to the Time & Macros config screen. Scroll down to the Button actions area.Â
For button 1, enter the number assigned to the control presets you made on the last page. My Next_FX preset is number 9, so I entered 9 under "short press", and my Toggle preset is number 10 so I've got that set up as a "long press".Â
I also added the toggle mode that toggles between playlists to preset 11, so a double-click of my button will turn sound reactive mode on or off, since one of my playlists has sound reactive effects and the other doesn't.
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).
- Be sure you're soldered to pin 18 on the Sparkle Motion -- the screw terminal pins will not read button presses.
Page last edited April 06, 2026
Text editor powered by tinymce.