Integration

Corsair

Connect Corsair devices for lighting and peripheral automation.

Overview

The Corsair 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 Corsair 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 Corsair.
  • Change device settings or activate presets.
  • Sync data into variables for other actions.

Scripting API

Use the CPH API to control Corsair directly from scripts:

Device Control

Device control
# Get connected Corsair devices
devices = CPH.CorsairGetDevices()

# Set device color (RGB values 0-255)
CPH.CorsairSetColor("Keyboard", 255, 0, 128)

# Set all devices to a color
CPH.CorsairSetAllColor(0, 255, 0)

Effects & Profiles

Effects and profiles
# Set lighting effect
CPH.CorsairSetEffect("Keyboard", "Rainbow Wave")

# Load iCUE profile
CPH.CorsairLoadProfile("Gaming Profile")

# Flash a color temporarily
CPH.CorsairFlash("Keyboard", 255, 0, 0, 500)  # Red flash for 500ms

See the full API reference for all available Corsair methods.