Repository navigation
Releases
Higher quality video defaults when used for conferencing
VDO.Ninja has been updated to reflect changing times
People are using VDO.Ninja for conferencing and people have better Internet and more capable phones. This patch addresses
- Rooms can choose to require director approval before guests enter.
- Guest waiting/queue flows are more reliable and easier to manage.
- Podcast recording controls are clearer, with better status and destination indicators.
- PTZ camera control is more complete for remote camera operation.
- Weak-network and large-room reliability has been improved.
- chunked streaming mode has better buffering and recovery options.
- More settings are exposed in the director UI instead of requiring manual URL editing.
Improved podcast studio & Director mesh-debug view
VDO.Ninja v29.0 Release Notes
Changes from v28.4 to v29.0
🎙️ Podcast Studio
A complete podcast production control room available via ?podcast or ?studio=podcast.
- ISO Track Recording — Per-speaker WAV files for clean post-production
- Cloud Sync — Stream chunks to Google Drive or Dropbox during sessions
- Local Disk Recording — File System Access API support (Chromium)
- Spectrogram Visualization — Real-time frequency analysis per track
- Pro Audio Guest Links — Pre-configured stereo 256kbps with AEC/AGC/noise reduction disabled
- Session Markers — Timestamped cue points with CSV export
- Host Input Panel — Director microphone capture with mute controls
- Talent Roster — Live view with audio level meters
- Group Video Recording — One-click popup for combined scene capture
🌐 Meshcast2 Support
New &meshcast2 parameter enables the next-generation Meshcast relay service via app.meshcast.io. Features include:
- Automatic fallback to anonymous relay if token is rejected
- Improved error handling with user-friendly messages for quota limits and origin restrictions
- WHIP/WHEP integration with authenticated accounts
💰 NinjaBacker Tipping Integration
Full tipping system integration with ninjabacker.com:
New Parameters:
&tipsid/&tip/&tips— Enable tipping and set performer ID&receivetips/&tipping— Enable tip receiving&tipserver— Custom tip server URL&tipamounts— Comma-separated tip amount options (default: 5,10,25,50,100)&tipcurrency— Currency code (default: USD)&tipqrsize— QR code size on video overlays¬ipqr— Disable QR code display&showtips/&supporttips— Show tip icons on videos
Features:
- Two-way opt-in system (performer and viewer must both enable)
- Stripe payment processing integration
- Real-time SSE notifications for incoming tips
- QR codes for quick mobile tipping
- Tip overlays in OBS and scene links
🔗 Mesh Network Debug View
Interactive visualization for troubleshooting P2P connections in the director's room. Click the network icon next to room name.
- SVG Graph — Nodes (guests) and edges (connections) with health indicators
- Color Coding — Green (healthy), orange (degraded), red (failed), gray (isolated), purple (viewers/scenes)
- Layout Modes — Circular, grid, force-directed (press button or cycle with keyboard)
- Auto-Patch — One-click mix-minus relay for failed P2P connections
- Unpatch Recovered — Remove patches when connections restore
- Edge Details — Click connections to see stats and manual patch options
- Problems Filter — Toggle to show only problematic connections
- Keyboard Shortcuts —
Rrefresh,Ffilter toggle,Escclose
🎚️ Mixer & Layout Improvements
Auto-Channel Assignment
&autochannels/&autochannel— Automatically assign guests to audio channels&autochannelmode— Control assignment strategy (round-robin, least-used)&preferchannel/&pc— Preferred audio channel for a guest
Slot System Enhancements
&slotmode/&slotsmode— Enable slot assignment mode&maxslots— Set maximum available slots- Slot Picker UI — Color-coded slot assignment from director view
- Dynamic slot color palette with HSL generation
Layout Enhancements
&alignright/&rightalign— Align videos to right side of scene- Improved screenshare spotlight layouts (multiple styles based on participant count)
- Column-based layout for right-aligned mode with automatic slot height calculation
🎛️ Director Features
Mix-Minus Support
&mixminus/&mm— Enable director mix-minus functionality- Per-guest custom audio mix dropdown ("Mix ▾" button)
- Select which audio sources each guest hears
- Director audio inclusion toggle
Channel Isolation
- Ch 1 / Ch 2 buttons — Route guest to left/right audio channel
- Isolate Channel — Send only specific mic channel to guest (requires
&stereo=1)
Guest Queue Improvements
&holdwithvideo/&queue4— Like&holdbut director sees guest video while waiting&approvepopup/&approvalpopup— Show popup notification when guests are held
📹 Recording & Streaming
Record Window Mode
&recordwindow/&rw— Capture current tab and record to disk- Optional bitrate parameter (e.g.,
&rw=6000) - Floating record button for scene windows
- "Go Live" button for direct WHIP streaming
Cloudflare WHIP Support
&cftoken/&cft— Cloudflare Stream integration&whippushtoken/&whipouttoken/&pushwhiptoken— Authentication tokens- Automatic WHIP URL generation per guest
🥽 WebXR & Sensor Data
AR Examples
examples/webxr-ar-sender.html— 6DoF AR video streaming with spatial trackingexamples/webxr-ar-receiver.html— AR stream display
Sensor Bridge
&webxrbridge/&externalsensors/&sensorsbridge— External sensor data input&sensorfilter— Filter sensor types (pos, lin, ori, mag, gyro, acc)&sensorsorigin— Allowed origin for sensor messages
🔧 New URL Parameters
| Parameter | Description |
|---|---|
&meshcast2 |
Use next-gen Meshcast relay |
&altlabel |
Override display label |
&prefervideocodec |
Preferred video codec selection |
&ipv6 |
IPv6 control (0=prefer IPv4, 1=dual-stack) |
&preferipv4 / &ipv4 |
Disable IPv6 when IPv4 available |
&ptzslider / &ptzcontrol |
Show PTZ control sliders |
&ignorehighlight / &ih |
Ignore highlight/spotlight commands |
&pull |
Alias for &view |
🖥️ UI Improvements
- Fullscreen Button — Optional fullscreen toggle on control bar
- Picture-in-Picture Button — PiP toggle on control bar
- PTZ Controls — Enhanced pan/tilt/zoom with reset autofocus
- Remote Hangup/Reload — Context menu options for guests
- Slot Color Picker — Visual slot assignment with color coding
🌍 Translations
- Polish (pl.json) — New language support
- Chinese Simplified (zh-CN.json) — Parenthesis fix
📄 Documentation & Other
- Cloud Sync Guide (
cloud.html) — Google Drive & Dropbox setup instructions - Dropbox Auth Page (
dropbox-auth.html) — Token generation helper - Director Messenger (
director-messenger.html) — Standalone messaging interface - OBS Dock Updates — Improved interface and Chinese locale
- Manifest Updates — PWA improvements with new icons and favicons
- Terms of Service — Updated with QoS provisions
🛠️ Technical Changes
- ~30,000 lines changed in
lib.js - ~1,300 lines changed in
main.js - New modular core recording system (
core/recording/) - Audio metering worklet (
core/audio/meter.worklet.js) - Event bus architecture (
core/events/) - Legacy session bridge for backward compatibility
Full Changelog: v28.4...v29.0
Version 28.4 - CSS fixes, minor new features, xss patch
🧾 VDO.Ninja v28.4 — Release Notes (vs v28.0)
Date: October 2025
Author: Steve Seguin
What’s new since 28.0 (at a glance)
- Operational control & hardening: director/queue approvals, safer desktop wrapper behavior, legal footer, HTTPS/doc fixes.
- Stream routing upgrades: explicit WHIP/WHEP primary/screen routing, better MediaMTX URL construction, token “user-set” guards.
- A/V quality & control: mic panning, frame-grab audio, mirror/flip output flags, speaker-volume panel, new tones.
Highlights
🎛️ Director & Co-Director
- Held-guest approvals for co-directors, optional approval popup, plus force-hold modes (
&forcehold,&forceholdwithvideo). - Director view exposes approval controls automatically when applicable.
🔊 Audio / Video
- Mic panning (publisher-side):
&micpanning/&mpan(0–180) — downmix mono → pan to stereo. - Frame-grab audio:
&framegrabaudio(or&audio) to include/exclude audio with frame-grabs. - Program-feed transforms:
&mirroroutput,&flipoutput. - Speaker volume panel (vertical slider + % readout).
- New tones: keep
testtone; addknocktonefor attention/queue states.
🌐 WHIP/WHEP & MediaMTX
- Primary vs. Screen routing:
&whipprimaryonly,&whipscreenonly,&whipnoscreen. - Parallel flags for meshcast and mediamtx; cleaner MediaMTX URL construction (primary
/whip//whepand screen/_s). - WHEP share source:
&whepshare/&whepsrc+ optional&whepsharetoken. - Token hygiene: “user-set” guards to prevent later params from overwriting explicit tokens.
🖥️ Screen-share / Playback Controls
- Routing & disable options:
&noscreenshare,&screenp2p,&screenwheponly,&screenwhep=true|false. - Explicit allow-overrides for screen video/audio.
- Link hygiene: HTTPS and doc link fixes.
🚦 Chunking & Reconnection *
- Preset chunk profiles:
&chunkprofile=mobile|balanced|desktop(sets FEC/NACK/buffers/jitter/adapt thresholds).- All knobs still overrideable:
&chunkfec,&chunkbufferceil,&chunkadapt=bitrate|framerate|hybrid, etc.
- All knobs still overrideable:
- Faster reconnection recovery: Shorter ICE wait times and targeted restarts minimize visible dropouts.
- Smarter fallback: Flow-guards and cooldowns prevent the system from oscillating between P2P ↔ TURN.
⚙️ Platform-Specific
- Electron app: explicit drag region; interactive elements marked as no-drag (prevents accidental overlay capture).
- Safari/iOS recordings: automatic split segments (iOS ~5 min; desktop Safari ~10 min) to avoid memory-pressure crashes.
🔐 Security & Hardening
- Legal/compliance footer (Terms, Privacy, Abuse) — auto-hidden in embed/kiosk contexts.
- Token handling tightened across WHIP/WHEP/Cloudflare flows with “user-set” guards.
- Safer defaults in embed/mixer/viewer modes (hides credits/legal/controls to reduce surface area).
- Recording stability improvements (segmented recording) mitigate crash-style failure modes.
- **Cleaned up XSS issues in some of the example files
🐞 Minor Fixes & Polish
- Cleaned up
hrefinconsistencies and updated legacy Discord link. - CSS refinements (z-index, modal/alert polish, dark-theme hover states); small overflow/layout improvements.
Quick upgrade tips (examples)
- Enable mic panning (center = 90):
?micpanning=90 - Hold with video + co-director approvals + popup:
?forceholdwithvideo&approvepopup - Publish only screen via MediaMTX:
?mediamtx=example.com:8889&mediamtxscreenonly - Balanced chunk profile with custom ceiling:
?chunkprofile=balanced&chunkbufferceil=2000
Summary:
28.4 doesn’t reinvent 28.0’s feature set—it hardens it. You get tighter token hygiene, safer desktop behavior, clearer legal posture, better director workflows, richer A/V controls, and improved network reconnection. Net effect: more stable, more controllable, more production-friendly.
Version 28 Initial Release
VDO.ninja v28.0 Release Notes
🎯 Major Features & Core Updates
New Pages & Tools
- Clipboard Sharing Tool (
clipboard.html) - P2P clipboard sharing across devices using VDO.Ninja's WebRTC system - Notification System (
/notifications/) - Real-time alerts when users join rooms with&pokeparameter- Browser desktop notifications
- Background service with web push support
- Developer-friendly SSE/polling API endpoints
- Daily heartbeat for subscription persistence
Room & Scene Management
- Auto-join Scenes - New
&joinsceneand&opensceneparameters for automatic scene assignment- Guests can specify which scenes to join via URL
- Directors control scene access with
&openscene - Example:
?room=ROOM&joinscene=2,3 - experimental SSO sign in auth control for director
Connection & Stability
- Improved Reconnection Logic - Enhanced connection recovery mechanisms
- Configurable Timeouts - New
&timeoutsparameter (default 10000ms) - Server Infrastructure - 2-10x connection capacity upgrade for improved scalability
Recording & Integration
- Google Drive Recording - Updated to support latest Google security policies/API changes
- OBS Control Dock (
/obs/) - WebSocket-based OBS integration (#1195)- Auto-add/remove VDO.Ninja sources
- Map streams to specific scenes
- Configurable source sizing (Best Fit, Stretch, Auto Grid)
- Multi-language support
- Fix for OBS v31 iframe crash
📱 Native Apps & SDK
VDO.Ninja SDK (v1.0)
- New JavaScript SDK as alternative to iframe API
- Node.js support added
- WebRTC P2P data channels for serverless apps
- AI-bot friendly implementation
- Available at https://sdk.vdo.ninja/
Android App Updates (v5.0.40+)
- Social Stream Ninja integration with real-time chat display
- Text-to-Speech support for chat messages
- USB camera and audio device support
- Background camera support (Android 14+)
- Picture-in-Picture mode
- Touch-to-focus and exposure control
- Higher bitrates (6-10 Mbps)
iOS App Updates
- Screen sharing support
- Social Stream Ninja integration
- Talk-back audio support
🎨 UI/UX Improvements
Whiteboard Enhancements
- Dark Mode support (black canvas)
- Screen share annotation - Draw on shared screens
PTZ Camera Controls
- New
&ptzsliderparameter for pan/tilt/zoom controls - Mouse wheel controls:
- Wheel: Zoom
- Shift+Wheel: Pan
- Ctrl+Wheel: Focus
- Ctrl+Shift+Wheel: Tilt
- Alt modifier: Fine adjustments
Display & Layout
- Reduced Active Stream size optimization (#1197)
- New
&endpageparameter for post-call redirection &autoendtimer with countdown display- Bandwidth display changed from "Mbps" to "mbps"
🌍 Translations & Internationalization
New & Updated Languages
- Arabic - New translation (#1162) - Thanks @al3bsi!
- Spanish - Complete overhaul (#1182) - Thanks @PGSCOM!
- Chinese - Multiple improvements (#1171, #1186) - Thanks @RabbitJun!
- Turkish - Updates (#1204) - Thanks @yigitgulyurt!
- Italian - Updated translations
Translation System
🐛 Bug Fixes
- OBS v31 iframe crash resolution
- Firefox mixer app compatibility
- Equalizer (
&eq) parameter functionality sstype3streaming issues- Reconnection logic improvements
- JSON formatting in translations
🔧 Developer Tools
API & Integration
- HTTP/WSS API updates for pan/tilt control
- MIDI remote control for PTZ
- Enhanced API sandbox at https://companion.vdo.ninja/
- BitFocus Companion plugin improvements
Raspberry Pi Support (Raspberry.Ninja)
- Automatic room recording with
--record-room - HLS recording support with web server
- NDI output for entire rooms
- Windows WSL compatibility
📚 Documentation
TURN Server
New Resources
- StreamDeck configuration guide
- System requirements calculator (https://calculator.vdo.ninja/)
- Audience link wizard by Edo
🔗 Infrastructure
- vod.ninja now redirects to vdo.ninja
- New file hosting service for media assets
- New Meshcast server in Hong Kong
👥 New Contributors
- @al3bsi - Arabic translation
- @T0biii - Documentation
- @PGSCOM - Spanish translation & timezone features
- @MorseTheCode - OBS integration & UI
- @yigitgulyurt - Turkish translation
🙏 Acknowledgments
Thanks to all contributors, especially @RabbitJun for continuous Chinese improvements and @steveseguin for core development and infrastructure.
Full Changelog: v27.0...v28.0
Version 27.0 Launch Release version
VDO.Ninja v27 Release Notes 🚀
Key Updates Summary ⭐
- 🌐 Enhanced WHIP/WHEP support with improved reliability and compatibility
- 🎮 Expanded device control features including optical zoom and rotation controls
- ✨ New digital effects including chroma key and background removal
- 🏷️ Added comprehensive meta data support for guest information and resources
- 📱 Improved mobile device support with new controls and features
- ✏️ Added whiteboard functionality
- 📲 Released updated native mobile apps for Android and iOS
- 🎥 Custom OBS Studio build with enhanced WHIP support
Detailed Feature List
Streaming and Connectivity
- Enhanced WHIP/WHEP support with automatic reconnect and continuous loading attempts
- Improved support for MediaMTX SFU with polished integration
- Added support for Meshcast v2 servers with enhanced reliability
- Fixed issues with OPUS audio and flickering frame rates
- Improved chunked video streaming mode with dynamic buffers
- Added Discord webhook notifications for unexpected stream disconnections
- Released custom OBS build with improved WHIP support and firewall traversal
Device and Control Features
- Added optical zoom control with
&zoom=200support - Implemented video rotation via right-click menu
- Enhanced digital zoom with vertical/horizontal controls
- Added comprehensive PTZ camera support
- Improved screen sharing interface with simplified audio selection
- Added feedback button for mobile-friendly audio monitoring (
&fbor&feedbackbutton) - Added volume control for audio feedback (
&fb=50for 50% volume)
Visual Effects and Layouts
- Added chroma key removal effects:
- Effect 14: Transparent/black background
- Effect 15: Custom background image
- Implemented page zoom slider for touch devices (
&pagezoom) - Added centered row layout option with negative values (
&rows=1,-2) - Enhanced digital zoom controls with separate vertical/horizontal adjustments
Guest Management and Meta Data
- Added comprehensive meta data system for guests:
- Title/role, social media links, bio, etc
- Profile avatar and QR code support
- Resource sharing between guests and viewers
- Implemented meta data display options with
&showmeta - Added customizable bitrate and resolution controls in director room
Mobile Support
- Released updated Android app (v3) with Android 14 support
- Updated iOS app with improved screen sharing
- Added mobile-friendly audio monitoring controls
- Enhanced mobile device compatibility across features
New Applications
- Introduced whiteboard functionality (vdo.ninja/whiteboard)
- Added IP camera integration support
- Released updated Electron Capture app with enhanced features
Technical Improvements
- Added H.265/HEVC support in Chrome with command line options
- Enhanced iframe API for cross-origin video/image transfer
- Updated website header permissions for improved iframe compatibility
- Improved error handling and messaging
- Enhanced automatic reconnection capabilities
Native Apps and Tools
- Released Android app v3 with USB/UVC/HDMI support
- Updated iOS app with enhanced features
- Released Electron Capture app updates with improved functionality
- Custom OBS build with enhanced WHIP/WHEP support
Note: These release notes were auto-generated using AI
Version 26 Release 🎃
This update is as always long overdue, with mainly some subtle fixes, but it has been available on vdo.ninja/alpha/ in a stable form for a while now.
- MediaMTX SFU support is fairly polished now, so if you want to deploy your own Meshcast-like service, it's easy to do now.
- issues with no OPUS audio, flickering frame rates now and then, and other whep/whip related things addressed.
- Support for Meshcast v2 servers has been added, which is the primary reason for the urgency of update. (Meshcast v1 servers kept freezing up)
- Half the meshcast servers are already v2, and I'll be retiring v1 servers over the next little while.
- meshcast v2 servers have more reliable WHIP/WHEP support, and in general will allow me to offer more media input options into VDO.Ninja
- Quite a few WHIP / WHEP improvements were made in general, including automatic reconnect if a stream fails
- WHEP streams that haven't been publish yet will continuously try to be loaded, every few seconds, rather than just give up and fail
- Chunked video streaming mode supports dynamic buffers, so you can delay VDO.Ninja video output by minutes, with sync accurate down to a few frames.
- this is being used in combo with Ninbot + Sonobus for joint musician play-togethers, which an evolving project that is pushing chunked-mode development forward.
- The director's room has had some audio-channel features added, like a PGM mode.
- Another channel option is to control up to 7.1 channels of recording in OBS, allowing you to record 6 different guests in a group room to 6 different audio channels, which should make post processing audio for interviews or podcasts quite a bit easier
- The VDO.Ninja chat pop out has been redone, as recently mentioned
- Improved error messaging and fixed translations here and there, helping users with common issues to get better support messages
- Picture in Picture full window was fixed, to address a recent chrome change
- &voiceislation supported; this is an advanced noise filtering option in Chromium-based browsers
- Timecode support, enhanced MIDI, and standalone pages for minor tool testing, like TTS, added.
This list of changes is not exhaustive, nor is all the documentation on our Gitbook updated yet. Currently for more details of every new feature added though, see the Discord's updates channel at https://discord.vdo.ninja. It contains the feature descriptions for everything that has been added, but there is a lot to dig thru there.
Version 25.0 launch release
This is not a "stable" release version, but it is what has gone live on production just now. Given that, I will mark it as a pre-release version for now.
New major production releases like this often will have bugs for the first three weeks. You may find using the develop branch, with its nightly updates, to be the better branch to use until a stable version is available, or using a past stable version. This version has undergone incremental testing on the alpha-hosted version of VDO.Ninja for the past three months without serious issue.
IN THIS RELEASE
- major improvements to &chunked mode
- &viewslot=N
- &ln=auto
- &q=4k added
- higher default bitrates for 1080p
- a lot more.
Thank you.
~ management
Version 24.4 Stable Release
This is a stable version of VDO.Ninja that was running as the official production release from late 2023 to March 29th 2024.
There are a few non-critical bugs in this release, but it has been well tested on production and hot-patched as needed.
This branched version may obtain critical hot patches on request, however development will continue on v25 going forward.
Version v23.5 stable release
Version 23.5 of VDO.Ninja has now been in production for over a month, and most of the bugs in it have now been worked out. This is the formal 'stable' release of v23 for now, which will pave the way to v24 beginning at some point in the future.
For the v23 release notes, see here: https://docs.vdo.ninja/releases/v23
Some quick highlights:
-
The Mixer App has been improved, including with the option to sync OBS scenes to Mixer layouts
-
Connection stats has new features and important fixes to the candidate type stat
-
A refresh to the UI, with a large contribution from Lindenkron there
-
Chunked mode improvements and options to dynamically change the buffer have been added
-
Initial WHIP/WHEP support added, including a test page at https://vdo.ninja/whip
For version v23, a big shout out to JK14, Leb, Lindenkron and all those who have contributed both in code, time, and gifts. Thank you.
(notice: The last stable update for v23 is v23.8, on production for a couple months: https://github.com/steveseguin/vdo.ninja/tree/v23.8.stable)
Version 22.9 stable (Released November 2022)
This version I believe has been stable on production for a couple months now, since mid-November, with critical bug fixes applied.
Release Notes:
https://docs.vdo.ninja/releases/v22
Download:
https://github.com/steveseguin/vdo.ninja/archive/refs/heads/v22.9.stable.zip
What's in the develop (main) branch will have newer features, but will likely be less stable.