Service: SRT WHEP Bridge - EyevinnOSC/community GitHub Wiki

Getting Started

SRT to WHEP application ingests MPEG-TS over SRT stream and outputs to WebRTC using WHEP signaling protocol. Available as an open web service in Eyevinn Open Source Cloud to quickly get you started.

One use case of this bridge is for a reporter or commentator on the field to be able to watch the program output without having any particular hardware or software. Should be noted that the bridge is just a bridge and not a service for distributing to a large audience. In combination with Open Source Cloud Intercom you would have both four-wire communication and program output using only a standard web browser.

srt_to_whep_bridge

Prerequisites

Step 1: Create a bridge

Navigate to the SRT WHEP Bridge service in Eyevinn Open Source Cloud web console. Press the button "Create bridge".

Enter the following details:

  • Name: the name of the bridge
  • SourceIp: the IP address to your SRT stream. The SRT stream needs to be in listener mode.
  • SourcePort: the port to your SRT stream.

Step 2: Play SRT stream in browser

When the bridge is up and running you can use a WebRTC player that implements the WHEP protocol, for example the WebRTC player here: https://webrtc.player.eyevinn.technology/ (which is by the way also open source).

Enter the URL to the SRT WHEP bridge followed by the path /channel in the WebRTC player for playback to start. You find the URL to the bridge on the instance card. In this example it is https://eyevinnlab-guide.eyevinn-srt-whep.auto.prod.osaas.io so for the player we provide the URL https://eyevinnlab-guide.eyevinn-srt-whep.auto.prod.osaas.io/channel.

Startup time may vary depending on your location but you will find that the latency is very low. The bridge does not transcode any video.

In the above screenshot you find an example where the SRT source is a test stream with time burned in to the video.

Using the CLI

To create a bridge using the CLI you run:

% osc create eyevinn-srt-whep test \
  -o SourceIp="srt.osaas-testsrc" \
  -o SourcePort=9234

and to remove it:

% osc remove eyevinn-srt-whep test