β¨
-Making music come alive!
Welcome to LedFx
LedFx website: https://ledfx.app/
What is LedFx?
What LedFx offers is the ability to take audio input, and instantaneously processes the audio into realtime light show to multiple LED strips/matrix. No need to spend hours on end to program one song to program your LEDs, as LedFx will do this all for you!
LedFx real-time LED strip music visualization effect controller using is a network based devices (ESP8266/ESP32/Raspberry Pi 4) with support for advanced real-time audio effects! LedFx can control multiple devices and works great with cheap ESP8266/ESP32 nodes allowing for cost effective synchronized effects across your entire house!
Demos
We are actively adding and perfecting the effects, but here is a quick demo of LedFx running three different effects synced across three different ESP8266 devices:
π
Quick start guide and documentation
π
Windows users can use the installer from the LedFx website: https://ledfx.app/download/
Mac and Linux are also supported, though currently do not have installers. For detailed installation instructions, see the installation documentation.
π
Show me how to make one!
The below image describes a basic setup - LedFx running on PC, communicating with a WLED Device controlling an LED strip.
Component | Example |
---|---|
Computer running LedFx | Windows 10, LedFx.exe |
Networked device controlling LED Strip | ESP8266 NODEMCU v3 running WLED |
Addressable LED strip | DC5V WS2812B 5 meters 60LED/m IP67 |
Power supply for LED Strip and ESP | 5V 10 amps LED Power Supply |
Something to connect the wires together! | Soldering iron/solder |
-
- Build your networked LED Strip.
-
- For most, this is the difficult step. Don't worry! There's guides here and online, and plenty of people able to help on WLED and LedFx Discord.
- Follow the WLED guide to connect the LED strip and ESP together: https://github.com/Aircoookie/WLED/wiki.
- Flash WLED to the ESP device: https://github.com/Aircoookie/WLED/wiki/Install-WLED-binary
- Ensure all WLED devices are powered on, and connected to your Wi-Fi 5Ghz.
- Test you can access the WLED web interface from your PC. If so, then you're good to go!
-
- Install LedFx.
-
- After you have WLED installed on your ESP device, download: LedFx.exe and install LedFx.
- For Mac and Linux, see the installation documentation or LedFx Guide.
-
- Direct computer audio output to LedFx.
-
- Follow guide, How to: Enable Stereo Mix in Windows 10.
- Alternatively use Voicemeeter. Voicemeeter tutorial.
- Mac users can use Loopback
- Play some music in the background.
-
- Start LedFx.
-
- Your WLED devices should appear in LedFx, automagically configured and ready to go!
π π₯ - If not, on the left hand side, click on Device Management ->
Find WLED devices
button, orAdd Device
to add them manually. - If they're still not showing up, make sure they're powered on and properly connected to your WiFi.
- Your WLED devices should appear in LedFx, automagically configured and ready to go!
-
- Start using effects!
-
- Click on the device, select an effect eg
scroll(Reactive)
, and pressSet effect
button. - Your lights should now be reacting realtime to your music! Enjoy the show
π
- Click on the device, select an effect eg
π§βπ»
Join the LedFx Community
Join the Discord server to discuss everything about LedFx!
To join, click on the Discord button below:
Contributing
Pull requests are welcome. Once tested, contact LedFx developer community on Discord to discuss the next step.
Credits: Contributors-&-About