Integration

WLED

Control WLED LED strips and presets from FaustBot.

Overview

The WLED integration adds dedicated triggers and actions so you can build workflows around events, device state, or external updates.

Event Triggers

React to inbound events and status updates.

Action Effects

Send commands and automate responses.

Automation Hooks

Combine triggers with other plugins and scripts.

Setup

1

Enable the Plugin

Open FaustBot settings and enable the WLED integration.

2

Connect Your Account or Device

Provide any required credentials or connection details.

3

Verify the Connection

Trigger a test action to confirm the integration is responding.

Connection Tips

Keep the service running and verify network permissions if the connection fails.

Triggers

  • Connection status changes (connected, disconnected, error).
  • Incoming events or webhook notifications.
  • State changes reported by the service or device.

Effects

  • Send commands or updates to WLED.
  • Change device settings or activate presets.
  • Sync data into variables for other actions.

Scripting API

Use the CPH API to control WLED directly from scripts:

Power Control

Power control 
# Turn on WLED device
CPH.WledSetPower("Desk Strip", True)

# Turn off device
CPH.WledSetPower("Desk Strip", False)

# Toggle power state
CPH.WledTogglePower("Desk Strip")

Color & Brightness

Color and brightness 
# Set color (RGB values 0-255)
CPH.WledSetColor("Desk Strip", 255, 100, 0)

# Set brightness (0-255)
CPH.WledSetBrightness("Desk Strip", 200)

# Set color with hex value
CPH.WledSetColorHex("Desk Strip", "#FF6400")

Effects & Presets

Effects and presets 
# Set effect by ID
CPH.WledSetEffect("Desk Strip", 38)  # Rainbow

# Set effect by name
CPH.WledSetEffectByName("Desk Strip", "Fire 2012")

# Load a preset
CPH.WledSetPreset("Desk Strip", 1)

# Set effect speed (0-255)
CPH.WledSetSpeed("Desk Strip", 128)

See the full API reference for all available WLED methods.