Teradek User Guide

Decoder Configuration via Encoder (Decode License)

Updated on

NOTE: Decoder functionality on the encoder requires a license.

Ingest Settings

  • INGEST MODE - Selects which protocol is used for ingest.
    • MPEG TS
    • SRT
    • TRT (Beta)
    • RIST
    • RTSP
    • RTMP
    • File Playback
    • Generic Streaming URL
    • WHEP (Beta)
  • BUFFER LENGTH - Amount of video (in ms) stored before decode.  Allows the decoder to absorb packet loss or slowness of packets.
  • 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- 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 corresponds 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 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 OVERRIDE - 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 Settings

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
    • FILM
    • HDMI
  • EMBEDDED OUTPUT VOLUME - Master Volume for Track
    • 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.
  • 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 - Setting of  Source Track and Source Channel for mapping.
    • Source Track - 1-8 of any type of track.
    • Source Channel - 1-8 of each of those channels (eg mono has 1, stereo has 2, 5.1 has 6, 7.1 has 8)
Previous Articles Decoder Configuration
Next Articles Streaming