WLED-Mod

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

🌈 Set custom RGB effect

🎨 Use HEX color with effect

⚠️ Temporary alert effect (5 seconds)

💡 Set static color with HEX

🎯 Set static color with RGB

🧪 This mod supports real-time LED feedback and custom lighting animations – all configurable from your event system, overlay triggers, or chat commands.

View File