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

resizeAlgorithm

Resize filter used on NVIDIA hardware: cubic (default), linear (cheaper, softer) or lanczos (sharpest) (default: "cubic")

✗

pipelineHints

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

✗

sources

The priority order in which the sources will be chosen when available. Per source, the Video and Audio water marks (LWM/HWM) switch on the MQA-VIDEO / MQA-AUDIO score, 0-100 where 100 means no fault detected: a source below its low water mark is impaired and skipped, and restored at or above its high water mark. Empty = off. For audio on an A/B pair try 70 / 85 (healthy programme scores 92-95, a dead channel about 50). Scores come from an upstream Quality Monitoring component per source. Silence switching (Silence line) takes effect after that many ms of unbroken silence, 10 s by default once audio switching is on (default: [])

✗

stayImpaired

When enabled, sources that drop below a low water mark (video or audio) 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