Back to Guides

OBS replay setup

Add each player’s RollSight replay to OBS with a private browser source.

Each player needs their own private replay link.

Get your replay link

  1. Open the setup page, enter your RollSight license key, and choose Get link.
  2. Copy this link and send it to the person running OBS. They can view your replays without your license key.
  3. Keep replay uploads enabled in the RollSight desktop app.
Set up OBS replays

If replay uploads are already enabled, no desktop app update is needed.

Add it to OBS

  1. In OBS, add a Browser Source for each player and paste that player’s private URL.
  2. Place the browser source above that player’s camera in your scene. It stays transparent between replays and shows each new replay once.
  3. Before play, load each browser source and make a new roll to check that the replay appears once.

This overlay shows replay clips only. The player’s camera stays in its own source.

If a replay does not appear

Check that replay uploads are enabled, the browser source was loaded before the roll, and the player shared the current link.

If a player replaces a link, paste the new link into their OBS browser source.

Anyone with this URL can view your future replays. Share it only with people you trust. Replace it if it is exposed.

Automatic OBS scenes on combat turns

Use RollSight Foundry module 1.1.91 or newer and enable OBS Utils in the same world. These controls are separate from replay overlays.

  1. In OBS, create your Foundry Browser Sources using the server address supplied by your GM: /game for the play view and /stream for the Stream user. Sign the /stream source into the user you will select as the OBS operator.
  2. For every Foundry Browser Source, open Properties and set Page permissions to Advanced access or Full access. Permissions apply separately to /game and /stream. Refresh each source after changing them. Replay-only links do not need scene-control permissions.
  3. Keep the /stream controller loaded across scene changes. Turn off Shut down source when not visible and reuse the same source in your scenes. With this browser-source connection, OBS Utils WebSocket and API access are not required.
  4. As GM, open Game Settings → RollSight → Configure OBS turn scenes. Select the Stream user as OBS operator, then choose Refresh OBS scenes. Choose each actor and its OBS scene from the dropdowns. Optionally select scenes for unmapped NPC turns and the end of combat.
  5. Choose Save OBS scenes, enable Switch OBS scenes on combat turns, and leave Pause automatic OBS scene switching unchecked. Unmapped player turns leave the current scene unchanged.

Mappings, the operator, and enabled/paused settings stay saved in this Foundry world. Stream may connect after the server starts. Once connected, it checks the current combat turn. The source must stay connected while automatic switching is needed.

Before streaming, advance a test combat turn and check the scene, then test pause and resume. If scenes are missing, check permissions on the /stream source, refresh its browser cache, and refresh the scene list. After renaming OBS scenes, select the new names and save again.

OBS Studio setup guide