Jump to content

1 Screenshot

๐Ÿ” 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.

What's New in Version 1.0.1

See changelog

Released

Updated to new aiostool version