Teradek User Guide

Decoder Configuration

Updated on

Use the Decoder Configuration settings to enable video decoding, select ingest protocols, and manage video, audio, and metadata output from your Prism device. These settings determine how your device receives, buffers, and plays video content through SDI or HDMI outputs.

Ingest Settings

  • Ingest Mode - Select the protocol used to receive (ingest) the video stream:
    • MPEG TS
    • SRT
    • TRT (Beta)
    • RIST
    • RTSP
    • RTMP
    • File Playback
    • Generic Streaming URL
    • WHEP (Beta)
    • Teradek Cloud
    • Hyperion - Requires a debonding license.
  • Buffer Length - Sets the amount of buffered video (in milliseconds) stored before decoding. This helps absorb network jitter or packet loss.
  • Max Buffer Length - Sets the amount of buffered video (in milliseconds) stored before decoding. This helps absorb network jitter or packet loss.

MPEG TS

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

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

Teradek Cloud

Connects to Core Share or Teradek TV for selectable decode. The Decoder acts as a client similar to Core Share / Teradek TV apps. You may sign into Core with one account and authenticate with Core Share with another.

  • Cloud Service - Select Core Share or Teradek TV.
    • Organization - Select an Organization from your Core account.
    • Workspace (Space in Teradek TV) - Select a workspace from within the Organization.
  • Source - Source determines the media you want the decoder to receive from Core or Teradek TV, such as Cameras (Streams) or Recordings stored in your Core or Teradek TV.
    • Cameras - Lists available live encoder feeds within the selected organization and workspace.
    • Recordings - Displays available recordings in the selected workspace. Choose a file to begin playback through the decoder.
      • Recordings Navigation - Browse through pages of recordings stored on Core Share or Teradek TV.
      • Recording Playback Bar – Monitor and control playback progress.
      • Pause Button – Pauses the recording during playback.
      • Loop Playback – Repeats the recording continuously.

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.
      • SDR
      • SMPTE2084
      • HLG
    • Colorimetry (default: Default) - Defines how colors and brightness levels are represented in a video signal, ensuring accurate color reproduction on your display.
      • BT.601
      • BT.709
      • BT.2020
      • P3-DCI (Theater)
      • P3-D65 (Display)
      • Other
    • Range - (default: Default) - Defines how brightness and color values are represented in the video signal.
      • Default
      • Legal
      • Full

Audio Output Settings

  • Decode Audio (default: TCP) - Enable or Disable audio decoding. When enabled, audio is embedded with the video output.
  • Multi-Track Mode (default: disabled) - Enables multiple audio tracks. When disabled, only one audio mix is output.

Multi-Track Mode Disabled:

  • Channel Layout Output- Sets how audio channels are arranged for output.
    • SMPTE
    • FILM
    • HDMI
  • Embedded Output Volume - Controls the overall volume of the embedded audio signal.
  • Delay- Adds a short delay (in milliseconds) to sync audio with video

Multi-Track Mode Enabled:

  • Delay - Adds a short delay (in milliseconds) to sync audio with video.
  • Channel Mode (default: 8 Channels) - Sets how many audio channels are sent through the digital output (2, 4, 6, 8, or 16).
  • 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)

Metadata Settings

Prism's Metadata Settings allow you to embed Timecode and Closed Captioning data from your camera onto your video footage.

  • Timecode (Default: Off) - Inserts timecode extracted from H.264/HEVC SEI.
  • Closed Captions - Enables / Disables 608/708 Closed Captioning

Overlay Settings

The Overlay settings allow you to place graphics and other media over your decoded stream. You can create several different overlays.

  • Overlay
    • Enable - Enables overlay as active
    • Disable - Removes overlays

Create an Overlay

1. To create an overlay, click the + Add Overlay tab.

2. From the Overlay editing screen, tap Image on the top right corner to select an image as your overlay, or use the tools to create an overlay.

3. To preview how your Overlay will appear on the live stream, click Preview stream. To return to a transparent background, click Transparent.

4. Elements used to create an overlay are listed on the right. To modify an element, click any of the elements listed to open the editing panel. Click Save when you're done to return to the web UI.

5. From the Overlay settings, click Enabled, then select the overlay you want displayed on your live stream. Click Save when you're done. NOTE: Overlays will not appear unless you click Enabled.

The Overlay is now visible on your live stream

OSD Settings

On Screen Display allows moving overlay with Timecode or Date / Time

  • OSD Mode (default disabled)
    • Disable
    • SEI Timecode - Display timecode extracted from the stream SEl data.
    • SEl Time - Display frame capture time (with ms accuracy) embedded in stream timecode SEl. Works only if the stream was encoded by a Teradek Prism encoder with the Metatdata tab configured in.
    • SEI Date/Time - Display frame capture time (with ms accuracy) and date embedded in stream timecode

Location - Define the location of the OSD with a preset location or manual location.

Color Management

  • Mode - Select either CDL + 3D LUT or LiveGrade for your color management mode.
    • CDL Mode—You can enable or disable a CDL preset. Enabling CDL mode allows Prism to apply the preset to your preview.
    • CDL Split - Enable the preview window to display a split screen; one side showing the CDL preset applied to the preview, and the other side without.
    • CDL File - Select a CDL file to apply to the video preview. CDL files must first be uploaded to Prism from your computer by clicking Select file, then Upload CDL. To delete a file, click Delete CDL.
    • 3D LUT Mode - Enable or Disable a 3D LUT preset. Enabling 3D LUT mode allows Prism to apply the preset to your preview.
    • 3D LUT Split - Enable the preview window to display a split screen; one side shows the 3D LUT preset applied to the preview, and the other does not.
    • 3D LUT File - Select a 3D LUT file to apply to the video preview. 3D LUT files must first be uploaded to Prism from your computer by clicking Select file, then Upload 3D LUT. To delete a file, click Delete 3D LUT.
Previous Articles Encoder Configuration
Next Articles Return Video Configuration via Encoder