A lightweight live streaming server that uses WebRTC for both ingest and playback. Streamers publish via WHIP and viewers watch via WHEP, enabling sub-second latency end-to-end.

sequenceDiagram
    participant Streamer as Streamer (OBS, etc.)
    participant EzStream
    participant Viewer as Viewer (browser)

    Streamer->>EzStream: WHIP POST /ingest (SDP offer)
    EzStream-->>Streamer: 201 (SDP answer)
    Streamer->>EzStream: WebRTC media

    Viewer->>EzStream: WHEP POST /whep/id (SDP offer)
    EzStream-->>Viewer: 201 (SDP answer)
    EzStream->>Viewer: WebRTC media

• ChannelStore manages channel configuration (ID, name, auth key) loaded from a JSON file.
• Notifier handles real-time push notifications to connected browsers over WebSocket when streams go live or offline.
• Server holds all WebRTC state, authenticates ingest requests, and fans out media from one streamer to many viewers using Pion's TrackLocalStaticRTP.

Pion's default interceptors (NACK, RTCP reports, TWCC) are enabled along with IntervalPLI for periodic keyframe requests, so new viewers get a clean picture quickly.

Channels are defined in a JSON file:

[
    {
        "id": "hello",
        "name": "My First Stream!",
        "authKey": "secretkeygoeshere"
    }
]

docker run -d \
    -p 8080:8080 \
    -p 20000-21000:20000-21000/udp \
    -v /path/to/channels.json:/app/channels.json \
    ghcr.io/haydenmc/ezstream \
    -channelsJsonFile /app/channels.json

The UDP port range must be published for WebRTC media transport.

Ingest (WHIP): Configure your streaming software to publish to http://<host>:8080/ingest with the channel's auth key as a Bearer token.

Watch: Open http://<host>:8080 in a browser and click a channel, or navigate directly to http://<host>:8080/watch/<channelId>.

cd src
go build -o ezstream .
./ezstream