56adbf89f5
Untested for contribution while I work on JS stuff. |
||
---|---|---|
.github/workflows | ||
cert | ||
media | ||
moq-demo | ||
moq-transport | ||
moq-warp | ||
.editorconfig | ||
.gitignore | ||
.rustfmt.toml | ||
Cargo.lock | ||
Cargo.toml | ||
LICENSE | ||
NOTICE | ||
README.md |
README.md
Media over QUIC
Media over QUIC (MoQ) is a live media delivery protocol utilizing QUIC streams. See the Warp draft.
This repository is a Rust server that supports both contribution (ingest) and distribution (playback). It requires a client, such as moq-js.
Setup
Media
This demo simulates a live stream by reading a file from disk and sleeping based on media timestamps. Obviously you should hook this up to a real live stream to do anything useful.
Download your favorite media file and convert it to fragmented MP4. This requires ffmpeg
wget http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4 -O media/source.mp4
./media/generate
Certificates
Unfortunately, QUIC mandates TLS and makes local development difficult. If you have a valid certificate you can use it instead of self-signing.
Use mkcert to generate a self-signed certificate. Unfortunately, this currently requires Go in order to fork the tool.
./cert/generate
Unfortunately, WebTransport in Chrome currently (May 2023) doesn't verify certificates using the root CA.
The workaround is to use the serverFingerprints
options, which requires the certificate MUST be only valid for at most 14 days.
This is also why we're using a fork of mkcert, because it generates certificates valid for years by default.
This limitation will be removed once Chrome uses the system CA for WebTransport.
Usage
Run the server:
cargo run
This listens for WebTransport connections on https://localhost:4443
by default.
Use a MoQ client to connect to the server.