Welcome to LedFx ✨ -Making music come alive!¶
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!
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.
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!
- 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.
Test you can access the WLED web interface from your PC. If so, then you’re good to go!
- 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 devicesbutton, or
Add Deviceto add them manually.
If they’re still not showing up, make sure they’re powered on and properly connected to your WiFi.
- Start using effects!
Click on the device, select an effect eg
scroll(Reactive), and press
Your lights should now be reacting realtime to your music! Enjoy the show 🌈
🧑💻 Join the LedFx Community¶
To join, click on the Discord button below:
Pull requests are welcome. Once tested, contact LedFx developer community on Discord to discuss the next step. We expect and require all contributors to read, understand and follow our code of conduct.
- REST API
- /api/log (upcoming)
- WebSocket API
LedFx is licensed under the MIT license.