Automations
Automations allow your canvas elements to listen to live stream events and automatically execute actions—such as playing an entrance animation, displaying custom message templates, or starting a timer sequence—without any manual chat command entry.
1. Supported Events
Our integrations listen directly to the live websocket logs of Kick, Twitch, and YouTube:
- New Follow
- New Subscriber
- Raid (with viewer counts)
- Sub Gift (with quantities)
- Follow
- Subscription / Re-sub
- Gifted Sub
- Cheer (Bits amount)
- Channel Point Redeem
- New Subscriber
- Super Chat / Super Sticker
- Channel Membership
2. Configuring a Trigger Hook
To configure an element (like a Lower Third nameplate) to trigger automatically upon receiving an event:
- Select the layer you wish to animate (e.g., your alert wrapper container).
- In the Right Sidebar Inspector, expand the Automations accordion section.
- Click + Add Automation Trigger.
- Choose your target platform event (e.g.,
Kick Follow). - Configure the action properties:
- Target Timeline: Select which custom keyframe timeline track to execute (e.g. `entrance_anim`).
- Duration (ms): How long the element stays visible before running its exit animation (Default: `5000` ms).
- Cooldown (ms): Prevent overlapping trigger spams (e.g., ignore identical inputs for `2000` ms).
3. Text Variable Bindings
When an automation trigger fires, Scraplet populates special data bindings. You can use these variables inside your text element inputs to display live viewer details dynamically:
| Variable | What it parses | Output Example |
|---|---|---|
{actor} | The name of the user triggering the event | Sardwyn |
{viewers} | The viewer size (only during incoming stream Raids) | 127 |
{amount} | Gifted sub amounts, bit values, or super chat tip values | 500 |
4. Simulating Event Alerts
You don't need to wait for a live follow or donation to test your creations. Use the built-in **Emulation Controls**:
At the top row of your Overlay Editor header, click Simulate Event to open the testing dialog. Select any event (e.g. Follow, Sub, Raid), configure mock usernames or values, and click Trigger Mock Alert. Your canvas elements and timelines will instantly execute locally as if receiving live, production-grade websocket packets.