Misc options
Platform Specific Issues
Newly Added Parameters

v16

New Queueing System 🕟

Made a feature for Queuing up users in a green room. Makes the process easy and relatively more secure than how I see others currently doing it.

Activate it by adding &queue to the URL for both the director and the guests.

Such as, https://obs.ninja?director=xxxx&queue and https://obs.ninja/?room=xxxx&queue

There will be a new button added to the director's view, which when pressed, loads a guest into the director's room. The guest will be able to see the director and only the director then. The director can add more guests this way, kicking out those they don't want, and continue to cycle thru the queue of guests as they join the room. The director can then Transfer the guest(s) to another room, and when transferred, the guests are no longer considered in 'a queue' and will be able to see everyone in that new room, and vice versa.

Global Hotkey Support via MIDI controllers 🎹

Added Global hotkey support via MIDI input. This is an experimental first draft of the hotkey specification and will see continued development and tweaking.

You can enable the MIDI hotkey support by adding &midi to the URL. For different key layouts, you can pass 1 or 2 or 3 (etc) as a value to the &midi parameter.

For reference at this time, available sets are:

midi=1

MIDI message

Function

Note G3

Toggle Chat

Note A3

Toggle Mute

Note B3

Toggle Video Output

Note C4

Toggle Screen Share

Note D4

Hang up

Note E4

Raise Hand Toggle

Note F4

Record Local Video Toggle

Note G4

Enable the Director’s audio [director only]

Note A4

Stop the Director’s Audio [director only]

midi=2

MIDI message

Function

Note G1

Toggle Chat

Note A1

Toggle Mute

Note B1

Toggle Video Output

Note C2

Toggle Screen Share

Note D2

Hang up

Note E2

Raise Hand Toggle

Note F2

Record Local Video Toggle

Note G2

Enable the Director’s audio [director only]

Note A2

Stop the Director’s Audio [director only]

midi=3

MIDI message

Function

Note C1 + Velocity 0

Toggle Chat

Note C1 + Velocity 1

Toggle Mute

Note C1 + Velocity 2

Toggle Video Output

Note C1 + Velocity 3

Toggle Screen Share

Note C1 + Velocity 4

Hang up

Note C1 + Velocity 5

Raise Hand Toggle

Note C1 + Velocity 6

Record Local Video Toggle

Note C1 + Velocity 7

Enable the Director’s audio [director only]

Note C1 + Velocity 8

Stop the Director’s Audio [director only]

midi=4, control change-based

MIDI message

Function

Command = 110

with values accepted from 0 to 8 for local toggle options.

Command = 110+N

where N is the guest’s order in the control room.

In this case, for hotkeying remote guests as a director:

MIDI message

Function

Value 0

Opens the Transfer Popup

Value 1

Add/remove from scene

Value 2

Mute guest in scene

Value 3

Mute guest everyone

Value 4

Hangup the guest

Value 5

Toggle Solo Chat with this guest

All the above hotkey mappings are purely experimental at this time and will change based on user feedback. These mappings should allow a user to use a StreamDeck with OBS.Ninja.

Screen sharing updates 💻

When stopping screen share, it will now default back to the previous video device, if there was one.

When screen sharing as a guest in a group room, the screen share will now create a second stream for the screen share, keeping your webcam also. Stopping the screen share removes the video. The director will see the stream appear as a new source with a new stream ID.

Screen sharing reuses the first bit of the parent's stream ID, to help directors identify who they belong to.

