Integration

Razer Chroma

Control Razer Chroma RGB lighting across your keyboard, mouse, mousepad, headset, and other Chroma-enabled devices directly from stream events.

Overview

FaustBot integrates with Razer Chroma SDK for synchronized RGB lighting effects:

Static Colors

Set solid colors on all or specific devices.

Wave Effects

Animated waves across your peripherals.

Breathing

Pulse between two colors smoothly.

Reactive

Respond to keyboard input with colors.

Spectrum

Rainbow cycling across all devices.

Per-Device

Control keyboard, mouse, pad separately.

Setup

1

Install Razer Synapse

Download and install Razer Synapse 3. Make sure Chroma Connect is enabled in Synapse settings.

2

Enable Chroma SDK

In Synapse, go to Modules and ensure Chroma Connect is installed. This enables third-party apps like FaustBot to control lighting.

3

Connect in FaustBot

Go to Integrations → Razer Chroma and click Connect. FaustBot will register with the Chroma SDK.

Chroma Apps Priority

In Synapse's Chroma Connect settings, you can set app priority. Make sure FaustBot has higher priority than games if you want stream alerts to override game lighting.

Effects

Color 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

Turn off all lighting.

Animated Effects

Wave

Left or right wave animation.

Breathing

Pulse between two colors.

Reactive

React to key presses.

Spectrum

Rainbow color cycling.

Scripting API

Control Razer Chroma from your scripts:

Static Colors

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

# Set specific device type
CPH.RazerChromaSetKeyboardColor(0, 255, 0)  # Green keyboard
CPH.RazerChromaSetMouseColor(255, 0, 0)  # Red mouse
CPH.RazerChromaSetMousepadColor(0, 0, 255)  # Blue mousepad
CPH.RazerChromaSetHeadsetColor(255, 255, 0)  # Yellow headset

# Clear all effects (turn off)
CPH.RazerChromaClear()

Animated Effects

# Breathing effect (pulsing between colors)
CPH.RazerChromaBreathing(255, 0, 0, 0, 0, 255)  # Red to Blue

# Wave effect
CPH.RazerChromaWave("left")  # left, right
CPH.RazerChromaWave("right")

# Reactive effect (responds to key presses)
CPH.RazerChromaReactive(255, 255, 0, "medium")  # short, medium, long

# Spectrum cycling (rainbow)
CPH.RazerChromaSpectrumCycling()

Stream Event Examples

# Flash on new follower
def Execute():
    # Flash red 3 times
    for i in range(3):
        CPH.RazerChromaSetColor(255, 0, 0)
        CPH.Wait(200)
        CPH.RazerChromaClear()
        CPH.Wait(200)
    # Return to normal
    CPH.RazerChromaSpectrumCycling()
    return True

# Subscriber alert - wave effect
def Execute():
    tier = args.get("tier", 1)
    if tier == 3:
        CPH.RazerChromaSetColor(255, 215, 0)  # Gold for T3
    elif tier == 2:
        CPH.RazerChromaSetColor(192, 192, 192)  # Silver for T2
    else:
        CPH.RazerChromaWave("right")
    return True

See the full API reference for all available Razer Chroma methods.