Setup VDO.Ninja to be a WHIP-ingestion end-point (OBS → VDO)

💡 Copy this endpoint URL into OBS: https://whip.vdo.ninja ..and don't forget to also copy over your stream token.

WHIP endpoint URL: https://whip.vdo.ninja

Your stream token must be unique. Only one person can publish to a token at a time.

For our recommend OBS WHIP encoding settings, for smooth playback, see this guide.

You have to first start VDO.Ninja (GO button) before starting your OBS stream.

Important: Only ONE viewer can connect directly to an OBS WHIP stream.

Need multiple viewers? Use meshcast.io or deploy your own MediaMTX server.

Can't publish WHIP via OBS outside your LAN? Download our patched OBS version [source]

More information and options

For more WHIP/WHEP options, tools, services, and documentation, please see: https://docs.vdo.ninja/steves-helper-apps/whip-and-whep-tooling

For community support

For support, join our Discord server here.

About WHIP/WHEP Integration Options

There are three main ways to publish using WHIP from VDO.Ninja:

MediaMTX self-hosted server: Add &mediamtx=yourserver.com to any VDO.Ninja URL
Meshcast managed service: Add &meshcast to any VDO.Ninja URL
Other WHIP/WHEP services: Using &whipout, which is what this page tends to use

You can of course also playback videos into VDO.Ninja from WHIP/WHEP clients and servers.

Using MediaMTX

MediaMTX is a self-hosted SFU that supports WHIP/WHEP:

Works with VDO.Ninja group rooms and other features, just like Meshcast
Custom port can be set, making port forwarding on a router easy
Ultilizing it with VDO.Ninja is as easy as using Meshcast: &mediamtx=yourserver.com:port
Find setup instructions in our MediaMTX guide

Using Meshcast.io

Meshcast.io offers a managed WHIP/WHEP service:

Free service with servers in US, Canada, and Europe
Just add &meshcast to any VDO.Ninja URL
No setup required - auto-connects to nearest server
Supports up to 100 viewers
Perfect for quick setups and small broadcasts

Note: Meshcast.io service is provided on a best-effort basis.

Direct WHIP/WHEP Publishing

This page provides a simple client for direct WHIP/WHEP streaming:

Easily tweak and change advanced WebRTC streaming settings
Publish from the VDO.Ninja mixer or whiteboard directly to Twitch or WHIP service
Peer-to-Peer WHIP playback allows for server-free OBS to OBS streaming
Host VDO.Ninja streams as WHEP sources or view WHEP sources

Troubleshooting

Common solutions for connection issues:

Verify network and firewall settings
If publishing with OBS to VDO.Ninja, ensure a compatible OBS version is used.
Check MediaMTX server accessibility and SSL requirements
For H265 support, check browser compatibility
WHIP is one to one, so publishing from OBS to VDO.Ninja directly, without an SFU, will only allow one viewer at a time

About VDO.Ninja

VDO.Ninja is a free, open-source platform for live video production that supports multiple ways to integrate WHIP/WHEP streaming:

It's easy to switch from peer to peer to server-based broadcasting with MediaMTX and Meshcast
Direct WHIP/WHEP publishing capabilities lowers latency and costs
Group room functionality for multi-user broadcasts and stream management
Mobile device support, with browser-based and native app options

Open Source

Both VDO.Ninja and this WHIP/WHEP client are open-source:

VDO.Ninja: https://github.com/steveseguin/vdoninja
WHIP/WHEP Client: https://github.com/steveseguin/vdo.ninja/blob/develop/whip.html

Publish a video from VDO.Ninja to a WHIP ingestion end-point

Advanced options

Setup VDO.Ninja to be a WHIP-ingestion end-point (OBS → VDO)

Publish your camera or screen directly to Twitch channel using VDO.Ninja

Special Publishing Tools with Twitch support:

Interactive Whiteboard

IP Camera Publisher

Multi-Guest Mixer

Play a remote video stream available via WHEP