Roadie

How OBS connectors keep Stage views and alerts in sync

Connectors · 4 min read ·

Choose an OBS connector, map scenes to Stage views, and let your bot queue give Roadie clips their turn alongside alerts.

An OBS connector tells Roadie which OBS scene is active. Roadie selects the Stage view you mapped to that scene. If you use Firebot or Streamer.bot, its queue can also decide when a Roadie clip plays alongside your bot's alerts.

The bot is the arbiter of playback order. Roadie puts a requested clip into the queue you chose, waits for the bot to say it is the clip's turn, and forwards playback to the Stage. When the clip finishes, Roadie tells the bot so the queue can continue.

Diagram: OBS sends scene changes through a connector to Roadie, which selects a Stage view. Roadie clip requests join the Firebot or Streamer.bot alert queue; the bot grants the clip its turn before Roadie plays it on Stage. OBS Signal has scene sync but no bot queue.
How scene changes and clip requests travel between OBS, your bot, Roadie and the Stage.

Which connector should I use?

ConnectorFollows OBS scenesCoordinates Roadie clips with bot alerts
FirebotThrough Firebot's OBS connectionYes, when you choose a Firebot effect queue for Roadie clips
Streamer.botThrough Streamer.bot's OBS connectionYes, when its Roadie Play Clip action uses a blocking alert queue
OBS SignalDirectly from OBSNo. OBS Signal has no bot queue

OBS Signal is enough if you only want scene changes to select Stage views. Firebot or Streamer.bot adds queue coordination when you also want Roadie clips to wait behind alerts. Roadie receives events such as ad breaks through its own integrations; the bot controls the order of items placed in its queue.

The Roadie Connectors page. Cards for Firebot and Streamer.bot each show the connector version, a Download button, whether it is online, and three setup steps. An OBS card sits below them.
Connectors lists each connector, its status and how to set it up.

Map scenes to Stage views

  1. Open Connectors and confirm your OBS connector is online.
  2. Open Stage, then open the view dropdown. Hover or focus a view to inspect its scene mappings; click its name to select it in the editor.
  3. Filter the scene list and select the scenes that should activate that view. A scene can belong to only one view in each Stage. Desktop and Mobile have independent mappings.
  4. Save your changes and switch scenes in OBS to check the result.
The Roadie Stage editor with the view dropdown open. On the left, the Desktop views list holds a view called Default and a New view button. On the right, the OBS scenes panel for Default has a Show this view live button and a note that an OBS connector can switch views for you.
The view dropdown: pick a view on the left, map its OBS scenes on the right.

Duplicating a view copies its layers and settings, but not its scene mappings. If your connector goes offline, saved mappings remain, and you can still select views manually. Scene changes resume synchronizing when it reconnects.

If you are using the Stage trial, the mapped view follows the active scene in trial output. Your current installed Stage stays authoritative until you enable and verify adoption.

Put Roadie clips in your alert queue

Choose a queue in Firebot or configure the Roadie Play Clip action in a blocking Streamer.bot queue. Use the queue that also handles the alerts you want Roadie clips to wait for. When a clip reaches the front, the bot signals Roadie to play it. Roadie reports when playback is complete, and the bot moves to the next queued item.

This prevents overlap among items in that queue while the connector is online. Alerts outside the queue can still overlap. A Firebot Interval queue can advance before a clip ends if its interval is too short; choose a mode that waits for the clip. If clip sharing is off or the connector is offline, Roadie's own clip queue may keep playing without bot coordination. Enable clip sharing in only one bot at a time.