Integration

Corsair iCUE

Control Corsair iCUE RGB peripherals from FaustBot. Set colors on your keyboard, mouse, mousepad, headset, and other iCUE-enabled devices.

Overview

FaustBot integrates with Corsair iCUE SDK for RGB lighting control:

Static Colors

Set solid colors on all devices.

Per-Device Control

Target specific peripherals.

Stream Alerts

React to follows, subs, and donations.

Easy Setup

Works with existing iCUE installation.

Setup

1

Install iCUE

Download and install Corsair iCUE. Make sure your peripherals are detected and working.

2

Enable SDK

In iCUE settings, go to Software and Games and enable Enable SDK. This allows third-party apps to control lighting.

3

Connect FaustBot

Go to Integrations → Corsair iCUE in FaustBot and click Connect.

SDK Priority

When FaustBot takes control, it overrides iCUE profiles. Effects will return to your normal profile after FaustBot releases control.

Effects

Set Color

Static color on all devices.

Set Keyboard

Color for keyboard only.

Set Mouse

Color for mouse only.

Set Mousepad

Color for mousepad only.

Set Headset

Color for headset only.

Clear

Release SDK control.

Scripting API

Control Corsair peripherals from your scripts:

Color Control

# Set all devices to a color
CPH.IcueSetColor(255, 0, 128)  # Pink

# Set specific device type
CPH.IcueSetKeyboardColor(0, 255, 0)  # Green
CPH.IcueSetMouseColor(255, 0, 0)  # Red
CPH.IcueSetMousepadColor(0, 0, 255)  # Blue
CPH.IcueSetHeadsetColor(255, 255, 0)  # Yellow

# Clear all effects
CPH.IcueClear()

Stream Event Examples

# Flash effect on new follower
def Execute():
    for i in range(3):
        CPH.IcueSetColor(255, 0, 0)  # Red
        CPH.Wait(200)
        CPH.IcueClear()
        CPH.Wait(200)
    return True

# Set color based on donation amount
def Execute():
    amount = float(args.get("amount", 0))
    if amount >= 100:
        CPH.IcueSetColor(255, 215, 0)  # Gold
    elif amount >= 50:
        CPH.IcueSetColor(192, 192, 192)  # Silver
    else:
        CPH.IcueSetColor(205, 127, 50)  # Bronze
    return True

See the full API reference for all available iCUE methods.