Elgato Light
Control Elgato Key Light and light panels with FaustBot.
Overview
The Elgato Light 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 Elgato Light 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 Elgato Light.
- Change device settings or activate presets.
- Sync data into variables for other actions.
Scripting API
Use the CPH API to control Elgato Light directly from scripts.
Light Control
Light control
# Turn light on/off
CPH.ElgatoLightSetPower("Key Light", True) # On
CPH.ElgatoLightSetPower("Key Light", False) # Off
# Set brightness (0-100)
CPH.ElgatoLightSetBrightness("Key Light", 75)
# Set color temperature (2900-7000K)
CPH.ElgatoLightSetTemperature("Key Light", 5600)Getting Light State
Get light state
# Get all connected lights
lights = CPH.ElgatoLightGetDevices()
# Get current light state
state = CPH.ElgatoLightGetState("Key Light")
is_on = state["on"]
brightness = state["brightness"]
temperature = state["temperature"]See the full API reference for all available Elgato Light methods.