Repolode
wled

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

    Leia o guia de início rápido e a documentação em kno.wled.ge

  2. 2

    Grave o firmware em uma placa ESP32 seguindo os tutoriais da wiki

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