everything's up and runningsee status
// STREAMION.BOT DOCS

All about streamion.bot.

Sign-in flow, chat commands, event responses, alerts, music integrations — the full reference for your bot configuration.

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).

Media commands are managed on the Media Commands page (/media-commands) and require the media-commands.manage permission, which is granted to the Owner, every Admin, and every Moderator by default. 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 commandCounterMedia command
ResponseChat textChat text with {count}Plays a sound or video in the overlay
StorageNoneOne count valueReferences a media library file
Visible in chatThe bot replies in chatThe bot replies in chatThe bot does not reply in chat
Where viewers see itChatChatOBS 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:

FieldDescription
TriggerStarts with !, lowercase, letters/digits/underscore/hyphen, max 32 chars. Example: !airhorn.
AliasesComma-separated list of additional triggers, up to 10.
KindSound only — plays an audio file. Video — plays a video clip in the overlay area.
FilePicks 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.
Volume0 – 100 %, default 80 %.
Video duration capVideo only. Optional cap, 250 – 60 000 milliseconds. Stops a long clip after the configured time.
Skip if busyIf 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 cooldown0 – 86 400 seconds, default 30 s.
Per-viewer cooldown0 – 86 400 seconds, default 120 s.
Minimum roleSame six-tier scale as commands (Everyone / Follower / Subscriber / VIP / Moderator / Broadcaster).
EnabledIf off, the trigger is reserved but the command does nothing.

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.

Permission concepts

Two different permission mechanisms apply:

  • media-commands.manage controls which workspace members can view and edit the Media Commands page.
  • Minimum role on each individual command controls which Twitch chatters can trigger it in your chat.

These are independent of each other, as they are for Counters.