> For the complete documentation index, see [llms.txt](https://docs.vdo.ninja/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vdo.ninja/steves-helper-apps/ninja-obs-plugin.md).

# Ninja OBS Plugin

The Ninja OBS Plugin adds native VDO.Ninja publishing and receiving tools to OBS Studio. It is useful when you want a more integrated OBS workflow than opening a separate browser publisher or Browser Source.

## Link

* <https://steveseguin.github.io/ninja-obs-plugin/>

## Key features

* publish live from OBS directly to VDO.Ninja
* receive a VDO.Ninja stream as a **VDO.Ninja Source**
* multi-viewer support
* peer-to-peer publishing model
* open-source plugin
* support for OBS v32 systems, including Windows, macOS, and Linux
* can auto-add room participants into OBS as browser sources
* experimental native VP9/H.264/Opus receiver with dual-track VP9 alpha support

## Receive transparent Game Capture video

The tested transparent workflow uses a Spout2 avatar or graphics source in [Game Capture](/steves-helper-apps/game-capture.md), VDO.Ninja for transport, and the plugin's native receiver in OBS:

1. In Game Capture, choose **Spout2 (avatar apps)** and select the sender.
2. Choose **VP9 (OBS Alpha Preview, auto fallback)** and enable the alpha workflow.
3. Publish with a stream ID or room workflow.
4. In OBS, add a **VDO.Ninja Source**, enter the matching stream details, and enable **Use Native Receiver (Experimental)**.

OBS Browser Sources and normal browser viewers receive the standard color track but do not composite the separate alpha track. If software VP9 is too CPU-heavy, use Game Capture's H.264/NVENC **Chroma background** workflow and apply a chroma-key filter in OBS instead.

See [Using Game Capture and Spout2 with VDO.Ninja](/guides/using-game-capture-with-vdo.ninja.md) for the complete sender setup and troubleshooting flow.

## Notes

* positioned as a simpler publishing workflow than relying on a separate browser publisher
* useful for non-Windows users who want an OBS-native publishing workflow, since the standalone Game Capture app is currently Windows-only
* **Use Native Receiver (Experimental)** is required for the dual-track VP9 alpha workflow


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.vdo.ninja/steves-helper-apps/ninja-obs-plugin.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.