Triggers

Triggers let you automate actions based on stream events. When X happens, do Y. No code required — build your automation rules from the dashboard.

How Triggers Work

A trigger has three parts:

1. Event — what causes the trigger to fire (a chat message, a follow, a sub, etc.)
2. Conditions — optional filters that must be true for the trigger to proceed
3. Actions — what happens when the trigger fires

For example: When a viewer raids with 50 or more viewers → play the raid sound → show a raid GIF → post a thank-you message to chat.

Trigger Events

Chat Events

• Message sent (matches keyword or command)
• TTS message queued
• User uses a specific command

Stream Events

• New follower
• New subscription
• Resub
• Gift sub (single or bulk)
• Raid received
• Donation / tip received
• Superchat (YouTube)
• Gift (TikTok)

Manual / Scheduled

• Dashboard button click (manually fire a trigger)
• Timer (fires every N minutes during a stream)

Conditions

Conditions let you filter when a trigger fires:

• Amount threshold — e.g., raid with 50+ viewers, donation over $5
• Message contains — text or regex match in the chat message
• Username matches — target a specific user or pattern
• Platform — only fire for events from a specific platform
• Time of day — restrict to certain hours

You can combine multiple conditions with AND / OR logic.

Actions

When a trigger fires, it can execute one or more actions:

Action	Description
Play media	Play a sound, image, or video from your media library.
Send chat message	Post text to chat. Supports {username}, {amount}, {message} placeholders.
Run TTS	Force a TTS message (bypasses the queue or joins it).
Fire alert	Show an alert on the overlay.
Switch Compositor preset	Change your overlay layout.
Toggle widget	Show or hide a specific widget.
HTTP request	Call a webhook URL (POST with event data).

Actions in a single trigger run in sequence. You can add delays between actions (e.g., wait 2 seconds, then send the chat message).

Creating a Trigger

1. Open Triggers in the dashboard sidebar.
2. Click New Trigger.
3. Give it a name.
4. Pick the Event type.
5. Add Conditions if needed.
6. Add one or more Actions.
7. Save.

Triggers are active immediately. Use the Test button to fire the trigger manually and verify the actions work as expected.

Trigger Order

When multiple triggers match the same event, they all fire. If order matters (e.g., you want a sound to play before a chat message), use delays within a single trigger's action chain rather than separate triggers.