Smart Source Switch

Switches between multiple audio and video sources based on availability and priority

Component Configuration

Option Description Required Environment override

id

A unique identifier for the component instance

displayName

The name shown in the Studio UI of this component

resolution

All video will be normalised to this resolution (default: {"width":1920,"height":1080})

frameRate

All video will be normalised to this frame rate (default: {"frames":25,"seconds":1})

sampleRate

All audio will be normalised to this sample rate (default: 48000)

channelLayout

All audio will be normalised to this channel layout (default: "stereo")

pixelFormat

Pixel format all video is normalised to. 4:2:2 preserves chroma detail that 4:2:0 discards, and 10-bit preserves precision that 8-bit truncates; both cost a larger intermediate. Software only. (default: "yuv420p")

hardwareAcceleration

Override the global hardware acceleration setting

<COMPONENT_ID>_HARDWAREACCELERATION

pipelineHints

Quadra-only hardware pipeline hints (ignored on other hardware)

sources

The priority order in which the sources will be chosen when available (default: [])

stayImpaired

When enabled, sources that drop below their low water mark stay impaired until manually cleared by the operator (default: false)

qualityWarmupMs

Time in milliseconds after a stream starts before quality scores affect switching decisions (default: 1000)

notes

Notes about this component

Options with an environment override can be set when Studio starts, without editing the workflow. <COMPONENT_ID> is this component’s id in your workflow, uppercased, with spaces and dashes replaced by underscores and other punctuation removed — a component named SRT Input reads SRT_INPUT_PORT. Renaming a component changes its id, and so changes these variable names.

Pipeline Hints

Option Description Required

type

rescaler

Quadra rescaler algorithm (ffmpeg ids: 0=default, 1=filterblit, 2=bicubic) (default: "default")

Tags: switch failover priority source program