Docs navigation
Video Player
The Video Player element lets you upload and stream pre-recorded MP4 files as if they were live. Use it for scheduled broadcasts, reruns, BRB screens, or as automatic fallback content when your primary stream disconnects. Once playing, the video feeds into downstream elements like Switch, overlays, and Noise Cancellation.
Playback controls
Select a video file to enable the playback buttons. These can also be triggered via the REST API.
Play
Start playing. If paused, resumes from the current position. If stopped, starts from the beginning.
Restart
Return to the beginning and start playing from the start.
Stop
Stop playback. Use Play to resume.
Settings
Select the MP4 file to play. Upload files via File Manager.
Start playback as soon as the configuration starts. Useful for "Stream Starting Soon" videos.
Restart from the beginning when the video ends, instead of showing a black screen.
Controls how the Video Player behaves when used inside a Switch or Failover element.
- Automatic play and pause: starts when the Switch/Failover activates it, pauses when deactivated. Subsequent plays resume from the paused position.
- Restart automatically: starts from the beginning each time it becomes active.
- No automatic behavior: playback does not start or stop automatically.
Show a black screen instead of the last video frame when playback has not started or has stopped.
Specify whether the video is horizontal or vertical.
Play a video when the stream disconnects
Connect a Video Player to the backup input of a Failover element to automatically play a pre-recorded video when the primary stream fails. Keeps your audience informed and engaged instead of seeing a frozen frame or black screen.
For best results, set Loop video to yes and Switch/Failover behavior to Automatic play and pause or Restart automatically.
Overview video
Related
Failover
Automatically switch to the Video Player when the primary stream drops.
Switch
Use Video Player as one of the Switch inputs for BRB screens.
Upload and Stream
Guide to streaming pre-recorded video files as live content.
All elements
Overview of every element available in a Streamrun configuration.
Join Streamrun Discord