๐ General Description
The WLED Control mod lets you remotely control WLED-powered LED strips using simple HTTP commands. It enables color changes (RGB & HEX), activates visual effects, and can temporarily override the current LED state before returning to the previous one.
Perfect for use in reaction systems, bot actions, alerts, or lighting-based feedback.
โ ๏ธ Requirements
A WLED device running in your network
WLED must be accessible via HTTP (default:
http://<your-ip>/win)A local config file (
wled-config.json) is required to define the WLED base URLaiostool must be able to reach the WLED IP from the machine it's running on
๐ ๏ธ Configuration
Create a config file named wled-config.json and place it in the modโs config folder. Example content:
{
"host": "http://192.168.2.160/win"
}This sets the default base URL for the WLED device.
โ๏ธ Functions
main
Loads the host URL from the config file.setRed
Sets the color to red (R:255, G:0, B:0).setBlue
Sets the color to blue (R:0, G:0, B:255).setGreen
Sets the color to green (R:0, G:255, B:0).setCustom
Applies a user-defined color and effect using direct RGB values and effect IDs. Accepts:fx,sx,a,r,g,b,ixsetCustomHEX
Same assetCustom, but color is passed as a HEX value (#rrggbb).setRGB
Sets a static RGB color (no effect/animation). Accepts:r,g,b.setHEX
Same assetRGB, but using a HEX color string.setCustomTemp
Temporarily activates an effect and color, then restores the previous WLED state after a given time. Accepts same values assetCustom+time(in ms).
๐ฌ Example Commands
๐ด Switch to red
Key | Value |
|---|---|
function | setRed |
๐ Set custom RGB effect
Key | Value |
|---|---|
function | setCustom |
fx | 1 |
sx | 200 |
a | 255 |
r | 255 |
g | 100 |
b | 50 |
ix | 128 |
๐จ Use HEX color with effect
Key | Value |
|---|---|
function | setCustomHEX |
fx | 3 |
hex | #00ffff |
โ ๏ธ Temporary alert effect (5 seconds)
Key | Value |
|---|---|
function | setCustomTemp |
fx | 60 |
r | 255 |
g | 0 |
b | 0 |
a | 255 |
time | 5000 |
๐ก Set static color with HEX
Key | Value |
|---|---|
function | setHEX |
hex | #ff66cc |
๐ฏ Set static color with RGB
Key | Value |
|---|---|
function | setRGB |
r | 120 |
g | 20 |
b | 240 |
๐งช This mod supports real-time LED feedback and custom lighting animations โ all configurable from your event system, overlay triggers, or chat commands.
What's New in Version 1.0.1
Released
Updated to new aiostool version