Skip to main content

Build Status License Documentation Status Discord

https://i.imgur.com/SFWfhFr.png

LedFx website: https://ledfx.app/

What is LedFx?

What LedFx offers is the ability to take audio input, and instantanously processes the audio into realtime lightshow 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 syncronised 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:

https://raw.githubusercontent.com/ahodges9/LedFx/gh-pages/demos/ledfx_demo.gif

📑 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.

https://i.imgur.com/vzyHNwG.png

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

  1. Build your networked LED Strip.
    • For most, this is the difficult step. Dont 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!

  2. Install LedFx.
  3. Direct computer audio output to LedFx.
  4. 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, or Add Device to add them manually.

    • If they’re still not showing up, make sure they’re powered on and properly connected to your Wifi.

  5. Start using effects!
    • Click on the device, select an effect eg scroll(Reactive), and press Set effect button.

    • Your 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! Discord

Contributing

Pull requests are welcome. Once tested, contact LedFx developer community on Discord to discuss the next step.

Credits: Contributors-&-About

License

MIT

Metadata

Release files for ledfx-dev 0.9.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ledfx-dev 0.9.0
File Size Uploaded
ledfx-dev-0.9.0.tar.gz 1.6 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for ledfx-dev 0.9.0
File Interpreter ABI Platform
ledfx_dev-0.9.0-py3-none-any.whl Python 3 none any Details

Total release size: 6.1 MB

Release files / ledfx-dev-0.9.0.tar.gz

Download URL ledfx-dev-0.9.0.tar.gz
Size 1.6 MB
Tags Source
SHA-256 checksum
How to use checksums
8a4a9fcdf323bbedc85728de7bb68bad14a6787fb78e0726efe20fb5e3729431
BLAKE2b-256 checksum
How to use checksums
7eaf24d8f80dc9d41d97aa656c4ae1e4cdb5554d9bbd8112366ceb7f24320f20
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.53.0 CPython/3.9.0

Release files / ledfx_dev-0.9.0-py3-none-any.whl

Download URL ledfx_dev-0.9.0-py3-none-any.whl
Size 4.6 MB
Tags Python 3
SHA-256 checksum
How to use checksums
6709a76bf36071de9915cb11c13742a166348b188f6aced45a6751bb638e384b
BLAKE2b-256 checksum
How to use checksums
9677e03f799a8dace490c0117fcbe8239570792da0d7d1a7bba0dae1671d48c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.2.0 pkginfo/1.6.1 requests/2.24.0 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.53.0 CPython/3.9.0
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page