OBS Set Media Source
Runs on: Backend — controls OBS via the backend's OBS WebSocket bridge.
The OBS Set Media Source effect changes a property on a media (FFmpeg) source in your OBS scene collection. Select the source from the Source dropdown, choose the property to modify, and wire in the new value. Supported properties include the file path to the media file, whether to loop playback, whether to restart when the source becomes active, whether to close the file when inactive, and the playback speed percentage.
Use this node to swap the video or audio file a media source is playing, or to adjust its playback behavior dynamically from a flow.
Inputs
| Name | Type | Description |
|---|---|---|
sourceName | string | The name of the media source to update. Overrides the dropdown when connected. |
value | varies | The new value. A file path string for File Path; boolean for loop/restart/close toggles; number for speed. |
Configuration
- Source: Dropdown listing all media sources in OBS. Used when
Source Nameis not wired. - Property: Which property to update — File Path (
string), Loop Playback (boolean), Restart When Active (boolean), Close When Inactive (boolean), Speed Percent (number).
Example
A channel point redeem allows viewers to pick a background music track. The flow maps the redeem input to a file path and feeds it into OBS Set Media Source targeting your "Background Music" media source, swapping the audio track live mid-stream.