Service: Join Live - EyevinnOSC/community GitHub Wiki

Getting Started

Join Live is an open source web application that lets participants join live broadcasts directly from their browser using WebRTC. It provides a professional editor interface for managing up to two simultaneous participants, a moderator-approved messaging system, and OBS Studio integration via WHEP. The application connects to a Symphony Media Bridge (SMB) deployment via WHIP and WHEP gateways.

Available as a managed service in Eyevinn Open Source Cloud.

Prerequisites

  • An Eyevinn OSC account
  • A running Symphony Media Bridge WHIP Gateway instance (eyevinn-smb-whip-bridge)
  • A running Symphony Media Bridge WHEP Gateway instance (eyevinn-wrtc-egress)

Step 1: Deploy the Symphony Media Bridge gateways

Join Live requires both a WHIP ingestion gateway and a WHEP egress gateway. If you do not already have them running, create them first.

Navigate to the WHIP Gateway service and create an instance. Then navigate to the WHEP Gateway service and create an instance. Copy the URLs shown on each instance card — you will need them in the next step.

Step 2: Create a Join Live instance

Navigate to the Join Live service page and click Create join-live.

Configure the instance:

  • Name — a unique name for this Join Live instance
  • WhipGatewayUrl — the URL of your WHIP gateway instance
  • WhepGatewayUrl — the URL of your WHEP gateway instance
  • WhipAuthKey (optional) — an authentication key for the WHIP gateway if it requires one

Once the instance is running, click the URL on the instance card to open the Join Live web interface.

Step 3: Use Join Live

For participants: Open the Join Live URL in a browser and click Join to request access to the broadcast. Allow camera and microphone access when prompted.

For editors/moderators: The editor interface shows incoming join requests, lets you accept or reject participants, manage up to two simultaneous video feeds side by side, and review chat messages before they are displayed.

For OBS Studio: The editor view includes a WHEP stream URL that can be used as a media source in OBS Studio for recording or re-streaming.

CLI usage

osc create eyevinn-join-live mybroadcast \
  -o WhipGatewayUrl="https://<whip-instance>.svc.prod.osaas.io" \
  -o WhepGatewayUrl="https://<whep-instance>.svc.prod.osaas.io"

Resources