Software IntegrationGStreamer

GStreamer - ZED RTSP Server

Open in ClaudeOpen in ChatGPT

The Real Time Streaming Protocol (RTSP) is a network control protocol designed for use in entertainment and communications systems to control streaming media servers. The protocol is used for establishing and controlling media sessions between endpoints.

ZED RTSP Server is a GStreamer application for the Linux operating system that allows instantiating an RTSP server from a text launch pipeline using the “gst-launch” style.

The ZED RTSP server listens for connection requests on a TCP/IP port and allows to delivery of several ZED media streams simultaneously and independently of each other.

Usage

The RTSP Server can be started

$ gst-zed-rtsp-launch [OPTION?] PIPELINE-DESCRIPTION

Help Options:

  • -h, --help -> Show help options.
  • --help-all -> Show all help options.
  • --help-gst -> Show GStreamer Options.

Application Options:

  • -p, --port=PORT -> Port to listen on (default: 8554).
  • -a, --address=HOST -> Host address (default: 127.0.0.1).

Example

Acquire a ZED stream using the default configuration, and provide RTSP connection streams using H264 encoding:

$gst-zed-rtsp-launch zedsrc ! videoconvert ! 'video/x-raw, format=(string)I420' ! x264enc ! rtph264pay pt=96 name=pay0

A console log provides information about the RTSP server address at which an RTSP-capable client can connect to acquire the ZED stream:

$ ZED RTSP Server 
$-----------------
$ * Stream ready at rtsp://127.0.0.1:8554/zed-stream

it is mandatory to define at least one payload named pay0; it is possible to define multiple payloads using an increasing index (i.e. pay1, pay2, …).

A client can be created using GStreamer with the standard gst-launch application:

$gst-launch-1.0 rtspsrc location=rtsp://${SERVER_IP}:8554/zed-stream latency=0 ! decodebin ! fpsdisplaysink

The decodebin element automatically creates the required pipeline to decode the incoming stream and convert it for the fpsdisplaysink sink element.