Welcome to LedFx ✨ Making music come alive!
What is LedFx?
LedFx makes your LEDs dance to audio! 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
Visit our website to see LedFx in action!
You can also join our Discord where community members show off their projects. Check out the #projects or #showcase channels.
📑 Quick start guide and documentation📖
Head over to LedFx Builds to get the latest releases for Windows, Mac and Linux. If you are in a hurry, grab the latest Core version for your operating system and off you go. For more info on what the different versions do, read the release description on the releases page
Bleeding edge (Experimental)
If you want the absolute bleeding edge and are not afraid of using the terminal, take a look at the detailed installation instructions here: Installation documentation.
Documentation
Documentation for the LedFx-Builds can be found here: Stable documentation
Documentation built against this repository can be found here: Latest 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.
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!
- Install LedFx.
After you have WLED installed on your ESP device, download: LedFx.exe and install LedFx.
For Mac and Linux LedFx Builds, or 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.
More information for Linux and macOS users here.
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 bottom click Home, ->
Scan for WLED devices
button, or click on the big plus sign andAdd Device
to 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
under ClassicYour lights should now be reacting realtime to your music! Enjoy the show 🌈
🧑💻 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. We expect and require all contributors to read, understand and follow our code of conduct.
Credits: Contributors-&-About
License
- REST API
- /api/info
- /api/config
- /api/log
- /api/schema/
- /api/schema/<schema_type>
- /api/devices
- /api/devices/<device_id>
- /api/find_devices
- /api/find_launchpad
- /api/find_openrgb
- /api/get_nanoleaf_token
- /api/get_gif_frames
- /api/get_image
- /api/effects
- /api/effects/<effect_id>
- /api/virtuals
- /api/virtuals/<virtual_id>
- /api/virtuals/{virtual_id}/effects
- /api/virtuals/<virtual_id>/presets
- /api/virtuals_tools
- /api/virtuals_tools/<virtual_id>
- /api/effects/<effect_id>/presets
- /api/scenes
- /api/integrations
- /api/integrations/qlc/<integration_id>
- /api/integrations/spotify/<integration_id>
- WebSocket API
License
LedFx is licensed under the GNU GPLv3 license.