FFmpeg Integration moq-cli is a command-line tool that enables you to publish media to Moq relays using FFmpeg for encoding. This powerful combination allows you to stream from files, webcams, screens, and more.Installation
Choose your preferred installation method:
nix build github:moq-dev/moq#moq-cli
git clone https://github.com/moq-dev/moq cd moq cargo build --release --bin moq-cli # Binary will be in target/release/moq-cli
Ensure FFmpeg is installed on your system:
Basic Usage Publish a Video File The simplest way to publish a video file:
moq-cli publish video.mp4 https://relay.example.com/anon/my-stream
Publish from FFmpeg Pipe Pipe FFmpeg output directly to moq-cli:
ffmpeg -i input.mp4 -f mpegts - | moq-cli publish - https://relay.example.com/anon/my-stream
Common Use Cases Webcam Streaming Stream from your webcam:
ffmpeg -f avfoundation -i "0:0" -f mpegts - | \ moq-cli publish - https://relay.example.com/anon/webcam
Screen Capture Capture and stream your screen:
ffmpeg -f avfoundation -i "1:" -f mpegts - | \ moq-cli publish - https://relay.example.com/anon/screen
Encoding Options Low Latency Settings Optimize for minimal latency:
ffmpeg -i input.mp4 \ -c:v libx264 -preset ultrafast -tune zerolatency \ -g 30 -keyint_min 30 \ -c:a aac \ -f mpegts - | moq-cli publish - https://relay.example.com/anon/stream
The -g and -keyint_min flags control keyframe interval. Lower values reduce latency but increase bandwidth.
Custom Video Quality Configure bitrate and quality 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-cli publish - https://relay.example.com/anon/stream
H.265/HEVC Encoding Use H.265 for better compression:
ffmpeg -i input.mp4 \ -c:v libx265 -preset ultrafast \ -c:a aac \ -f mpegts - | moq-cli publish - https://relay.example.com/anon/stream
Moq supports multiple media formats:
fMP4 : Fragmented MP4 (CMAF)HLS : HTTP Live Streaming playlistsMPEG-TS : MPEG Transport StreamAnnex B : Raw H.264 bitstreams
Publishing fMP4 ffmpeg -i input.mp4 \ -c copy \ -f mp4 -movflags cmaf+separate_moof+delay_moov+skip_trailer+frag_every_frame \ - | moq-cli publish --url https://relay.example.com/anon --name stream fmp4
Authentication Pass JWT tokens for authenticated relays:
moq-cli publish video.mp4 "https://relay.example.com/room/123?jwt=<token>"
Debugging Enable Verbose Logging RUST_LOG = debug moq-cli publish video.mp4 https://relay.example.com/anon/stream
Check Relay Connection Verify your relay is accessible:
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, you can use insecure HTTP mode
For production, use certificates from LetsEncrypt
Permission Denied
Check your JWT token is valid
Verify the token allows publishing to that path
Ensure the token hasn’t expired
Test Videos The Moq repository includes helper commands for testing:
# Publish Big Buck Bunny just pub bbb https://relay.example.com/anon # Publish Tears of Steel just pub tos https://relay.example.com/anon
Next Steps
Deploy a Relay Set up your own relay server
Web Components Play streams in the browser
GStreamer Use GStreamer for more efficient pipelines
OBS Studio Stream directly from OBS
