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 the Pro overlay-editor entitlement. A scene you've already built keeps rendering in OBS even if Pro lapses — only further editing is locked. Viewing the page also needs the overlays.manage permission (Owner and Admin by default; Moderators if you grant it on the Team page).

You'll find it under Tools → 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), or WebM 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, or WebM) placed and resized like any widget — a frame, mascot, or animated graphic. Pick how it fits its box (contain, cover, or stretch).
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.

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.