obs-moq

obs-moq is an OBS Studio plugin that enables streaming via the Media over QUIC (MoQ) protocol. This plugin allows you to publish live audio and video streams to a MoQ relay or server directly from OBS.

Features

• Protocol: Media over QUIC (MoQ)
• Video Codecs: H.264, HEVC (H.265), AV1
• Audio Codecs: AAC, Opus
• Low Latency: Leverages QUIC for efficient and low-latency media transport.

Installation

Setup

Prerequisites:

• CMake 3.20+
• C++ Compiler (Clang/GCC/MSVC)
• OBS Studio development libraries (libobs)
• Fork of OBS-Studio just to show MoQ in the UI.

1. Clone the repos:

   git clone https://github.com/moq-dev/obs.git moq-obs
   git clone https://github.com/brianmed/obs-studio.git obs-studio
   
   # optional: for local moq development
   git clone https://github.com/moq-dev/moq.git moq

2. Build the OBS fork:

   cd obs-studio
   
   # Replace with your platform
   cmake --preset macos
   cmake --build --preset macos

3. Configure the plugin:

   cd moq-obs
   
   just setup
   
   # optional: for local moq development
   just setup ../moq

Build

1. Build the plugin:

   just build

2. Copy the plugin to the OBS Studio plugins directory:

# macOS
cp -a build_macos/RelWithDebInfo/obs-moq.plugin ../obs-studio/build_macos/frontend/RelWithDebInfo/OBS.app/Contents/PlugIns/

# Linux
cp build_x86_64/obs-moq.so ~/.config/obs-studio/plugins/obs-moq/bin/64bit/obs-moq.so

# eventually, without the fork:
cp -a build_macos/RelWithDebInfo/obs-moq.plugin ~/Library/Application\ Support/obs-studio/plugins/

3. Run OBS Studio with some extra logging for debugging.

# macOS
RUST_LOG=debug RUST_BACKTRACE=1 OBS_LOG_LEVEL=debug ../obs-studio/build_macos/frontend/RelWithDebInfo/OBS.app/Contents/MacOS/OBS

Configuring MoQ Output Streaming

1. Open OBS Studio.
2. Go to Settings > Stream.
3. In the Service dropdown, select MoQ.
4. Enter your MoQ Server details:
   • For development (just dev): http://localhost:4443/anon.
   • For testing: https://cdn.moq.dev/anon.
5. Enter the broadcast name/path:
   • For testing: obs or some unique string.
   • Watch it here: https://moq.dev/watch/?name=obs
6. Configure your Output settings (Codecs, Bitrate) as desired.
   • Currently, only: h264 and aac are supported.
7. Start Streaming!

Manual MoQ Output Streaming Configuration

For configuring via a file, prior to launching OBS you can add this to your OBS Profile directory (eg: "Untitled"):

# Linux
$ cat ~/.config/obs-studio/basic/profiles/Untitled/service.json

# MacOS
$ cat ~/Library/Application\ Support/obs-studio/basic/profiles/Untitled/service.json

{
  "type": "moq_service",
  "settings": {
    "server": "http://localhost:4443/",
    "use_auth": false,
    "bwtest": false,
    "service": "MoQ",
    "key": "anon/bbb"
  }
}

MoQ Source (experimental)

1. Open OBS Studio
2. Goto Sources > (right-click) MoQ Source
3. Enter your MoQ Server details, eg:
   • For development (just dev): http://localhost:4443/anon.
4. Enter the broadcast name/path:
   • For development: bbb.
5. Click OK

Supported Build Environments

Platform	Tool
Windows	Visual Studio 17 2022
macOS	Xcode 16.0
Windows, macOS	CMake 3.30.5
Ubuntu 24.04	CMake 3.28.3
Ubuntu 24.04	ninja-build
Ubuntu 24.04	pkg-config
Ubuntu 24.04	build-essential

License

See the LICENSE file for details.