Installing the Audio-Reactive Module

Installing the Audio-Reactive Module

The Audio-Reactive Module adds a microphone to your RGB2Go controller, enabling WLED's audio-reactive effects. Your lights will respond in real time to music, speech, or ambient sound — perfect for parties, events, and immersive displays.

1 Verify or Update Your Firmware

Audio-reactive functionality requires a compatible version of the WLED firmware. Check the table below to determine if your current firmware already supports it, or if re-flashing is required.

Firmware Version Audio-Reactive Support
v0.14.x Requires re-flashing with the A/R-enabled firmware (filename ends in "-AR")
v0.15.x and later Built into the base firmware — no re-flashing required unless using a non-base variant

If re-flashing is required, use our Web Flasher to install the correct firmware. For manual flashing instructions, visit our Firmware Flashing Guide.

2 Install the Audio-Reactive Module
Important: Disconnect all power from the controller before installing or removing any expansion module.

Align the Audio-Reactive Module with the expansion header on your controller. The module has a semicircle cutout on one edge — align this with the corresponding marking on the controller PCB to ensure correct orientation.

Audio-Reactive module alignment animation

Align the semicircle cutout on the module with the marking on the controller.

Press the module firmly and evenly into the header, ensuring all pins are fully seated before applying power.

3 Enable the AudioReactive Usermod

Power on the controller and open the WLED web interface. Click the Info button in the top menu bar.

Locate the AudioReactive entry in the list and click the power icon next to it to enable it.

Enabling AudioReactive in the WLED Info menu

Click the power icon next to "AudioReactive" to enable the module.

Not seeing AudioReactive in the list? Your firmware may not include audio-reactive support. Return to Step 1 and re-flash with the correct firmware version.
4 Select an Audio-Reactive Effect

With AudioReactive enabled, a range of audio-reactive effects become available in WLED's effects list. These effects are marked with a musical note icon (♪).

Audio-reactive effects in WLED effects list

Audio-reactive effects are identified by the musical note icon in the effects list.

Select any effect with the note icon to activate it. The Gravimeter effect is a popular starting point — it displays a real-time frequency visualizer across your LEDs.

Tip: For best results, position the microphone module facing outward toward the sound source. Avoid enclosed housings that may muffle the microphone.
🎉
Your Audio-Reactive Module is now active!
Your lights will now respond in real time to music and sound. Experiment with the full range of audio-reactive effects in WLED to find the look that suits your setup.