Docs navigation
Failover
The Failover element keeps your outgoing stream live by monitoring input health and responding to failures in real time. If the primary input disconnects or its bitrate drops below a defined threshold, Streamrun automatically switches to a backup source or displays a fallback image or video. Each failover feature can be used independently — you don't need to enable all of them.
Settings
Failover type
Defines what happens when the primary input goes offline.
No failover action is taken. Useful when you only want bitrate alerts or webhook notifications without switching the output.
Displays a static image when the input disconnects. Use a 1920×1080 PNG for horizontal streams or 1080×1920 for vertical streams.
Connects a backup input to the Failover element. The backup can be another Input Stream element or a Video Player playing a pre-recorded video. Set a Recovery type to define what happens when the primary input comes back online.
Low bitrate alerts
When the input bitrate drops below a threshold you set, Streamrun can inform viewers.
Viewers are not informed about low bitrate conditions.
Displays a text message over the video.
Overlays a custom image over the video.
Webhooks
Send an HTTP request to an external URL when a failover event occurs: when the input disconnects, when the bitrate drops below the threshold, or when stream health recovers.
Bitrate webhooks are triggered at most once per minute to prevent flooding when the connection is unstable. Use the Test button to verify your webhook URL is working before going live.
Play a video as fallback
Connect a Video Player element to the backup input to automatically play a pre-recorded MP4 when the primary stream fails. Useful for "Stream Starting Soon" or "Technical Difficulties" sequences.
Related
Disconnect Protection
How Streamrun keeps the outgoing stream live when your device loses connection.
Video Player
Play a pre-recorded video as fallback content when the primary stream fails.
Input Stream
Configure the primary input source that the Failover element monitors.
All elements
Overview of every element available in a Streamrun configuration.
Join Streamrun Discord