OBS Plugin for VDO.Ninja

Direct WebRTC in OBS

Direct low-latency OBS publishing to VDO.Ninja

Native OBS streaming service for OBS -> audience and OBS -> OBS contribution without running your own media server. Optional source ingest and room-based inbound feeds are available when needed.

Download Latest Release View Repository

Quick Start

1. Confirm plugin loaded
Check Settings -> Stream for VDO.Ninja and Tools -> VDO.Ninja Studio.
2. Configure OBS
Use VDO.Ninja Studio for basic stream setup. Configure signaling, salt, ICE/TURN, and packet protection under Settings -> Stream.
3. Go live
With default settings, use OBS Start Streaming or Studio Go Live (same stream pipeline). After configuring advanced service options, use OBS Start Streaming. Then open ?view=StreamID (or add &room=RoomID&solo).

Core URLs

Publish 
https://vdo.ninja/?push=MyStreamID&password=MyPass
View 
https://vdo.ninja/?view=MyStreamID&password=MyPass
Room solo source 
https://vdo.ninja/?view=StreamID&solo&room=RoomID
Docs home 
https://steveseguin.github.io/ninja-obs-plugin/

Transparent Avatars and Alpha Video

Transparency in OBS uses the plugin's native receiver plus a compatible dual-track VP9 alpha publisher. The tested path is Spout2 from an avatar or graphics app into Game Capture, then VDO.Ninja into OBS.

1. Publish from Game Capture
Enable Spout2 output in the avatar app, choose Spout2 (avatar apps) in Game Capture, select VP9, and enable the OBS alpha workflow.
2. Receive in OBS
Add VDO.Ninja Source, enter the matching stream ID/password, and enable Use Native Receiver (Experimental).

Browser Sources and normal browser viewers receive standard color video, not composited alpha. VP9 alpha can be CPU-heavy, so lower Game Capture resolution or FPS if load is high.

Docs and Support

FAQ

  • Does Go Live do anything different from Start Streaming? No. They trigger the same OBS stream output pipeline.
  • Can I publish to VDO.Ninja and another stream destination at the same time? Not with this plugin path alone. It uses the active OBS stream output slot as a single destination.
  • Which packet-protection mode should I use? Start with Off; automatic NACK repair still works. Try Low only after the media bitrate fits the route, then use Medium or High only with measured loss and enough spare upload for the added traffic. See the advanced reference.
  • Where are Linux/macOS install steps? Use the install guide links above, or open INSTALL.md.