You can use &ssid=XXXXX or &screenshareid=XXXX to specify a screen share stream ID ahead of time. (if you don't use it, one will be generated for you, as mentioned above)

The previous method of switching video sources to that of a screen share ( rather than adding a new stream) is accessible still via the Settings menu under video sources. This will still be the default screen sharing behaviour if not in a group room.

UI/UX ☑

  • iOS devices will no longer auto-capitalize room and password fields

  • If I detect the site is within an IFRAME, I now hide the info-button, the report-error button, and I clear the chat's welcome message. This also applies to obfuscated links via invite.cam and the rtc.ninja debranded website.

  • If a guest mutes, it shows a little mute icon to signify that; appears for both guests and the director.

  • The method of joining a room via the top-left input field will now ask for a password (optional).

  • Asks for camera permissions now when you open the settings menu and no previous permissions were granted.

  • TEST audio button works with rtc.ninja and with Firefox now

  • Added some warning symbols to the more dangerous toggles ⚠

  • Updated language files to be more comprehensive. Removed the mention of macOS v23 from all language files and several language translations were improved by community contributions.

  • Added a workaround for a bug with iOS devices where the video bitrate wouldn’t increase in some cases, when told to do so.

  • Chrome on iOS 14.3 now works I think, and this option should be available without any error popup now.

  • Improved the way I try to deal with a Google Pixel video glitch.

  • I am hiding the mouse cursor when it's over the QR code now. The mouse cursor was sometimes in the way.

  • Improved the stats page UI; it is now a bit more explicit about details and issues.

  • Users who do not have access to the control room will get an error message in the header; no longer just a popup.

  • When playing with sliders, I provide as an on-hover popup the initial setting’s value. I do not have access to the actual default values, but hopefully this helps a bit with undoing changes.

  • Fixed a bug where 7 videos on screen sometimes broke the auto mixer

  • Channel Count is now hidden as a dynamic GUI setting. It was just too confusing for most users.

  • The recording function now adds your stream ID or label value as a prefix to the file recordings. It is still followed by the timestamp.

Optimizations 📈

  • If using macOS with OBS, h264 is the default video codec used. You can still manually set a different one, but this should help improve performance for macOS users.

  • The resolution of videos in a group room or scene layout will scale down dynamically to match their container sizes exactly. While something akin to this already took place for guests, this logic has been improved and extended to even the OSB scenes. This should reduce the CPU load on both OBS and users in large group rooms. It will not impact things greatly if using Solo view links within OBS though.

  • You can disable this dynamic resolution control by setting &scale=0 (no scripted scaling at all) or manually specifying another scale value.

  • &portrait ( or &916 or &vertical) will optimize the auto-mixer to work with video streams that are in portrait mode (versus landscape). Until I can make the mixing logic smarter, hoping this helps.

  • Added more DoS prevention logic and a bit of load balancing.

  • &dir is an alias of &director now

  • The last traces of JQuery have been removed. 🎆 🥳 The webapp loads abouts 15-percent faster now.

  • Increased the default 'starting' bitrate for inactive videos in manual scenes to 400-kbps. (up from 200-kbps).

  • Only the 3 closest TURN servers are accessed now (based on the user’s timezone). This logic is needed to help OBS.Ninja scale up to support more TURN servers and to ensure users use an appropriate TURN server if required.

  • Modified the iOS guest logic a bit; the first couple guests in a room will get 2.5x higher bitrates from remote iOS devices. (3fps vs 1fps). I don't suggest trying to make rooms larger than 7 or 8 people with an iPhone 11 in it, unless you disable their video output. Hopefully this logic improves the experience for 1:1 guest calls without breaking things too much for older iPhones.

New features 🆕

  • &channelcount=N (or &ac=N) tells the audio capture device explicitly to select N-number of audio channels. This shouldn’t be needed often, but may help with debugging or advanced use canses. Setting &stereo=0 will set &channecount=1 by default.

  • Added the &speakermute, (&mutespeaker, &ms, &sm) parameter. Sets the speaker to be muted by default for a guest.

  • Added &chatbutton={ 1 | 0 | true | false }, aka &chat or &cb. Shows the chat button or hides the chat button. You can use this on view links I guess, if you happen to want chat with view-only links. Or if you want to hide chat for some reason, like with push only links.

  • I have hosted a fully-isolated version of OBS.Ninja in Hong Kong (AWS) ; I'm trying to see if I can expand access into mainland china. We'll see if it works or not. It uses 'compromised' TLS encryption, so to reflect this, I named it: https://insecure.cam/

  • Added the ability to send custom commands to the IFRAME; not just what has been pre-configured. This uses post-messaging + eval. Not sure I see a huge problem with this, but I'll revisit as needed. This gives IFRAME developers full control to do whatever they want, even if CORS blocks their creativity. Sample button of it working on beta: https://obs.ninja/iframe

  • Added 'beep' noises as an optional URL flag for raised-hand and chat messages. &beep or &notify or &tone or &r2d2.

  • Added &showdirector, which lets scenes see a director's feed. (add to the director's URL to enable for everyone).

  • Added the ability via a button for the Director to SOLO talk with a guest. The director must enable their microphone first before using.

  • Made the option to be a performer+director as a checkbox

  • Ability to blind and deafen guests 🙈 🙉

  • The gain can now be set to 0 to 200 (instead of 1 to 100). It also has a visual value indicator now, so setting it exactly is easier.

  • Add a low-cut filter by adding &lowcut=100 The value passed is the cut off frequency and defaults to 100. This can help reduce background hum or fan noise.