README.md
July 22, 2026 · View on GitHub
Live777
A real-time audio and video streaming media server
Live777 is a very simple, high performance, lightweight WebRTC SFU (Selective Forwarding Unit) server, with WHIP/WHEP as its first-class protocols.
Live777 works with GStreamer, FFmpeg, OBS Studio, VLC, WebRTC and other clients to receive and distribute streams — a typical publish (push) / subscribe (play) server model. It also converts between the audio and video protocols widely used on the Internet, such as RTP/RTSP to WHIP and WHEP.
Features
-
📚 Support
WHIP/WHEPImplements the WHIP/WHEP protocols for out-of-the-box interoperability with other WebRTC application modules — no custom adaptation required.
-
🗃️ P2P/SFU Mix architecture
Only forwards media streams — no mixing, transcoding or other resource-hungry media processing on the server. Encoding and decoding stay on the sender and the receiver respectively.
-
🌐 Multiple platform support
Native support for Linux, macOS, Windows and Android, on both ARM and x86.
-
🕸️ Cluster & cascade
The companion
livemanmanager turns multiple Live777 nodes into a cluster — proxying client requests, managing cascade state between nodes, and coordinating recording across the cluster. -
🎥 Stream recording
Record published streams as fragmented MP4 segments to the local filesystem or S3-compatible object storage, controlled through the REST API.
-
📊 WebUI & observability
An embedded WebUI, admin and session REST APIs, and Prometheus metrics are built in for easy operation and observability in production.
Quick Start
Run Live777 with Docker (host networking is required):
docker run --name live777-server --rm --network host ghcr.io/binbat/live777-server:latest live777
Then open your browser at http://localhost:7777/.
For prebuilt binaries, Linux packages, winget and cargo installs, see the installation guide.
Tools
This repository also ships these companion tools:
| Tool | Description |
|---|---|
liveman | Cluster manager for multiple Live777 nodes |
whipinto | Push RTP/RTSP streams into a WHIP endpoint |
whepfrom | Pull a WHEP stream and output RTP/RTSP |
net4mqtt | TCP/UDP-over-MQTT proxy and tunnel |
Sponsors
This work is supported by Xidian University.