Getting Started

SRT Stream Generator is an FFmpeg-powered test stream generator that produces synthetic video test patterns and audio tones with SRT output. It requires no input source, making it ideal for testing SRT-based ingest pipelines, validating decoders, and developing live streaming workflows before a real camera or encoder is available. A web UI lets you manage multiple streams in parallel and monitor them in real time. Available as an open web service in Eyevinn Open Source Cloud.

Prerequisites

If you have not already done so, sign up for an Eyevinn OSC account

Step 1: Create an SRT Stream Generator instance

Navigate to the SRT Stream Generator service in the Eyevinn OSC web console. Click Create srt-stream-generator and enter a name (alphanumeric and underscores only).

The instance starts automatically. Click the instance card when the status is green and "running" to open the web UI.

Step 2: Configure a stream

In the web UI, click New Stream and configure:

Field	Description
SRT URL	Destination SRT URL, e.g. `srt://receiver-host:9000?mode=caller`
Video pattern	Test pattern type (SMPTE bars, color bars, etc.)
Resolution / Bitrate	Output video quality
Audio	Sine tone frequency, white noise, or audio-only mode

Click Start to begin generating the stream.

Step 3: Connect your SRT receiver

Point your SRT-capable player, encoder, or ingest service at the SRT URL. For listener mode, use the instance's public URL and the port you configured.

Example — receive with FFmpeg:

ffplay srt://your-instance-url:9000

Example — receive with VLC: Open srt://your-instance-url:9000 from Media → Open Network Stream.

API usage

The service exposes a REST API with interactive Swagger documentation at https://your-instance-url/api-docs. You can create and manage streams programmatically:

# List active streams
curl https://your-instance-url/api/streams

# Start a new stream
curl -X POST https://your-instance-url/api/streams \
  -H "Content-Type: application/json" \
  -d '{"srtUrl":"srt://receiver:9000","pattern":"smptebars"}'

CLI usage

osc create bjowestman-srt-stream-generator my-test-src