Hard Source Switch

Instantly switches between multiple audio and video sources without transcoding

Component Configuration

Option Description Required Environment override

Option	Description	Required	Environment override
id	A unique identifier for the component instance	✓
displayName	The name shown in the Studio UI of this component	✓
outputSource	Source name for the switched output (default: "output")	✗
bufferMs	Duration to delay all streams to ensure smooth switching when a stream goes away (recommended a little more than largest GoP length)	✗
sourcePriority	The priority order in which the sources will be chosen when available (default: [])	✗
failoverTimeoutMs	Automatic failover timeout (ms) when active source stops sending frames (default: 2000)	✗
maxQueueMs	Maximum queue time (ms) for streams running behind (default: 1000)	✗
fallbackFilePath	Optional MP4 file to use as fallback	✗	`<COMPONENT_ID>_FALLBACKFILEPATH`
notes	Optional notes	✗

A unique identifier for the component instance

✓

displayName

The name shown in the Studio UI of this component

✓

outputSource

Source name for the switched output (default: "output")

✗

bufferMs

Duration to delay all streams to ensure smooth switching when a stream goes away (recommended a little more than largest GoP length)

✗

sourcePriority

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

✗

failoverTimeoutMs

Automatic failover timeout (ms) when active source stops sending frames (default: 2000)

✗

maxQueueMs

Maximum queue time (ms) for streams running behind (default: 1000)

✗

fallbackFilePath

Optional MP4 file to use as fallback

✗

<COMPONENT_ID>_FALLBACKFILEPATH

notes

Optional notes

✗

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.

Tags: switch hard source program cut