rob
/
moq-rs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
moq-rs/README.md

1.9 KiB
Raw Blame History

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.

Requirements

  • Chrome: currently (May 2023) the only browser to support both WebTransport and WebCodecs.
  • yarn: required to install dependencies.

Requirements

  • rust: duh
  • ffmpeg: (optional) used to generate fragmented media
  • go: (optional) used to generate self-signed certificates
  • openssl: (options) ...also used to generate self-signed certificates

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, by default media/fragmented.mp4:

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.

Otherwise, we use mkcert to install a self-signed CA:

./cert/generate

With no arguments, the server will generate self-signed cert using this root CA. This certificate is only valid for 2 weeks due to how WebTransport performs certificate fingerprinting.

Server

`The Warp server supports WebTransport, pushing media over streams once a connection has been established.

cargo run

This listens for WebTransport connections on https://localhost:4443 by default. Use a MoQ client to connect to the server.