Add a browser source to a scene
Put a third-party alert box, video, chat or local browser source in a Bearsong scene and keep the same scene link in OBS.
Live and chatLast updated
Add a Web page layer when a provider gives you a browser source URL. Place it alongside your other widgets in Overlay studio. If OBS already uses this scene’s link, the new layer appears there when your changes save.
Add a web page#
- Open Overlay studio and choose your scene.
- In Layers, open Add to scene, then choose Web page. On a phone, choose Add web page next to Layers.
- Paste the widget or embed URL. The check tells you if the site permits embedding and when you need to check in OBS.
- Give the layer a title if you like, choose a starting size, then choose Add web page. You can move and resize it on the canvas in the desktop editor.
- Select the layer and choose Preview on canvas to load it and interact with it. Test the actual alert, chat or video in OBS before going live. The scene holds up to five web pages.
Edit web page replaces the URL or changes when the page reloads. Reload now reloads the layer in OBS. A hidden layer stops and starts again when you show it. The workspace owner can reveal the saved URL. Anyone who has the scene link can access the web page URLs in it. Keep those links private. If you shared a scene link with someone who should no longer have access, use Replace link under Add to OBS, then update the link in OBS.
Import browser sources from OBS#
- In OBS Studio, choose Scene Collection > Export to save the current collection as a JSON file.
- In desktop Studio, open your destination scene. Match its canvas size to the OBS base canvas, then open Add to scene > Import from OBS or Bearsong and choose the file.
- Select the OBS scene and browser sources to add. Review their hosts, pixel positions, dimensions and visibility, confirm who can access the URLs through the scene link, and choose Import browser sources.
- Wait for Studio to save. Check the layers in OBS using your Bearsong scene link.
The file is read in your browser. Bearsong saves the URLs of the sources you select and puts the layers above the existing layers in their original relative order. It preserves the pixel position, scaled box size and visibility of supported sources. A scaled page may reflow because it renders at the imported box size. For browser sources, Studio skips groups, nested scenes, local web pages, cropped or rotated layers, fitted bounds and sources with filters or blending. OBS-specific options such as source CSS, locks and custom refresh settings are left behind.
Match local WebM videos from OBS#
OBS collection files include a reference to a local Media Source, so keep the original WebM files from your pack nearby. In Add to scene > Import from OBS or Bearsong, choose the collection JSON and an OBS scene. Select the WebM layers you want, then choose the matching file for each. Studio shows the filename from OBS and calculates the layer size from the file you choose. Use the original file for the same proportions and placement.
After you confirm scene link access, Studio uploads the selected files and imports them as Video layers. It carries over the position, displayed size, relative order, visibility, looping, mute and volume up to 100%. The maximum is 4.4 MB per VP8 or VP9 WebM. Cropped, rotated, flipped or filtered layers, playback speeds other than 100%, and nested scenes need manual setup. Bearsong starts the video when the layer is shown and holds the last frame when a play-once video finishes.
Check your scene in OBS#
With the scene open in OBS, go to Add to OBS in Studio and choose Check my scene in OBS. On a phone, the button is below the scene link. Run the check off stream since viewers could see and hear it.
- Look for the Bearsong scene check card on the OBS preview.
- Listen for the short tone and look for activity on the scene’s Audio Mixer channel. If the cue appears without a mixer signal, check Control audio via OBS in the Browser Source properties, then try again.
- Trigger a test alert from your provider’s dashboard to verify that provider’s animation and sound.
The check uses the existing scene link and disappears on its own.
Find the right link#
| Provider | Where to get the link |
|---|---|
| StreamElements | Copy the overlay URL from the StreamElements overlay editor. A sample URL without a valid overlay token can go blank because the resulting page blocks embedding. With your own overlay URL, send a test alert and check the animation and sound in OBS. |
| Streamlabs | Copy the Widget URL from Alert Box in the Streamlabs dashboard. An invalid link can display an error inside the layer. Use the dashboard’s test button to check that your alert animates and plays sound in OBS. |
| Kick | Open the channel’s pop-out chat and copy its address. |
| YouTube | Choose Share, then Embed, and copy the URL from the src field. Some videos block embedding. |
| Twitch | Use a player or clip embed URL. For chat, use Bearsong’s Chat box or keep the pop-out as a separate OBS source. |
| VDO.Ninja | Paste the view link (?view=…) and keep the sender connected. Tested in OBS Studio 33.0.1 with a live VDO.Ninja test video and tone through the scene’s shared mixer. |
| Local tools | Use the widget’s address on localhost or 127.0.0.1 and open the scene in OBS on the computer running that widget. Local HTTP was verified in OBS 33.0.1 for macOS. If your OBS version cannot load it, use a separate Browser Source. |
StreamElements and Streamlabs alert delivery depends on your account’s widget URL. Test an alert before going live.
Copy the URL of the widget itself. Dashboard URLs may require a sign-in or refuse embedding. Some providers block frames entirely, including Nightbot and YouTube live chat. Keep those as separate OBS browser sources. If a site redirects to another host, use the provider’s final widget URL when available. A successful check covers the page’s response headers. The provider may still require a valid token, connected sender or supported media format.
Set up audio and page permissions in OBS#
In the scene’s Browser Source properties, switch on Control audio via OBS to bring the scene into the OBS mixer. The mixer treats the web pages in the scene as one source. If you need a different mixer channel for one provider, give it its own Browser Source in OBS.
Set Page permissions to No access to OBS or Read access to OBS status in the scene’s Browser Source properties. Web page layers pause when the source has permission to read scene names or control OBS.
The layer’s position, size, opacity and custom CSS apply to its outer box. Changes to the page’s own fonts, backgrounds and layout belong in the provider’s editor. Pages that depend on third-party cookies or an account sign-in may work better as separate Browser Sources in OBS.