Sistema baseado em configuração que transforma microcontroladores ESP32, ESP8266, BK72xx e RP2040 em dispositivos inteligentes controlados pelo Home Assistant e por outros sistemas de automação residencial.
wled/WLED
Firmware open source para ESP32 que controla fitas de LED RGB endereçáveis, matrizes 2D e painéis HUB75 via Wi-Fi.
Alternativa open source a:Philips Hue
- Estrelas
- 18,904
- Forks
- 4,418
- Issues abertas
- 514
- Último commit
- há 22 horas
O que é?
WLED é um firmware para microcontroladores ESP32 que controla LEDs endereçáveis, como WS2812B e muitos outros tipos de chips RGB digitais. Ele roda no próprio microcontrolador e pode ser controlado por uma interface web, um app para celular ou sistemas externos via Wi-Fi.
O firmware inclui mais de 200 efeitos integrados, muitos deles reativos ao áudio, além de mais de 50 paletas de cores e um editor de paletas. Os segmentos permitem que diferentes partes de uma instalação de LEDs executem efeitos distintos ao mesmo tempo, enquanto presets e playlists armazenam e alternam configurações. O firmware oferece suporte a matrizes 2D com mapeamento de painéis, painéis de matriz RGB HUB75 em ESP32 e fitas RGBW, RGB+CCT e somente brancas.
O WLED se integra ao MQTT, ao Home Assistant, à Alexa, à sincronização com Philips Hue e a protocolos no estilo DMX, como E1.31, Art-Net e DDP. Também oferece uma API JSON e HTTP, sincronização UDP entre dispositivos, sincronização sem fio ESP-NOW e um sistema de usermods para adicionar módulos personalizados.
Recursos principais
- 01Mais de 200 efeitos integrados, incluindo efeitos reativos ao áudio e para matrizes 2D
- 02Segmentos para executar efeitos e paletas diferentes em partes separadas de uma mesma instalação
- 03Suporte a WS2812B, SK6812, APA102 e muitos outros chips de LED endereçáveis
- 04Suporte a matrizes 2D e painéis RGB HUB75 com mapeamento flexível
- 05MQTT com descoberta pelo Home Assistant, além de E1.31, Art-Net e DDP para controle DMX
- 06APIs JSON e HTTP com um sistema de usermods para extensões personalizadas
Casos de uso
- Criar iluminação ambiente para um cômodo, TV ou mesa, controlada pelo celular ou pelo Home Assistant
- Criar painéis de LED reativos ao áudio ou iluminação sincronizada com música
- Controlar grandes letreiros de matriz de LEDs ou painéis HUB75 com um ESP32
- Integrar iluminação endereçável a instalações de palco ou sistemas DMX profissionais
Início rápido
- 1
Leia o guia de início rápido e a documentação em kno.wled.ge
- 2
Grave o firmware em uma placa ESP32 seguindo os tutoriais da wiki
- 3
Conecte-se ao dispositivo com o app WLED para Android ou iOS
Antes de usar
- É voltado para microcontroladores ESP32, portanto precisa de hardware compatível para funcionar.
- Licenciado sob a EUPL v1.2, uma licença copyleft que exige que obras derivadas permaneçam de código aberto.
- O README alerta que o projeto não é recomendado para pessoas propensas à epilepsia fotossensível.
Em coleções
Tópicos
Perguntas frequentes
- O que é WLED?
- Firmware open source para ESP32 que controla fitas de LED RGB endereçáveis, matrizes 2D e painéis HUB75 via Wi-Fi. WLED é um firmware para microcontroladores ESP32 que controla LEDs endereçáveis, como WS2812B e muitos outros tipos de chips RGB digitais. Ele roda no próprio microcontrolador e pode ser controlado por uma interface web, um app para celular ou sistemas externos via Wi-Fi.
- WLED é gratuito? Qual é a licença?
- WLED é open source sob a licença EUPL-1.2. Confira os termos da licença antes de usá-lo em produtos comerciais.
- WLED ainda é mantido?
- Manutenção ativa. O último commit de WLED foi em 23 de out. de 2026.
- Para que posso usar WLED?
- Criar iluminação ambiente para um cômodo, TV ou mesa, controlada pelo celular ou pelo Home Assistant Criar painéis de LED reativos ao áudio ou iluminação sincronizada com música Controlar grandes letreiros de matriz de LEDs ou painéis HUB75 com um ESP32 Integrar iluminação endereçável a instalações de palco ou sistemas DMX profissionais
- Como instalar WLED?
- Leia o guia de início rápido e a documentação em kno.wled.ge Grave o firmware em uma placa ESP32 seguindo os tutoriais da wiki Conecte-se ao dispositivo com o app WLED para Android ou iOS
- Onde consigo WLED?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/wled/WLED
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Uma implementação enxuta de Python 3 que roda em microcontroladores e outros dispositivos com recursos limitados, com módulos para acesso ao hardware.
Transforma um ESP32 em um sensor de movimento Wi-Fi local e privado, que detecta movimentos por meio de alterações nos sinais Wi-Fi, sem câmera nem microfone.
SDKs e firmware open source para criar seus próprios gadgets Muse em placas ESP32 e dispositivos Linux, como o Raspberry Pi.
Um emulador open source de ESP32 em Rust que executa firmware real no computador ou no navegador, sem precisar de hardware.
Integração oficial da Xiaomi que conecta dispositivos IoT inteligentes da marca ao Home Assistant pela Xiaomi Cloud ou por um hub gateway local.