wled/WLED

项目介绍

WLED 是运行在 ESP32 微控制器上的开源固件，用来驱动可寻址 RGB LED，从单条灯带到 2D 矩阵和 HUB75 面板都能覆盖。固件在设备端独立运行，提供网页界面和网络 API，也能通过手机 App、MQTT、DMX/Art-Net、Philips Hue 等方式控制。

它面向制作灯效的创客和爱好者，可用于家居、活动布景或氛围灯项目。主要能力包括：200 多种内置效果、50 多种调色板及自定义调色板编辑器、2D 映射、音频反应效果（麦克风、线路输入或网络音源）、把灯带分成多个独立段分别设置效果，以及最多 250 个预设和播放列表。ESP32 上借助并行 I2S 和 RMT 最多支持 17 路 LED 输出，另有 PWM 输出、多种板卡的以太网支持和完整的 OTA 升级。

快速使用

1. 先确认硬件与灯带兼容：查看兼容硬件列表和兼容灯带列表。
2. 给 ESP32 刷入固件：从 WLED 发布页下载版本；首次刷写通常使用网页安装器或 esptool，具体步骤见快速开始文档。
3. 给板子上电并连接它发出的 WiFi 热点，打开网页界面，设置灯带类型、引脚和长度。
4. 可选：把板子接入家庭 WiFi，之后用网页界面、Android 或 iOS App，或 JSON、HTTP API 控制。

分步教程汇总在入门指南。

使用约束

• 硬件要求：需要 ESP32 系列芯片（原版、S2、S3、C3），并搭配兼容的灯带或面板，不是在通用电脑上运行的软件。
• 供电与安全：请按输出启用自动亮度限制（Auto Brightness Limiter），避免电源过载；项目提示光敏性癫痫人群不要使用，或避开频闪、闪电、噪声效果及高速度设置。
• MQTT、E1.31/Art-Net、DDP、Hue 同步等网络功能需要局域网内存在对应的服务或控制器。
• 许可证为 EUPL v1.2，按该许可证不承担设备或人身损害责任。

HotRepo 点评

2026-11-06，WLED 在 GitHub C++ 日榜上记录到第 6 名，当天新增 10 Star，总 Star 18,989、Fork 4,448。项目创建于 2016 年，在 LED 控制和集成上的功能深度与这段积累相符。目前只有一条日榜记录，只能说明当天的榜单位置，不足以据此判断热度趋势。