WLED 控制

通过 HTTP JSON API 控制 WLED LED 灯带和矩阵。

要求

• - 同一网络中的 WLED 设备
• 设备 IP 地址或主机名
• Python 3（无需外部依赖）

使用方法

所有命令都需要使用 --host（或 -H）参数指定 WLED 设备的 IP 地址/主机名。

电源控制

bash
python3 scripts/wled.py -H power # 获取电源状态
python3 scripts/wled.py -H power on # 开启
python3 scripts/wled.py -H power off # 关闭

亮度

bash
python3 scripts/wled.py -H brightness # 获取当前亮度
python3 scripts/wled.py -H brightness 255 # 最大亮度
python3 scripts/wled.py -H brightness 128 # 50% 亮度

颜色

bash
python3 scripts/wled.py -H color 255 0 0 # 红色
python3 scripts/wled.py -H color 0 255 0 # 绿色
python3 scripts/wled.py -H color 0 0 255 # 蓝色
python3 scripts/wled.py -H color 255 255 255 # 白色

效果

bash
python3 scripts/wled.py -H effects # 列出所有效果及其ID
python3 scripts/wled.py -H effect 0 # 纯色
python3 scripts/wled.py -H effect 9 # 彩虹
python3 scripts/wled.py -H effect 9 -s 200 # 彩虹，快速
python3 scripts/wled.py -H effect 9 -i 128 # 彩虹，中等强度

调色板

bash
python3 scripts/wled.py -H palettes # 列出所有调色板及其ID
python3 scripts/wled.py -H palette 6 # 设置派对调色板

预设

bash
python3 scripts/wled.py -H presets # 列出已保存的预设
python3 scripts/wled.py -H preset 1 # 加载预设 #1

状态

bash
python3 scripts/wled.py -H status # 完整设备状态

参考

完整 API 文档请参见 references/api.md。

配置

通过在 ~/.wled/config.json 创建配置文件，避免每次都传递 --host 参数：

json
{
bedroom: 192.168.1.100,
kitchen: 192.168.1.101,
living_room: wled-abc123.local
}

然后使用别名：
bash
python3 scripts/wled.py -H bedroom brightness 255
python3 scripts/wled.py -H kitchen color 255 0 0

或者设置 WLED_HOST 环境变量：
bash
export WLED_HOST=192.168.1.100
python3 scripts/wled.py brightness 255

查找您的 WLED 设备

通常可以通过以下方式找到 WLED 设备：

• - 路由器管理面板（查找 ESP 设备）
• mDNS/Bonjour：wled-.local
• WLED 应用发现

静态 IP 推荐

IP 地址会随时间变化。为避免更新配置，请在 WLED 设备上设置静态 IP：

选项 1：基于路由器（最简单）

1. 1. 打开路由器管理面板
2. 通过 MAC 地址查找 WLED 设备
3. 保留/分配静态 IP

选项 2：在设备上设置

1. 1. 访问 WLED 网页界面 http://<当前-ip>
2. 进入设置 → WiFi 设置
3. 手动设置静态 IP
4. 保存并重启

使用 mDNS 主机名（例如 wled-abc123.local）也可以避免 IP 追踪——路由器会自动解析这些名称。