๐ 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
,ix
setCustomHEX
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 |
---|---|
script | wledMod |
function | setRed |
๐ Set custom RGB effect
Key | Value |
---|---|
script | wledMod |
function | setCustom |
fx | 1 |
sx | 200 |
a | 255 |
r | 255 |
g | 100 |
b | 50 |
ix | 128 |
๐จ Use HEX color with effect
Key | Value |
---|---|
script | wledMod |
function | setCustomHEX |
fx | 3 |
hex | #00ffff |
โ ๏ธ Temporary alert effect (5 seconds)
Key | Value |
---|---|
script | wledMod |
function | setCustomTemp |
fx | 60 |
r | 255 |
g | 0 |
b | 0 |
a | 255 |
time | 5000 |
๐ก Set static color with HEX
Key | Value |
---|---|
script | wledMod |
function | setHEX |
hex | #ff66cc |
๐ฏ Set static color with RGB
Key | Value |
---|---|
script | wledMod |
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
See changelogReleased
Updated to new aiostool version