Integration

Elgato

Connect FaustBot to Elgato's creator ecosystem. Use hardware buttons, audio mixers, lights, and camera tools to drive automations directly from your setup.

Overview

Elgato devices are common in streaming rigs. FaustBot ships dedicated integrations for Elgato apps, letting you control scenes, sounds, lighting, and on-stream actions without leaving your workflow.

Hardware Control

Map Stream Deck buttons to triggers, hotkeys, and automation flows.

Audio Automation

Drive Wave Link mixer settings from actions and triggers.

Camera Effects

Apply Camera Hub filters and adjustments on cue.

Lighting Control

Control Key Light brightness, temperature, and color (Light Strip).

Supported Apps

Each Elgato integration ships as its own plugin with a dedicated setup guide. Choose the product you use and follow its walkthrough.

Stream Deck

Trigger actions from hardware buttons, update labels, and control profiles.

View guide
Wave Link

Adjust mixer channels, mute inputs, and automate audio routing.

View guide
Camera Hub

Toggle camera effects, apply LUTs, and manage device settings.

View guide
Key Light

Control Key Light and Light Strip brightness, color temperature, and power.

View guide

Setup

1

Install the Elgato App

Make sure Stream Deck, Wave Link, Camera Hub, or Control Center is installed and running on the same machine as FaustBot.

2

Enable the Integration

Open FaustBot settings and turn on the matching plugin. Each integration has its own configuration page and connection status.

3

Test a Trigger

Use a quick action (like toggling a button label or adjusting light brightness) to confirm the connection before building larger workflows.

Tip

If you use multiple Elgato apps, configure them one at a time so you can verify each connection before moving to the next.

Elgato Key Light

The Elgato Key Light integration provides direct control over your Key Light, Key Light Air, Key Light Mini, and Light Strip devices via their local HTTP API.

Power Control

Turn lights on, off, or toggle their power state.

Brightness

Set brightness from 0-100% with smooth transitions.

Color Temperature

Adjust from warm (2900K) to cool (7000K) white.

RGB Color

Set any color on Light Strip devices.

Triggers

Respond to Elgato Key Light events in your automations:

Connected Fires when Elgato Light connects
Disconnected Fires when Elgato Light disconnects
Power Changed Fires when power state changes
Brightness Changed Fires when brightness level changes
Temperature Changed Fires when color temperature changes

Effects

Use these action effects to control your Elgato Key Light:

Power Control

Turn On

Turn the light on.

Turn Off

Turn the light off.

Toggle Power

Toggle power state.

Brightness Control

Set Brightness

Set brightness (0-100%).

Increase Brightness

Increase by amount.

Decrease Brightness

Decrease by amount.

Color Control

Set Color Temperature

Set temperature (2900-7000K).

Make Warmer

Decrease color temperature.

Make Cooler

Increase color temperature.

Set Color

Set RGB color (Light Strip).

Advanced

Set State

Set multiple properties at once.

Scripting API

Control Elgato Key Light from your scripts using the CPH API:

Power Control

Power control 
# Turn on the Elgato Light
CPH.ElgatoLightTurnOn()

# Turn off the Elgato Light
CPH.ElgatoLightTurnOff()

# Toggle power state
CPH.ElgatoLightToggle()

# Check connection status
if CPH.ElgatoLightIsConnected():
    print("Light is connected")

Brightness Control

Brightness control 
# Set brightness to 75%
CPH.ElgatoLightSetBrightness(75)

# Get current brightness
brightness = CPH.ElgatoLightGetBrightness()

# Increase brightness by 10%
CPH.ElgatoLightIncreaseBrightness(10)

# Decrease brightness by 10%
CPH.ElgatoLightDecreaseBrightness(10)

Color Temperature

Color temperature control 
# Set color temperature to 4500K (neutral white)
CPH.ElgatoLightSetColorTemperature(4500)

# Get current color temperature
temp = CPH.ElgatoLightGetColorTemperature()

# Make light warmer (lower Kelvin)
CPH.ElgatoLightMakeWarmer(500)

# Make light cooler (higher Kelvin)
CPH.ElgatoLightMakeCooler(500)

Color Control (Light Strip)

Color control for Light Strip 
# Set color using RGB values (Light Strip only)
CPH.ElgatoLightSetColorRGB(255, 0, 128)  # Pink

# Set color using hex string
CPH.ElgatoLightSetColorHex("#FF5500")  # Orange

# Set color using HSB values
CPH.ElgatoLightSetColorHSB(240, 100, 75)  # Blue

# Set multiple properties at once
CPH.ElgatoLightSetState(on=True, brightness=80, kelvin=5000)

Other Elgato APIs

Each Elgato integration has its own scripting methods. See the dedicated guides for complete API references:

See the full API reference for all available Elgato methods.