# LedFx/LedFx

LedFx is a network based LED effect engine designed to deliver advanced real-time audio effects to a wide variety of devices.

Repository: https://github.com/LedFx/LedFx
Canonical: https://ross.abutalabs.com/products/ledfx
Homepage: https://docs.ledfx.app/en/stable
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: python, music-visualizer, audio-processing, qlc, led-strips, react, webinterface, e131, raspberry-pi, microphone, wled
Last push: 2026-08-24T23:06:10+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 84, longevity 100
- inputs: {"age_days": 2084, "days_push": 9, "days_rel": 107, "gap_med": 19.5, "n_releases_24m": 21}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2031, forks 234 (observed 2026-08-28T04:06:07.265121+00:00)

## What it is
LedFx is a network-based LED effect engine that processes real-time audio input into synchronized light shows across multiple LED strips and matrices. It runs as a Python backend with a browser-based React frontend on port 8888, controlling devices like WLED on ESP8266/ESP32 nodes via E1.31.

## Use cases
- sync LED strips to music in real time
- control multiple WLED devices across a house with synchronized effects
- build an audio-reactive ambient lighting setup with ESP8266 and WS2812B strips
- run a music visualizer on Raspberry Pi driving LED matrices
- configure and visualize LED effects from a browser interface
- integrate LED lighting control into home automation via REST or WebSocket API

## When to choose
- you want audio-reactive lighting effects without writing effect code yourself
- you have multiple networked LED devices (WLED, ESPixelStick) to synchronize
- you want a web UI plus REST/WebSocket APIs for programmatic control
- you're running on Windows, macOS, Linux, or a Raspberry Pi with Python 3.10+

## When to avoid
- you need offline or USB-only LED control with no network devices
- you want simple static lighting scenes rather than audio-driven effects
- you need a headless embedded controller running directly on the ESP itself
- you require a non-GPL license for commercial embedding

## Facets
- artifact type: application
- maturity: active
- function: audio-processing, http-server, websocket, gui, developer-tools
- domain: iot, hardware, self-hosted
- platform: python, windows, cross-platform, self-hosted, iot, browser
- tags: led-strips, wled, e131, music-visualizer, esp8266, esp32, raspberry-pi, react-frontend, rest-api, lighting-control, smart-home, real-time, audio, automation, macos, linux, web-server, docker

## Member repositories
- LedFx/LedFx (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:07.265121+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:59:31.239193+00:00, confidence not recorded.
  - readme: https://github.com/LedFx/LedFx (fetched 2026-08-28T04:06:07.265121+00:00, sha a6be3647ba15)
  - homepage: https://docs.ledfx.app/en/stable (fetched 2026-08-29T10:39:36.273483+00:00, sha fac6df4fe705)
  - site_page: https://docs.ledfx.app/en/stable/installing.html (fetched 2026-08-29T10:39:36.276362+00:00, sha 91d96a06bcd8)
  - site_page: https://ledfx.app/about (fetched 2026-08-29T10:39:36.278279+00:00, sha 92c50a861d49)
  - site_page: https://docs.ledfx.app/en/stable/developer/guides.html (fetched 2026-08-29T10:39:36.280231+00:00, sha 65b7614218cb)
  - site_page: https://docs.ledfx.app/en/stable/README.html (fetched 2026-08-29T10:39:36.281818+00:00, sha e76e17c3f497)
  - site_page: https://docs.ledfx.app/en/stable/apis/api.html (fetched 2026-08-29T10:39:36.283466+00:00, sha 09421c5e7104)
  - site_page: https://docs.ledfx.app/en/stable/apis/assets.html (fetched 2026-08-29T10:39:36.285811+00:00, sha 2d378fa1eaa3)
- Data as of 2026-08-30T08:39:29.467469+00:00.