Generate Cloudflare Auth for VDO.Ninja









What you can do with Cloudflare + VDO.Ninja?

Restream VDO.Ninja as an RTMP Output

Live Video Inputs (Cloudflare feature) can be set up to forward any input to another input. This can be a RTMP(S) service such as YouTube, Twitch or Facebook Live.

In theory you could publish from VDO.Ninja WHIP output to Cloudstream, and then to your RTMP destinations, like Youtube.

Meshcast-alternative

Instead of using Meshcast to broadcast video from director to guest, or guest to scene, you can use Cloudflare instead.

Meshcast, or any compatible WHIP/WHEP service, can help reduce CPU and network load of guests by offloading distribution to a server, compared to using the peer-to-peer default of VDO.Ninja

Automatic isolated guest recording

Cloudflare will automatically record incoming videos, allowing you (in theory) to have a backup of each guest in a room.

This offers a redundant backup for your recordings, but also makes it easier to do higher quality VODs edits after the live ends.

SRT, HLS, DASH, MP4, WHIP/WHEP options

Lots input and output options, although if you're here, you're probably interested in the WHIP/WHEP mainly.

VDO.Ninja is compatible with WHEP and WHIP!

Very competitive pricing

There's a $5 entry tier, which is more than enough for testing.

Or pay $1 per 1000 minutes of streaming.

How it works?

When used with VDO.Ninja, video is published to Cloudflare via WHIP, and the WHEP playback URL is distributed to viewers. Unless otherwise specified, viewers will use the WHEP URL as the source of media from the publisher, instead of using the normal peer-to-peer mode. This has the effect of reducing the CPU and network load when sharing media with multiple videos, as instead of distributing media via peer-to-peer, the media is distributed via a server. This approach does have some downsides also, so its not normally advisable unless desired or needed.

Why do I need a special URL parameter?

The reason we need a special generated URL parameter is because Cloudflare requires user accounts, unlike Meshcast. While you can generate WHIP URLs within your Cloudflare dashboard, and use them on VDO.Ninja links using &whipout, you'd need to create one per guest. Instead here, we're using our Cloudflare credentials to automatically create unique WHIP ingest URLs on demand for each guest, so you can get away with one-invite link for all your guests.

Since it's not advisable to share your Cloudflare credentials, particularly with random guests, this page will encrypt your credentials into URL-friendly parameter. Only the VDO.Ninja servers knows the decryption key, which limits what guest can do with the encrypted key. You can delete or restrict the credentials provided to VDO.Ninja from your Cloudflare dashboard, allowing you to limit or revoke any trust provided to VDO.Ninja.

Where to get my Cloudflare account ID and token?

The Cloudflare account ID can be found on the right-hand side of the Workers & Pages (Overview) page, or it can be found on the right-lower side of any of your Website (domain) overview pages.

As for the API token, you'll need to create it, with limited permissions.

You should now have access to both access token and account ID.

Can I self-host or hard-code my Cloudflare credentials?

Yes, the code is open-sourced and it can be self-hosted, however please be aware there is limited support for those self-hosting.

Does VDO.Ninja track me or store my private information?

Please refer to the privacy policy, although the short answer is no. I can't say the same for Cloudflare, so please refer to their terms of service.