FFmpeg / moq-cli

moq-cli is a command-line tool for publishing media to MoQ relays. It works with FFmpeg for encoding.

Installation

Using Cargo

cargo install moq-cli

Using Nix

nix build github:moq-dev/moq#moq

From Source

git clone https://github.com/moq-dev/moq
cd moq
cargo build --release --bin moq

The binary will be in target/release/moq.

Basic Usage

Publish a Video File

moq publish video.mp4 https://relay.example.com/anon/my-stream

Publish from FFmpeg

Pipe FFmpeg output directly to moq:

ffmpeg -i input.mp4 -f mpegts - | moq publish - https://relay.example.com/anon/my-stream

Publish a Webcam

# macOS
ffmpeg -f avfoundation -i "0:0" -f mpegts - | moq publish - https://relay.example.com/anon/webcam

# Linux
ffmpeg -f v4l2 -i /dev/video0 -f mpegts - | moq publish - https://relay.example.com/anon/webcam

Publish Screen

# macOS
ffmpeg -f avfoundation -i "1:" -f mpegts - | moq publish - https://relay.example.com/anon/screen

# Linux (X11)
ffmpeg -f x11grab -i :0.0 -f mpegts - | moq publish - https://relay.example.com/anon/screen

Encoding Options

Custom Video Settings

ffmpeg -i input.mp4 \
    -c:v libx264 -preset ultrafast -tune zerolatency \
    -b:v 2500k -maxrate 2500k -bufsize 5000k \
    -c:a aac -b:a 128k \
    -f mpegts - | moq publish - https://relay.example.com/anon/stream

Low Latency Settings

ffmpeg -i input.mp4 \
    -c:v libx264 -preset ultrafast -tune zerolatency \
    -g 30 -keyint_min 30 \
    -c:a aac \
    -f mpegts - | moq publish - https://relay.example.com/anon/stream

H.265/HEVC

ffmpeg -i input.mp4 \
    -c:v libx265 -preset ultrafast \
    -c:a aac \
    -f mpegts - | moq publish - https://relay.example.com/anon/stream

Authentication

Pass a JWT token via the URL:

moq publish video.mp4 "https://relay.example.com/room/123?jwt=<token>"

See Authentication for token generation.

Test Videos

The repository includes helper commands for test content:

# Publish Big Buck Bunny
just pub bbb https://relay.example.com/anon

# Publish Tears of Steel
just pub tos https://relay.example.com/anon

Clock Synchronization

Publish and subscribe to clock broadcasts for testing:

# Publish a clock
just clock publish https://relay.example.com/anon

# Subscribe to a clock
just clock subscribe https://relay.example.com/anon

Debugging

Verbose Output

RUST_LOG=debug moq publish video.mp4 https://relay.example.com/anon/stream

Check Connection

# Verify you can connect to the relay
curl http://relay.example.com:4443/announced/

Common Issues

"Connection refused"

• Ensure the relay is running
• Check firewall allows UDP traffic
• Verify the URL is correct

"Invalid certificate"

• The relay needs a valid TLS certificate
• For development, use the fingerprint method
• See TLS Setup

"Permission denied"

• Check your JWT token is valid
• Verify the token allows publishing to that path
• See Authentication

Next Steps

• Deploy a relay server
• Use Web Components for playback
• Try the Rust libraries for custom apps