Actions¶

An action is one thing CroStream can do: send a chat message, switch an OBS scene, time out a viewer, play a sound, show an overlay alert. A macro is a list of steps, and most steps run one action. The Actions page lists all of them, and lets you try any one on the spot, which is the quickest way to learn what each does before you build a macro around it.

CroStream has close to a hundred actions. This page explains how they're organised and covers the ones that need some setup. The Actions reference lists every action with every setting.

The Actions page¶

Open Actions in the sidebar, under Automate. Actions are grouped by integration (Twitch, OBS Studio, Steam, Discord, Queues, Tools, Viewers, Overlays), then into groups such as Chat, Moderation or Audio. Type in the search box to find one by name, description or group: mute, timeout, poll.

Each row shows the action's name, its ID, what it does, and tags:

Try an action¶

Click a row to open it. You'll see:

• what the action does, and any differences between Windows, macOS and Linux;
• Returns: the variables it reports back, such as {clip_url};
• Try it: the same form a macro step shows. Fill it in and click Run now.

Run now runs the action for real, on the integration named next to the button: it really times out the user, really changes your title. The result appears next to the button (done, or what went wrong) and in Activity under Quick actions. There's no event behind it, so variables such as {user} stay as written.

Providers and shared actions¶

Every action runs on one or more providers, the integrations that can carry it out.

• Most actions belong to one provider: Time out a user is Twitch's, Mute or unmute an OBS audio source is OBS's.
• A few are shared: one job several integrations can do. Clip saves the OBS replay buffer and creates a Twitch clip; Marker adds a Twitch stream marker and an OBS recording chapter. Send chat message and Switch scene are shared actions too, though today only Twitch and OBS run them.

Shared actions appear under each integration that can run them. On the Actions page, Run now runs on that one integration only. In a macro, a step's Providers buttons choose (see Providers).

What's available¶

Channel point rewards¶

Twitch only lets an app change a channel point reward that the same app created. So:

• Use Create reward in CroStream for rewards you want macros to switch on and off, pause or reprice with Update reward. Update reward only offers rewards CroStream created.
• Only CroStream's own rewards can be completed or refunded automatically (Channel point refunds).

Rewards are always picked from your channel's list, never typed. The redemption trigger offers every reward (or Any reward).

Sounds¶

There are two ways to play a sound, and they go to different places.

Both have Wait until it finishes, which holds the next step until the sound ends. To show a sound with an overlay alert instead, see Alerts.

Play a sound¶

Play a sound plays a WAV, MP3, OGG or FLAC file on the computer CroStream runs on.

• Sound file: the full path, such as C:\Sounds\airhorn.mp3.
• Output device: pick one by name. Empty is the system default.
• Volume (1-100): empty is 100.

If the chosen device is gone (an unplugged headset), the sound plays on the system default and the activity feed shows a warning. Up to 4 sounds can play at once without Wait until it finishes; a fifth fails. Stop all sounds ends every sound that's playing.

Play sound in OBS¶

Play sound in OBS points an OBS Media Source at a file and plays it, so the sound goes out on stream. Set it up once:

1. In OBS, add a Media Source in a scene that is always shown (for example, a scene you nest in every other scene), and turn on Close file when inactive.
2. In the step, pick that source as the Media source, and give the Sound file as a full path on the computer that runs OBS.

With Wait until it finishes, the next step starts when OBS reports the sound ended (it gives up after 10 minutes).

Screen flash¶

Flash an image on screen shows an image from your media library over your game for a moment, for example a jump scare, and Clear the screen flash takes it down at once. It has its own guide: Screen flash.

Handy tools¶

Troubleshooting¶

Related¶

• Actions reference: every action, setting and output.
• Macros: putting actions in order, with branches and variables.
• Overlays, Alerts and Viewers: the actions for those features in context.