Media Commands

Media commands are chat-triggered sound and video clips. A viewer types !trigger, the configured audio file plays through your alert overlay, and — for video clips — the clip also appears in the same Browser Source. They are typically used for sound effects, short meme reactions, and stinger videos (the brief clips streamers play between scenes).

You manage media commands on the Media Commands page (/media-commands). The clips themselves are picked from your Media Library, so files must be uploaded there before they can be assigned to a command.

How they differ from regular commands

	Custom command	Counter	Media command
Response	Chat text	Chat text with `{count}`	Plays a sound or video in the overlay
Storage	None	One count value	References a media library file
Visible in chat	The bot replies in chat	The bot replies in chat	The bot does not reply in chat
Where viewers see it	Chat	Chat	OBS browser source (alert overlay)

Because the output goes to the overlay rather than chat, the alert overlay Browser Source must be set up in OBS for the clip to be heard or seen. See the Alerts page for the Browser Source setup.

Creating a media command

Click New command on /media-commands and fill in:

Field	Description
Trigger	Starts with `!`, lowercase, letters/digits/underscore/hyphen, max 32 chars. Example: `!airhorn`.
Aliases	Comma-separated list of additional triggers, up to 10.
Kind	Sound only — plays an audio file. Video — plays a video clip in the overlay area.
File	Picks an asset from the Media Library. The picker filters to the formats supported by the selected kind: MP3/OGG for sound, MP4/WebM for video.
Volume	0 – 100 %, default 80 %.
Video duration cap	Video only. Optional cap, 250 – 60 000 milliseconds. Stops a long clip after the configured time.
Skip if busy	If on, streamion.bot skips this command whenever another overlay event is already playing. If off, the command waits in line behind any currently playing alert or media event.
Global cooldown	0 – 86 400 seconds, default 30 s.
Per-viewer cooldown	0 – 86 400 seconds, default 120 s.
Minimum role	Same six-tier scale as commands (Everyone / Follower / Subscriber / VIP / Moderator / Broadcaster).
Enabled	If off, the trigger is reserved but the command does nothing.

Where video clips appear

Video media commands all render at one shared position in your overlay, set on the Media Commands page with a drag-to-position preview. Sound-only commands have no on-screen element, so this doesn't apply to them. You can set:

Horizontal / vertical position — where the clip sits in the frame.
Video width — the clip's size, in pixels.

Editing and deleting

Each row on the page has actions for edit, toggle on/off, and delete. Deleting a media command is permanent. The underlying media file in the library is not affected — only the trigger mapping is removed.

Who can trigger a command?