moq-cli

moq-cli

A command-line tool for publishing and subscribing to media over MoQ. It works with FFmpeg for encoding and decoding.

Install

cargo install moq-cli

Docker

docker pull moqdev/moq-cli

Multi-arch images (linux/amd64 and linux/arm64) are published to Docker Hub.

Usage

moq-cli routes endpoints onto a shared MoQ Origin: moq <MoQ side> <import|export> <endpoint>. The MoQ side (before the verb) is either --client-connect <url> (dial a relay) or --server-bind <addr> (self-host). import moves media into MoQ, export moves it out. The endpoint is a container format (fmp4, ts, flv, ... read from stdin / written to stdout), or a gateway (hls, rtmp, srt, rtc). A build with the play feature can also render a broadcast locally with moq <MoQ side> play.

Separate additional stages with -- to bridge several broadcasts (or both directions) over one connection, each naming its own --broadcast:

moq --client-connect https://relay.example.com/anon \
    import --broadcast cam1.hang rtmp --listen 0.0.0.0:1935 \
    -- import --broadcast cam2.hang rtmp --listen 0.0.0.0:1936

Publish to a remote relay

ffmpeg -i input.mp4 -f mp4 -movflags cmaf - | \
    moq --client-connect https://relay.example.com --broadcast my-stream.hang import fmp4

Subscribe from a remote relay

moq --client-connect https://relay.example.com --broadcast my-stream.hang export fmp4 | \
    ffplay -

Play the broadcast in a native window and speaker (requires --features play when building):

moq --client-connect https://relay.example.com --broadcast my-stream.hang play

Self-host: publish into a local relay

Hosts a MoQ server and publishes a single broadcast read from stdin into it. Useful for local testing without a separate relay process.

ffmpeg -i input.mp4 -f mp4 -movflags cmaf - | \
    moq --server-bind '[::]:4443' --tls-generate localhost --broadcast my-stream.hang import fmp4

Self-host: subscribe to an inbound broadcast

Hosts a MoQ server and writes an incoming broadcast's media to stdout. The inverse of the above.

moq --server-bind '[::]:4443' --tls-generate localhost --broadcast my-stream.hang export fmp4 | ffplay -

Import formats

• avc3 raw H.264 Annex-B from stdin
• fmp4 fragmented MP4 from stdin