WLED-Mod
🔍 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 URL
aiostool 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 as setCustom, but color is passed as a HEX value (#rrggbb).
setRGB
Sets a static RGB color (no effect/animation). Accepts: r, g, b.
setHEX
Same as setRGB, 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 as setCustom + 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.
File Information
Submitter
BlackRider
Submitted 04/14/2025
Category Mods
View File
By
BlackRider · Posted