All systems OKView 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.

Overlay scenes

Overlay scenes let you build your own on-stream overlay from a set of widgets — a now-playing box, a follower goal, a chat feed, a countdown, your own images — arranged on a canvas and loaded into OBS as a single browser source. Each scene is its own browser source, so you can make one per stream layout and switch between them in OBS.

This is separate from the Alert overlays (the follow/sub toast pop-ups), though the two share the same overlay connection — and you can even place your alerts inside a scene with the Alert Box widget (below).

Building scenes is a streamion.bot Pro feature. Creating and editing scenes needs Pro to be active for your channel. A scene you've already built keeps rendering in OBS even if Pro ends — only further editing is locked.

You'll find it under Overlays & Alerts → Overlays (/overlays/scenes).

Building a scene

Click New scene, give it a name, and the editor opens on an empty 1920×1080 canvas. From there:

  • Add widgets from the Add widget palette (see the list below).
  • Move and resize a widget by dragging it on the canvas, and dragging its corners. Geometry is stored as a percentage of the canvas, so a scene looks the same whatever size you give the OBS source.
  • Layer widgets with Bring forward / Send backward.
  • Style the selected widget in the side panel: content scale, font and font size, colours, and the widget's own settings.
  • Scene background (optional) — upload a PNG, WebP (animated is fine), WebM, or MP4 that fills the whole canvas behind the widgets, e.g. your own overlay artwork.

A live preview shows the scene as it'll look in OBS, and an Overlay connected / not connected indicator tells you whether a browser source is currently receiving it.

Widgets

WidgetWhat it shows
Now PlayingThe track currently playing on your Spotify — heading, optional progress bar and album art. (Spotify only; YouTube Music has no now-playing data.)
GoalA progress bar toward a target — Followers today or Subscriptions today — with your own title and bar/track colours.
LabelOne live value: latest follower, subscriber, cheer, raider, or tipper, or followers / subs today. You write the template, with {value} for the live part (e.g. Latest follower: {value}).
TextStatic text you type in — handy for headings or captions next to the dynamic labels.
ChatA live feed of your Twitch chat, with a max-messages cap and an optional emote toggle.
TickerA horizontally scrolling marquee of recent channel events, with a separator and scroll speed you choose.
CountdownCounts down to a time you set (or a number of minutes), then shows your "finished" text.
Image / VideoOne of your own uploaded images or videos (PNG, WebP, WebM, or MP4) placed and resized like any widget — a frame, mascot, or animated graphic. Pick how it fits its box (contain, cover, or stretch). Videos can play their sound, with a volume slider (Play audio).
Alert BoxPlaces your event alerts (follows, subs, raids, …) at a spot in the scene. Their look is still configured on the Alerts page — the Alert Box just positions them.

Now Playing, Goal, Label, Ticker, Countdown, and Chat update in real time while a browser source is connected — a new follow moves the goal, a new message appears in the chat feed, the track changes as you switch songs.

Video with sound: both the scene background and the Image/Video widget can play their audio. For the sound to reach your stream, enable "Control audio via OBS" on the browser source — otherwise it only plays on your PC. The editor preview always stays muted.

Adding a scene in OBS

Each scene's editor shows its Browser source URL with a copy button. In OBS, add a Browser source, paste the URL, and set the size to your stream resolution (e.g. 1920×1080).

Scenes use the same overlay connection as your alert overlays — the token in the URL is your channel's one overlay token. If you regenerate that token (on the Alerts page), every overlay browser source — alert source and scenes — disconnects until you paste the new URLs, so update them all together. Keep these URLs private: anyone with one can receive that overlay.