SRT Ingest (Listener)

Receives SRT media streams as a listener from remote sources on configurable ports

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	✓
port	The port this SRT input will listen on (default: 5001)	✗	`<COMPONENT_ID>_PORT`
host	The IP address/hostname this SRT input will listen on (default: "0.0.0.0")	✗	`<COMPONENT_ID>_HOST`
passphrase	Optional: Authentication for this SRT input	✗	`<COMPONENT_ID>_PASSPHRASE`
socketOptions	Socket Options	✗
sourceNames	Either auto assign streams in the order they come in, or restrict connections to those with known stream ids (default: "permissive")	✗
streamIds	List of stream ids to assign to the accepted streams (default: ["camera1"])	✗
burstProtection	Hold the output back at startup until the incoming feed's timing has settled, so a connection's initial burst is not passed downstream. Costs a few seconds at join: a clean audio-only feed releases in about 3s, and any feed is released within 10s whether it settled or not. Nothing is held back once running. Turn it off for the fastest possible join on a link you already trust. (default: true)	✗
captureSchedule	Also capture the future EIT schedule (not just now/next). The full schedule can be large, so this defaults to off. (default: false)	✗
sourceRecordingDirectory	Record each source's transport stream, exactly as it arrives, to this directory: one <source name>.ts file per connected stream. An absolute path on the Norsk engine's filesystem, which must already exist. Leave unset to record nothing.	✗
sourceRecordingMode	Raw writes the bytes as they arrive; segmented cuts them into segments, each led by a copy of the source's PAT and PMT, so each plays on its own. (default: "raw")	✗
healthPolicy	Connection health: override the document-wide Input health policy, thresholds or sampling for this input	✗
initialState	The ingest state of this component on start-up (default: "enabled")	✗	`<COMPONENT_ID>_INITIALSTATE`
decodeOutputs	Automatic decode configuration	✗
timeDomain	Optional: time domain for frame-accurate alignment with other inputs (Global Configuration → Time Domains)	✗
streamMappings	Configure which streams to accept from this input	✗
notes	Additional notes about this component	✗

A unique identifier for the component instance

✓

displayName

The name shown in the Studio UI of this component

✓

port

The port this SRT input will listen on (default: 5001)

✗

<COMPONENT_ID>_PORT

host

The IP address/hostname this SRT input will listen on (default: "0.0.0.0")

✗

<COMPONENT_ID>_HOST

passphrase

Optional: Authentication for this SRT input

✗

<COMPONENT_ID>_PASSPHRASE

socketOptions

Socket Options

✗

sourceNames

Either auto assign streams in the order they come in, or restrict connections to those with known stream ids (default: "permissive")

✗

streamIds

List of stream ids to assign to the accepted streams (default: ["camera1"])

✗

burstProtection

Hold the output back at startup until the incoming feed's timing has settled, so a connection's initial burst is not passed downstream. Costs a few seconds at join: a clean audio-only feed releases in about 3s, and any feed is released within 10s whether it settled or not. Nothing is held back once running. Turn it off for the fastest possible join on a link you already trust. (default: true)

✗

captureSchedule

Also capture the future EIT schedule (not just now/next). The full schedule can be large, so this defaults to off. (default: false)

✗

sourceRecordingDirectory

Record each source's transport stream, exactly as it arrives, to this directory: one <source name>.ts file per connected stream. An absolute path on the Norsk engine's filesystem, which must already exist. Leave unset to record nothing.

✗

sourceRecordingMode

Raw writes the bytes as they arrive; segmented cuts them into segments, each led by a copy of the source's PAT and PMT, so each plays on its own. (default: "raw")

✗

healthPolicy

Connection health: override the document-wide Input health policy, thresholds or sampling for this input

✗

initialState

The ingest state of this component on start-up (default: "enabled")

✗

<COMPONENT_ID>_INITIALSTATE

decodeOutputs

Automatic decode configuration

✗

timeDomain

Optional: time domain for frame-accurate alignment with other inputs (Global Configuration → Time Domains)

✗

streamMappings

Configure which streams to accept from this input

✗

notes

Additional 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.

Socket Options

