Media, text & generated visuals
Browser
Show a web page, widget, or local web file.
Before you start
Open the intended collection and layout. For capture or network inputs, have the device or sender available.
Where to find it
Sources > Add > Browser.
Use it
- Open the scene that will contain the source.
- Choose Add in Sources.
- Select Browser in Create Source.
- Enter a name and choose New.
- Choose Input Mode.
- Enter URL or browse for Local file.
- Set Width and Height.
- Add Custom CSS if needed.
- Review when the page reloads or closes, its permissions, and mixer audio.
- Choose Save and Close (or OK where shown).
- Check the source in Preview before taking it to Program.
Controls and additional tasks
Width and Height are the selected scene item size, from 1 to 8192 pixels. Custom frame rate accepts 1–120 FPS; otherwise the layout frame rate is used. Shutdown when not visible reduces background work. Refresh when scene becomes active reloads content. Refresh cache after save reloads without the current cache. Enable Control browser audio through the mixer to manage supported page audio. Interact sends mouse and keyboard input to the live source.
Control reference
| Control | Use |
|---|---|
| Custom CSS | Optional CSS injected into the browser page. Use this for transparent backgrounds or simple page styling. |
| URL | Load a web URL such as an overlay, widget, or web page. |
| Local file | Load a local HTML, HTM, or SVG file from this computer. |
| URL | Absolute browser URL. Supported schemes: http, https, and file. |
| Local file | Local browser file used by this source. |
| Browse | Choose a local browser file. |
| Width | Selected Browser Source transform width in pixels. |
| Width | Adjust selected Browser Source transform width. Range: 1 to 8192 pixels. Double-click the thumb to reset to the value from when this dialog opened. Minimum: 1; Maximum: 8192. |
| Height | Selected Browser Source transform height in pixels. |
| Height | Adjust selected Browser Source transform height. Range: 1 to 8192 pixels. Double-click the thumb to reset to the value from when this dialog opened. Minimum: 1; Maximum: 8192. |
| Use custom frame rate | Capture this browser source at a custom frame rate instead of the default browser-source rate. |
| FPS | Custom browser capture frame rate from 1 to 120 FPS. |
| Shutdown source when not visible | Close the browser source while it is inactive to reduce background work. |
| Refresh browser when scene becomes active | Reload the page when the scene containing this source becomes active. |
| Control browser audio through the mixer | Route supported browser-page audio into the application's mixer instead of letting browser output directly. |
| Page permissions | Choose what trusted browser pages are allowed to request from the MCast. |
| Refresh cache after save | Clear the current browser page cache after saving and reload the source. |
| Save and Close | Save Browser Source settings. Shortcut: Ctrl+S. |
| Cancel | Close without saving changes. |
Example
Use a browser widget for a countdown or scoreboard.
If something is wrong
If the page is blank, check its URL/input mode and use cache refresh. If page audio bypasses your mix, review the mixer-audio option.
Stop or remove
Hide the source to stop showing its picture. Use its available playback/connection stop control when you need to stop the input itself. Remove the source item from the scene when it is no longer needed. Shared sources can still be used in other scenes.
Keys in this feature
| Key | Action | Type |
|---|---|---|
| Ctrl+S | Save and close | Built-in shortcut |
Additional workflow details
Use the source’s audio-through-mixer option to route supported page sound into Audio Mixer. Grant only the needed permissions to trusted pages. Preview uses a fixed 16:9 canvas; Width/Height control the source transform rather than the preview window shape.
Related pages
Position, crop, order, and bounds · Keyboard shortcuts · Menu reference · Manual contents