Teradek User Guide

Return Video Configuration via Encoder

Updated on

Use Return Video on a Prism encoder to decode an inbound stream and output it over SDI/HDMI for monitoring. After you activate the Return Video License, choose an Ingest Mode (TRT, SRT, MPEG-TS, RIST, RTSP, RTMP, WHEP, File, or URL), set buffer lengths for stability, and configure video/audio outputs to match your setup.

NOTE: Decoder functionality on the encoder requires a license.

Ingest Settings

  • Return Video - enables the Prism device to produce a secondary output.
    • Decoder Mode - Enable or Disable Decoder SDI loop out
    • Monitor Video Source - Set the attached monitor's video input to either the device's selected input (SDI/HDMI) or the device's SDI output.
  • Ingest Mode  - Selects which protocol is used for ingest.
    • MPEG TS
    • SRT
    • TRT
    • RIST
    • RTSP
    • RTMP
    • File Playback
    • Generic Streaming URL
    • WHEP (Beta)
  • Ingest Settings
    • Buffer Length - The amount of video (in ms) stored before decode. This allows the decoder to absorb packet loss or slowness.
    • Max Buffer Length - If the video stops due to packets not arriving,  this value is the maximum amount of video storage the decoder can dynamically increase to, to overcome latency.

MPEG TS

  • Protocol (default: TCP)
    • TCP - Listens for video on a specific port using a TCP connection
    • TCP Pull - Pulls video from a specific IP address using a TCP connection
    • UDP - Listens for video on a specific port using a UDP connection
    • Multicast - Pulls video from a multicast address (LAN) and port.

NOTE: Your network must be setup to handle multicast traffic.

SRT

  • Connection Type - (default: caller)
    • Caller - Decoder initiates the connection to the specified IP address
    • Listener - Decoder listens for the stream
    • Rendezvous -  Both decoder and encoder attempt to connect to each other
  • Host - Caller and Rendezvous only - IP address or DNS entry that the decoder will attempt to make contact with.
  • Port - Port that the decoder will attempt call or listen on. Call is outbound. Listen is inbound.
  • Stream ID- A customizable identifier that allows routing and identification of individual SRT streams within a single connection or address, often used to direct streams to specific applications or destinations.
  • Encryption - Turns on the option for Encryption
  • Passphrase - Sets the passphrase (salt) for the encryption key
  • Encryption Key Size (default: 128 bits) - sets the size of the encryption key. Values correspond to 16/24/32 bytes.
  • Latency (default: 500) -  The buffering delay introduced to counteract network instability, ensuring smooth, reliable streaming by accommodating packet loss and jitter before reaching the decoder

RIST

Teradek is part of the RIST alliance

  • Connection Type (default: Client)
    • Client - Decoder initiates the connection to the specified IP address
    • Server - Decoder listens for the stream
  • Host - Client mode only - IP address or DNS entry that the decoder will attempt to make contact with.
  • Port (Client or Server) - Port that the decoder will attempt initiate or listen on.  Client is outbound. Server is inbound.
  • Encryption (Default: off)- Turns on the option for Encryption
  • Passphrase - Sets the passphrase (salt) for the encryption key
  • Encryption Key Size (default: 128 bits) - Sets the size of the encryption key.  128 bits or 256 bits
  • Canonical Name - Uniquely identifies a device or endpoint in a network, helping distinguish between multiple sources and destinations within a RIST session

RTSP

  • Host -  IP address or DNS entry that the decoder will attempt to make contact with.
  • RTSP Server Port - Port that the decoder will attempt to call.  Call is outbound.
  • Stream Name - a unique identifier for a specific media stream on a server
  • Authentication - Activates the username and password fields for password-protected streams

RTMP

Teradek is part of the RIST alliance

  • Connection Type (default: Client)
    • Client - Decoder initiates the connection to the specified IP address
    • Server - Acts as an RTMP server - Decoder listens for the stream
  • Host - Client mode only - IP address or DNS entry that the decoder will attempt to make contact with.
  • Port (Client or Server - default: 1935) - Port that the decoder will attempt initiate or listen on.  Client is outbound. Server is inbound.
  • App-Name - specifies the application or virtual directory on the streaming server that the client connects to
  • Stream Key - unique identifier provided by the streaming platform to authenticate and link a live broadcast
  • Authentication - Activates the username and password fields for password-protected streams

File Playback

Allows files stored on SD card to be played back live to SDI or HDMI

  • Select File - Selects file from attached media (SD Card, NFS, or NVME) for playback
  • Stream Name - a unique identifier for a specific media stream on a server
  • Authentication - Activates the username and password fields for password protected streams

Generic Stream URL

The generic stream url is a flexible streaming URL syntax used to decode many different types of video streams (similar to VLC).  Supported syntax includes  

MPEG TS 'tcp://', 'udp://',

SRT 'srt://',

RIST: 'rist://',

RTMP - 'rtmp://', 'rtmp-pull://', 'rtmp-server://',

RTP / RTSP -  'rtp://', 'rtsp://', 'rtsp-top://','rtsp-udp://', 'rtsp-udp-multi://',  

HLS-DASH 'http://'

  • Video Stream URL - the url formatted in by protocol and address ie. srt://172.24.100.23:3458

WHEP

WebRTC-HTTP Egress Protocol - Pull based WebRTC over http

  • WHEP Stream URL - Selects file from attached media (SD Card, NFS, or NVME) for playback
  • Bearer Token - authorization token used to authenticate and grant access to a specific media resource

Video Output Settings

  • Output Format - Displays the video resolution for the encoded video.
  • Color Overide - Allows users to override Color Settings on output
    • EOTF (default: Default) - defines how digital video signals are translated into luminance on screens, ensuring accurate brightness and color reproduction, especially in HDR content.
    • Colorimetry (default: Default) - Default, SDR, SMPTE2084, HLG
    • Range - (default: Default) - Legal, Full

Audio Output

Decode Audio (default: TCP) - Enable or Disable

Multi-Track Mode - Enables or disables the multi-track audio configuration (default: disabled).

Multi-Track Mode Disabled:

  • Channel Layout Output - Layout of audio for 5.1/7.1 audio
    • SMPTE - Standard broadcast/professional audio channel mapping (L-R-C-LFE-Ls-Rs)
    • Film - Cinema-style channel arrangement for theatrical content (L-R-C-LFE-Ls-Rs-Lrs-Rrs)
    • HDMI - Consumer electronics channel layout for HDMI devices (FL-FR-FC-LFE-BL-BR)
       
  • Embedded Output Volume - Master Volume for Track
  • Delay - How much delay (in ms) to add to a track.

Multi-Track Mode Enabled:

  • Delay - How much delay (in ms) to add to a track.
  • Channel Mode (default: 8 Channels) - How many channels to populate on the digital output.  2,4,6,8,16 channels
  • Volume Control - Controls volume output and mute for output channels.
  • Channel Settings - Configure how audio tracks and channels are mapped.
    • Source Track - Select from Tracks 1–8.
    • Source Channel - 1-8 of each of those channels

Metadata Settings

  • Timecode: Inserts timecode extracted from H.264/HEVC SEI
  • Closed Captions: Choose Off, 608 (SD), or 708 (HD) to pass captions when present.
Previous Articles Return Video
Next Articles Streaming