Option	Description	Required
receiveLatency	The latency value in the receiving direction of the socket (SRTO_RCVLATENCY)	✗
peerLatency	The latency value provided by the sender side as a minimum value for the receiver (SRTO_PEERLATENCY)	✗
inputBandwidth	Input bandwidth (SRTO_INPUTBW)	✗
overheadBandwidth	Overhead bandwidth (SRTO_OHEADBW)	✗
maxBandwidth	Max bandwidth (SRTO_MAXBW)	✗
peerIdleTimeoutMs	Peer Idle Timeout (Input only)	✗

Option

Description

Required

receiveLatency

The latency value in the receiving direction of the socket (SRTO_RCVLATENCY)

✗

peerLatency

The latency value provided by the sender side as a minimum value for the receiver (SRTO_PEERLATENCY)

✗

inputBandwidth

Input bandwidth (SRTO_INPUTBW)

✗

overheadBandwidth

Overhead bandwidth (SRTO_OHEADBW)

✗

maxBandwidth

Max bandwidth (SRTO_MAXBW)

✗

peerIdleTimeoutMs

Peer Idle Timeout (Input only)

✗

Health Policy

Option	Description	Required
mode	Override the document-wide Input health policy for this input (default: "inherit")	✗
thresholds	Alert thresholds the engine judges connections against; blank fields use the recommended values	✗
sampling	How often the engine samples connection health	✗
dropThresholds	Enforce: past these the publisher is disconnected. Looser than the alert thresholds; blank fields use the drop defaults	✗
backoff	Enforce: how long a refused publisher stays refused	✗
denyKey	Enforce: what a refused publisher is keyed on (default: "host-and-source")	✗
reconnect	SRT: when a publisher reconnects while its previous connection is still registered (it died abruptly and the peer-idle timeout has not yet fired) (default: "reject")	✗

Option

Description

Required

mode

Override the document-wide Input health policy for this input (default: "inherit")

✗

thresholds

Alert thresholds the engine judges connections against; blank fields use the recommended values

✗

sampling

How often the engine samples connection health

✗

dropThresholds

Enforce: past these the publisher is disconnected. Looser than the alert thresholds; blank fields use the drop defaults

✗

backoff

Enforce: how long a refused publisher stays refused

✗

denyKey

Enforce: what a refused publisher is keyed on (default: "host-and-source")

✗

reconnect

SRT: when a publisher reconnects while its previous connection is still registered (it died abruptly and the peer-idle timeout has not yet fired) (default: "reject")

✗

Decode Outputs

Option	Description	Required
decode	Decode on input (default: false)	✗
hardwareAcceleration	Optionally override the global hardware settings	✗

Option

Description

Required

decode

Decode on input (default: false)

✗

hardwareAcceleration

Optionally override the global hardware settings

✗

Global Configuration

Time Domains

Environment override: GLOBAL_TIME_DOMAINS (sets this global option as a whole).

Option	Description	Required
id	Domain ID. Inputs (and documents on the same engine) that use this ID share a coordinator. Letters, digits, dash and underscore.	✓
mode	How members of this domain are aligned. (default: "time_aligned_pts")	✗
seiTimeoutMs	Time-aligned (SEI timecode) only. How long (ms) a member waits for its first SEI-bearing frame before taking the action below. Blank = wait indefinitely.	✗
onSeiTimeout	Time-aligned (SEI timecode) only. Action when the SEI timeout elapses: fail the input, or demote it to default (uncoordinated) timing. (default: "fail")	✗
walltimeThresholdMs	GOP-aligned only. Walltime threshold (ms) for accepting a member's IDR against the rolling reference. Default 400 — keep under half the GOP duration. (default: 400)	✗

Option

Description

Required

Domain ID. Inputs (and documents on the same engine) that use this ID share a coordinator. Letters, digits, dash and underscore.

✓

mode

How members of this domain are aligned. (default: "time_aligned_pts")

✗

seiTimeoutMs

Time-aligned (SEI timecode) only. How long (ms) a member waits for its first SEI-bearing frame before taking the action below. Blank = wait indefinitely.

✗

onSeiTimeout

Time-aligned (SEI timecode) only. Action when the SEI timeout elapses: fail the input, or demote it to default (uncoordinated) timing. (default: "fail")

✗

walltimeThresholdMs

GOP-aligned only. Walltime threshold (ms) for accepting a member's IDR against the rolling reference. Default 400 — keep under half the GOP duration. (default: 400)

✗

Tags: srt listener ingest eit epg program guide