Page is under construction.
Check the github issues for ways to contribute! Or provide your feedback in this quick form
Check the github issues for ways to contribute! Or provide your feedback in this quick form
Start here in 5 minutes
- Prereqs: Basic familiarity with web APIs and one broadcaster tool (OBS or browser encoder)
- Time: 5 minutes
- Outcome: You understand stream key/playback ID, ingest, and playback flow well enough to start the quickstart
- First action: Read Stream Key vs. Playback ID, then continue to Video Streaming Quickstart
How Live Video Works
A live stream travels through four stages:- Ingest — Your broadcaster sends a raw video signal to a server
- Transcoding — The server converts it into multiple quality levels for different devices and connection speeds
- Delivery — Processed video is made available via a CDN or playback server
- Playback — Viewers watch the stream in their browser or app
Core Concepts
Stream Key vs. Playback ID
These are the two most important identifiers in a live streaming workflow:| Stream Key | Playback ID | |
|---|---|---|
| What it is | Secret credential for publishing video | Public identifier for watching video |
| Who uses it | Broadcaster (OBS, encoder, streaming app) | Viewers (embedded player, your app) |
| Security | Keep secret — anyone with it can publish to your stream | Public — safe to expose to end users |
| How to get it | From your gateway/Studio when you create a stream | From your gateway/Studio alongside the stream key |
RTMP (Real-Time Messaging Protocol)
RTMP is the standard protocol for sending video from a broadcaster to an ingest server. OBS, hardware encoders, and most professional streaming tools support RTMP.HLS (HTTP Live Streaming)
HLS is the standard delivery format for live and on-demand video. It splits video into small segments and serves them over HTTP. Most players (browsers, mobile, smart TVs) support HLS natively.livepeercdn.studio is the documented Studio HLS playback host.
HLS introduces latency (typically 5-30 seconds) because viewers are buffering ahead. This is acceptable for most streaming use cases.
WebRTC / WHIP
WebRTC is a browser standard for real-time audio and video communication. Livepeer supports WebRTC ingest via WHIP (WebRTC-HTTP Ingest Protocol), enabling sub-second latency streaming directly from a browser without OBS.Latency Modes
| Mode | Latency | Protocol | Best For |
|---|---|---|---|
| Standard HLS | 10-30 seconds | HLS/MPEG-TS | Broadcast streaming, VOD-like quality |
| Low-Latency HLS (LL-HLS) | 2-5 seconds | LL-HLS | Sports, events, interactive streams |
| WebRTC Playback | Under 500ms | WebRTC/WHEP | Interactive, conversational, real-time AI video |
Transcoding and Quality Ladders
Transcoding converts an incoming high-quality stream into multiple renditions at different resolutions and bitrates — a quality ladder. The viewer’s player automatically selects the best rendition for their connection speed (called adaptive bitrate streaming). Example quality ladder:| Rendition | Resolution | Bitrate |
|---|---|---|
| 1080p | 1920×1080 | 4000 kbps |
| 720p | 1280×720 | 2000 kbps |
| 480p | 854×480 | 1000 kbps |
| 360p | 640×360 | 500 kbps |
How Livepeer Differs from Traditional Streaming
| Traditional (AWS MediaLive, Mux) | Livepeer | |
|---|---|---|
| Transcoding | Centralized cloud servers | Distributed GPU network |
| Pricing | Per-minute, billed by provider | Competitive market pricing |
| Control | Provider manages everything | Gateway operators control routing |
| Censorship resistance | Provider can terminate streams | Decentralized — no single point of control |
| AI video | Separate AI infrastructure required | AI inference native to the same network |
Key Terms Reference
| Term | Meaning |
|---|---|
| Stream | A live video broadcast session |
| Stream Key | Secret credential for publishing to a stream |
| Playback ID | Public identifier for watching a stream or asset |
| Ingest | Receiving raw video from a broadcaster |
| Transcode | Converting video into multiple formats/quality levels |
| Segment | A short chunk of video (typically 2-6 seconds) transcoded independently |
| Gateway | Livepeer network entry point that routes jobs to orchestrators |
| Orchestrator | GPU operator that performs transcoding and AI inference |
| RTMP | Protocol used by OBS and encoders to send video to an ingest server |
| HLS | HTTP-based playback format for live and on-demand video |
| LL-HLS | Low-latency variant of HLS (2-5 second delay) |
| WebRTC | Browser real-time communication protocol (sub-500ms latency) |
| WHIP | WebRTC ingest protocol — push video from browser to Livepeer |
| ABR | Adaptive Bitrate — automatic quality selection based on viewer connection |