r/OBSNinja • • Jun 22 '20

Guide Created a "Dock" for OBS; helps you generate OBS.Ninja invite links directly in OBS

65 Upvotes

Hey guys,

As per a user request, I've created a dock for OBS that lets you generate OBS.Ninja invite/view links from within OBS directly. The width needed for the dock is 300px; you can tab away from it when not in use.

The customization settings are pretty basic currently, though I'll be able to remotely update this dock/widget as I get more user feedback.

To use this dock, just add the following link to the OBS Custom Dock: https://obs.ninja/dock

When you generate a link, you can just drag and drop it into the Sources dock to have it auto load the feed. Send the Invite link to your guest and when they connect, they should just pop up into OBS, ready to go.

Please don't forget to enable "Control Audio from OBS" in the browser source settings though, if you wish to also capture audio.

Anyways, I'm also working on getting the next release ready; passwords, etc are coming. Check out https://obs.ninja/beta to check out some of the features before they launch.

Regards,

-steve


r/OBSNinja • • Mar 26 '21

Informative Two new Open Source companion tools: OBS.Ninja Trampoline & Vingester

58 Upvotes

I really like OBS.Ninja, but had two major pain points. For both of them I've created two new Open Source tools for myself, which perhaps are also useful to others. So, let me share them with you here.

First, OBS.Ninja has tons of cool parameters. That's great for configuring OBS.Ninja in various scenarios, but it's nasty if you just want to create intuitive, short and stable URLs for the participating parties. My first tool, OBS.Ninja Trampoline, allows you to fill out a simple form and generates a more intuitive and stable URL which can redirect to the underlying complex technical URL of OBS.Ninja. It especially allows you to control OBS.Ninja parameters at a central place while being able to use clean, intuitive and stable URLs for both the presenters and the consuming OBS Studio in video production. The tool itself is just a simple file and can be either used via the central Github Pages URL or self-hosted in order to change the parameter mapping. If you don't self-host it, you at least have to accept my opinionated set of OBS.Ninja parameters in the tool.

Second, OBS.Ninja used directly in Browser Sources of OBS Studio works for me just for up to 3-4 participants. For more participants, the performance drops down and as a side-effect I regularly get video and audio quality drops. The ElectronCapture utility can help here, but IMHO it is not sophisticated enough. Especially, I wanted full control of the window positioning and also optional NDI support. Hence, I've developed another Electron desktop application, Vingester, which now allows me to run multiple Chromium-based Web browser instances and ingesting the OBS.Ninja receiver sessions as either screen/window-captured or NDI-multicasted video streams into OBS Studio.


r/OBSNinja • • Jan 13 '21

News Version 15 of OBS.Ninja is now Released

52 Upvotes

Version 15 is mainly a feature-release update, with quite a bit of focus on the director's control room and miscellaneous production tooling. ๐Ÿš€

If there are issues, please report them. Feedback is welcomed. If v15 does not work for you, you can access the previous version at https://obs.ninja/v14 ๐Ÿ’

๐Ÿ›ธ New features at a glance

  • Native macOS support available now

  • Local recording added, along with audio-only PCM options

  • Live Transcription, including closed-caption overlays

  • UI/UX updates and a revamped Director's page

  • Numerous new parameters

  • Remote access to Gyroscopic, accelerometer, and magnetometer data for VR.

And a video walk-thru of v15 is here https://www.youtube.com/watch?v=IyGycbNCzg8

(If I look exhausted in the video, it is because I was)

Native macOS Support ๐Ÿคฉ๐Ÿคฉ๐Ÿคฉ

  • OBS.Ninja is now natively supported by OBS on macOS. Update to v26.1.2 on macOS to access!

  • No longer do you need the Electron Capture app.

  • Remember to click "Control audio via OBS" to capture audio in OBS browser source

  • Note: OBS on macOS only supports h264 hardware decoding currently; to avoid high CPU usage, consider appending &codec=h264 to your OBS scene/view links.

Local recording ๐Ÿ“ผ

  • Remote control local-media recording as been added to the Director's room as an option -- experimental, but a great way to record remote guests for post-processing. (guest will need to upload the record file manually after the recording is stopped)

  • The &record flag is available now, which lets a guest record their own video by providing a RECORD button ๐Ÿ”ด to their control bar.

  • The default recording bitrate is 6000-kbps /w 130-kbps OPUS audio, but it can be set by the director remotely or passed as a value to &record=NNN

  • Setting the recording bitrate to 0 will enable Audio-only 32-bit PCM recording (webM container); negative values will record OPUS audio (no video). ๐ŸŽค

  • Supports Chrome, Firefox, Android, but not yet Safari.

  • https://obs.ninja/convert has been created to allow for quick conversion of WebM container formats to other formats, such as MP4 or WAV. Attempts to also support videos with variable resolutions. ๐Ÿ”จ

Transcription ๐Ÿ“‹

  • Transcription /w Closed Captioning overlay has been added, although experimental. Uses default system mic as a source and cannot be muted.

    • &transcribe=en-US (or just &trans; added to the publisher)

    • &cc (will display the incoming text)

    • Won't work with Safari.

    • &fontsize=100 can let you set font-size of the closed captions

UI/UX

  • When creating a room, recommendations on room name selection and password usage is now offered.

  • Audio network connection logic has been enhanced some more; addressing potential audio connection issues.

  • Buttons when muted/disabled turn RED; versus just remain grey. Lots of related UI/UX fixes like this.

  • If you leave &push blank, it will auto assign a relatively secure stream ID for you now, automatically.

  • &fontsize=100 applies also to the &label / &showlabel font-size.

  • Safari 14 on iOS will no longer ask for mic permissions if JUST viewing a webRTC stream.

  • improvements made to the stats debug window (CTRL + LeftClick). More readable, hints for stereo provided, etc.

  • a guest of a room can no longer access the audio/video advanced settings, such as echo-cancellation. Only the Director can.

  • iOS devices now support &proaudio for the purpose of high quality audio playback on iOS.

  • The control bar can be dragged around on desktop. I prefer this over making videos smaller.

  • Support for non-Latin characters are supported now with custom guest labels, text messages, and with CC/transcriptions. Including emojis! ๐Ÿ˜Š ๐Ÿ˜Š ๐Ÿ˜Š

Director page

  • The Director can now STOP audio/video publishing after they have started it; screen share also now available for Directors.

  • Director can dynamically edit/add a label for a remote guest in the control room

  • Link obfuscation is available as a toggle now in the Director's room and create-reusable invite link page (uses invite.cam as a domain, so invite links look pretty professional)

  • Director's room has been stylized; invite and scene link options have been consolidated a bit.

Other New parameters

  • &mono flag added. Lets a viewer force mono even if the &proaudio flag is set.

  • &cleanish flag is added; same as &clean, except shows the playbutton

  • more short-code aliases for common URL Parameters have been created.

  • &order=N is a new parameter; let's you sort/reorder videos in a scene based on their ordered priority. Also dynamically controllable by the Director

More device data available

  • Gyroscopic, accelerometer, magnetometer data is accessible now. Enable with &sensor=30 (30hz). Results show up in the remote stats log or the remote IFRAME API. Useful for VR live streaming support, where you want to capture a smartphone's movement, as well as video.

Thank you

Thank you for the bug reports, testing, user feedback, and consideration. People are very considerate with the feedback and suggestions. I know I don't have 100% supported coverage or desired functionality yet, but your patience and support has been deeply welcomed.

A great thank you to the Sponsors of the project; โค the donations I've received have really taken the stress out of the cost-of-operations of providing the service for free. Thank you. A list of sponsors can be found on Discord or on Github: https://github.com/sponsors/steveseguin#sponsors For those who have donated via Paypal or BMAC, thank you very much as well. Every email notification of a new donation is highly motivating. ๐Ÿ––

Thank you also to Fluffy, Jcalado, and the many others for supporting and helping me manage issues, promote the service, and support users when I am sleeping.


r/OBSNinja • • Jun 01 '21

Important Version 18 released, along with new name.

49 Upvotes

๐Ÿ’ฅ Hey all! Steve here.

So, Version 18 has fully launched now. This release has lots of requested quality-of-life improvements for room directors, along with added performance enhancements, such even better iPhone video call quality. The official release notes for Version 18 can be found here: https://docs.obs.ninja/release-notes/v18, but I've also paste them below.

Also, you might have noticed by now that we have renamed the service to VDO.Ninja, which better reflects the diverse userbase of the service. Everything else is staying the same, including that it's staying 100% free. Your existing OBS.Ninja links will still work fine also, but please consider switching over to the new domain when possible; https://vdo.ninja. This naming transition will take a few weeks to fully complete, so thank you for your understanding along the way. ๐Ÿ‘Œ

I've created a new Subreddit also, https://www.reddit.com/r/VDONinja, which I'll be transition over to as well.

Version 18 features: ๐Ÿ‘€

.. Please report any issues or bugs you find.

Director-related features

  • Added a "share website" button to the director's room. In broadcast mode, it will show the website full-screen, and revert back to the webcam once the website is taken down. You do not need to share your mic/cam to start screen sharing.

  • Double clicking on the volume slider for a guest will set the gain to 100

  • Director can now list and change audio/video devices remotely, including speaker output of remote guests. Guests will be prompted to Accept the change-request though, for privacy reasons.

  • Fixed an issue where the director's audio wouldn't be audible if already sharing a website with the room.

  • Fixed an issue where sharing a website as a director showed up in the scene

  • Added a new button to the director's room that lets the director to dynamically change the Total Room Bitrate with a slider. Higher the quality, the more stress the guests and director will face. It will likely need some tweaking.

  • You can use custom-scene names now, instead of just 0 to 8, and the buttons for these scenes will auto-appear if it detects the scene is available

  • When you refresh the director's room, your toggle-settings at the top are kept and restored, so you can refresh the director's room without losing your settings. Creating a new room (via the main page) will clear those saved settings though.

  • Added support for &quality, &framerate, &maxframerate, and width/height for the Director. Default resolution is now 720p30 f

  • Added &directorchat ( &dc ) , which will cause chat messages to go to ONLY the director.

  • Added icons for video mute and raised-hands to the director's room.

  • Added a few more toggles for scenes; portrait mode, chroma-green, 'fit video to area'.

  • Improved the blind-feature (added a backup-blinding method call) and provided some messaging for the end-user.

  • &cover can be used to have a video be zoomed in and cropped, so it fills its window area completely. Useful if you don't want any gaps between videos.

  • &fadein=500 is a new parameter; also available as a director's room toggle. Has videos fade in smoothly; 500 = 500ms fade in time.

  • &tips will show a help-screen on the guest joining (via jcalado)Also a toggle in the director's room is available to enable this.

  • Got rid of some flicker when removing a guest from a scenetype=2

  • Scene 2 to 8 now make the background green when active

  • Just to avoid possible confusion or any unforeseen edge case, the director will get a warning if one of their user-requests get rejected due to a director-permission issue.

  • When Audio Processing is disabled, I now "disable" the mute and volume options. At the moment, these require the audio processing subsystem, so if it's not active, you can't change the gain setting. Depending on much of a problem this is, I can create another method of muting. (gain control strictly needs the web audio node tho, if on the publisher end, and not viewer end)

  • Added &margin=10 , which adds 10px around the videos for some spacing. Added as a toggle to the director's room and it can be customized. Defaults to 10px.

  • If the director sets &trb within their URL, it now will change the total room bitrate dynamically for connected guests in the room to that value. So, ?director=rrr&trb=1000 will have the video quality double (as the default is 500 normally).

  • Added a somewhat experimental flag &ltb or &limittotalbitrate , which tries to limit the total outbound bitrate to some max total value, via the publisher's side. This could be useful if you are broadcasting video as a director to the room, but only have a fixed amount of upload bandwidth or CPU. This bitrate limit does not include data used by audio, webp, or meshcast in its calculation. It is loosely accurate, but no promises. It is applied to scenes and solo viewers as well - not just guests. Example use: ?director=asdfdfssdfddd&trb=1000ltb=5000&

Guest related features ๐Ÿ‘ถ

  • Secondary screen share will now become disabled when the user is in a queue or after they have been transferred between rooms. Instead, the screen-share function/button will replace the primary stream with the screen share, rather than creating a secondary one. This isn't an ideal solution, but based on how transfer rooms work, this seems like a better solution.

  • Fixed an issue where the mic test meter didn't work when using &cleanoutput .

  • Fixed an issue where &sticky conflicted with secondary screensharing

  • fixed an issue where when using a macbook m1 /w Chrome, while using &noap, the camera's output would crop to 360p if requesting 720p

  • iOS devices (iPhones) when used in a group room will have higher frame rates now between other guests. The quality might still not look great.

  • Android and iPhones will be able to support more guests in a room now, before they starts to have problems. Mostly some optimization tweaks.

  • Added two options to control the frame rate and quality of screen shares within a group room: &screensharefps=2 or &ssfps=2 and &screensharequality=1 or &ssq=1

  • The &cleanish flag will show the director direct overlay messages, while hiding most others things

  • The TALLY light has changed from a colored shadow to an actual message that reflects the user's state in OBS Studio or Vingester.

Electron capture app related โœจ

  • Added screen sharing support within the Electron app; must "elevate" the app via right-click menu to do this though

  • The electron capture app will use a true full-screen mode (instead of full window mode) when setting things to full-screen

  • Added out-of-date version messaging; lets you know you need to update.

  • Added user-prompt support (for passwords/transfer rooms)

  • CLI-based window x/y positioning (via jacalado) added

  • Added the ability to change titles of windows via menu in electron capture.

  • The last link used is stored in the Electron Capture app now, for easier use.

  • Updated electron capture to support 60-fps screen capture

Miscellaneous changes ๐ŸŒˆ

  • Improved the remote monitoring tool so it now shows re-transmitted data as a percentage, instead of an absolute value that was hard to understand.

  • added mute support to meshcast.io; so if you mute in OBSN, it will also mute in meshcast now.

  • Fixed an issue with the stats where RTT was a total, and not an average.

  • The stats view clears now when the remote client disconnects, rather than showing frozen stats, as it was confusing.

  • Added the ability to send a keyframe to the iFRAME API

  • The Discord server has a new custom-made bot to help with support; https://github.com/steveseguin/discordbot

  • Detailed the &fullscreen command, which is useful if you want to use the Electron capture app as a webcam source, where you would window-capture your webcam into OBS, rather than using a virtual-camera to pull from OBS into OBSN. Things use less CPU this way, since virtual-cam is not used. Details on it here: https://docs.obs.ninja/source-settings/fullscreen

  • Fixed an issue with the video control-bar showing when it may not have been desirable

  • &optimize=0 will set the audio to 0-bitrate as well; useful for saving bandwidth/CPU in OBS when a scene is not visible.

  • Added the option to remotely change the audio or video source via the IFRAME api

  • Fixed a bug where scenes of type 3 to 8 didn't initialize the current state correctly;

  • When a scene loads, it will now sync the video's mute-state with the director as well; before it just synced the display-state.

  • Fixed a bug where &chat=0 didn't hide incoming chat messages

  • The documentation has moved to Gitbook.com, away from a simple Wiki. The new documentation site has a search bar, images, and better organization. (Thank you @jcalado for the help)

  • Fixed a couple bugs, including one where the image thumbnail for the virtual background would break in some scenarios

  • The speedtest now has an option at the bottom to switch to a mode that tests screen sharing, instead of just webcam.

  • Made a free Youtube Chat Overlay chrome extension thing; hosted here: http://chat.overlay.ninja/

  • Added numerous articles to the docs, such as this one about overheating and ideas to help prevent it; https://docs.obs.ninja/common-errors-and-known-issues/overheating

  • Updated the guides section a bit; https://guides.obs.ninja/

  • Added a MIDI transport option. This lets you route all MIDI messages from one computer to another computer. &midiin and &midiout, where 0 is "all" and 1 to N is device MIDI device order ID

Personal handshake server option added ๐ŸŽ

  • Added an experimental option that lets advanced users use a basic/generic websocket service as a personal handshake server; useful for air-gapped private deployments of the service.

  • A socket server has been developed and provided that can be used as a personal handshake server for this use case. Documentation included. https://github.com/steveseguin/websocket_server

  • Support for piesocket.com has also been added as a third-party handshake-server service option. If using piesocket, you can just do &pie=APKKEY to use that service, without deploying any code or servers yourself. The free tier is quite generous and I have no affiliation with them.

Thank you kindly to everyone for supporting each other with answering questions and general help. It does free me up to focus on developing new features and resolving reported issues. Thank you also to those who have contributed to the project in other ways; the community never ceases to amaze me. Thank you -- you have been awesome.

Sincerely, ~ steve. โ™ฅ


r/OBSNinja • • May 19 '20

Appreciation Big shout out to Steve at obs.ninja. Top gentleman developing an amazing product

47 Upvotes

r/OBSNinja • • Apr 20 '21

Important Version 17 of OBS.Ninja released (release notes here)

46 Upvotes

Version 17 ๐Ÿ… mainly focuses on user feature requests. The official release notes page is here, with the notes also available below.

If there are problems with version 17, the previous version of OBS.Ninja can still be found at https://obs.ninja/v164

Please report any bugs or issues. You may need to do a hard refresh in cases to have the changes get applied. I'm on Discord (https://discord.obs.ninja) for live support.

New features at a glance ๐Ÿ˜„ โœจ ๐ŸŽˆ ๐ŸŽŠ

* Director's control room updates ๐ŸŽ›

* WebP Custom Codec for reduced CPU-load broadcasting ๐ŸŽฏ

* Green-screen* and virtual backgrounds (*improved) ๐Ÿ“—

* Guest List of hidden guests now appears ๐Ÿ‘ป

* Custom CSS files via URL supported

* Chat-only overlay option available ๐Ÿคช

* A dedicated remote monitoring of video stats page added ๐Ÿ’น

* Active Speaker mode added ๐Ÿ“Œ

Greenscreen and virtual backgrounds โœ‚

  • added the new virtual background functionality; you can allow a guest to select their own effect by adding &effect to the guest invite URL.

  • you can manually specify a virtual background effect via URL with the following options:

`https://obs.ninja/?effects` (let's the guest pick)

`https://obs.ninja/?effects=3` (bokeh blur)

``https://obs.ninja/?effects=4`` (greenscreen)

`https://obs.ninja/?effects=5` (image; guest can select an image on joining; a sunset image is used by default)

  • green screen doesn't require SIMD support to work, although it won't work as well without it on. I leave a little warning info icon (!) if SIMD is not enabled. Please do enable Webassembly-SIMD support under `chrome://flags/` if you'd like to see a large reduction in CPU load when using this feature.

  • Drop down menus created for the virtual/digital background effects. You can select a preload image also or upload your own custom one. Change it via settings of use &effects to pick on startup.

  • Effects for 1,2, and 6 are not listed in the dropdown options, but can still be explicitly defined still

Active Speaker ๐Ÿ—ฟ

  • An `active speaker' mixing mode has been added. It auto-hides remote guests videos when added, if those guests are not speaking actively.

&activespeaker ( or &sas or &speakerview)

  • It will show multiple speakers if there are multiple simultaneous speakers.

  • The last guest to speak will remain visible when speaking stops.

  • Works with scenes, faux-rooms, and on guest-invites.

WebP Custom Codec for reduced CPU-load broadcasting ๐Ÿงช

  • Attempting to solve the CPU issue when broadcasting to many guests in a room, I created a bit of a custom video codec that bypasses the issues I've been having with WebRTC. This codec uses under 1mbps upload per connection, strives to be as low latency as possible, and uses very little CPU even with many viewers connected. It's quite experimental, not the greatest quality, and still needs the publisher to be 'visible' on the desktop (else it freezes), but it can be enabled while in a group room by adding `&broadcast&webp` URL parameter to the guest links.

ie:) `https://obs.ninja/?room=xxx123&broadcast&webp`

(The director just needs to go live with their camera after that.)

  • It must be used in conjunction with broadcast mode, but the director doesn't need to be the designated broadcaster.

  • the Electron Capture app should work to allow for webp-based broadcasting even if the tab is not visible, as tab throttling is disabled with that application.

  • This usese a custom video codec, which is essentially a stream of webp-based images sent over the webRTC data-channels

  • The quality by default is limited in both frame rate and resolution, as this custom video codec is very inefficient at higher resolutions and frame-rates.

  • the URL paramter `&webpquality` (&webpq / &wq) can adjust the quality, where you can pass a value from 0 to 5. You add this parameter to the director (or designated broadcaster) and it then sets the the quality target for the &webp mode.

`5 (default) = 270p @ ~15fps ; 4 = ~30fps, 3 = ~50fps, 2 = 360p, 1 = 720p, 0 = 1080p.`

  • Based on my testing, the webp mode is only efficient if you are keeping the bitrates under like 2mbps, so the higher qualities make little sense IMO outside of some niche use cases as they use up a lot of bandwidth. Still, I wanted to give the option.

Chat commands

  • I felt like it would be fun to add "command" options to the chat box, turning the chat window into a bit of a console.

  • "/list" will list those connected peers, in format: UUID : user label

  • "/msg userid some message here" lets you send private messages to other users. You can use partial strings, and I'll do what I can to guess the user based on those partial strings. Use the UUID value or the user's label name. not-case sensitive.

ie:

`/list`

`/msg 25e HellllOOo`

List of Hidden guests now appears by default ๐Ÿ‘ฝ

  • should list user's labels in a list, along with whether they are video-muted or not, etc.

  • includes mic mute states and voice activity meters in the list

New Stats added ๐Ÿ™‰

  • time since connected and a "total" bitrate value. This includes data-channel and overhead data ; not just audio/video.

  • the browser type used by a guest is more clearly stated

  • total round trip time is a browser stat; the sender didn't have any sort of latency stat, so I added this in. Judge for yourself how well it works; this will not include the viewer's buffer delay I believe. Just transport delay?

  • available outgoing bandwidth, which is the value the browser uses to judge how much upload room it has. By default, Chrome seems to have this max out at around 4500 or so; my guess is Chrome just doesn't see a need to test higher if the default video bitrate is around 2500. The &bitrate= command of course forces Chrome to test much higher. I suppose you could use this value to get an estimate on what the total bandwidth of a connection is, and then you'd be best served keep the &bitrate target to be no more than 80% of that.

  • added audio bitrate to the director's stats

  • fixed a screen-sharing bug, where the screen-share didn't go away always when it was stopped using the browser-force stop option.

  • Safari desktop users get a hint now to switch to something else when connecting as a guest

  • broadcast mode will now use the &minipreview option by default, with the slight twist; the guest will see themselves full screen if the broadcast hasn't started yet. &nopreview can disable it and &minipreview can force always-pip for the preview.

  • added a couple new bitrate commands that should be quite valuable when using the &broadcast option.

`&outboundaudiobitrate\\` or&oab, along with \\&outboundvideobitrate\ or `&ovb`.

  • These can be applied to the PUBLISHER's end, and they will set a default target bitrate and max bitrate for outgoing audio and video streams.

  • For audio, it was added to allow the Director to set their outbound audio bitrate to be shared with guests at something like 160-kbps, while having the guests still be able to share their audio between other guests at the default audio bitrate of around 32-kbps. If the guest sets the audio bitrate (&stereo=1 or &ab=200), it will override the publisher's &oab parameter.

  • For video, the &ovb is similar, except if set it sets the viewer's bitrate and overrides the &vb parameter. It won't override the room's total bitrate parameter, as that's a dynamically set bitrate, so to get higher bitrate in group rooms you still need to use &trb.

  • Mainly did this work to allow for more control over audio bitrates in the &broadcast situation, where guest to guest you might want to have a different audio bitrate versus the director's audio bitrate output.

Custom CSS stylesheet support ๐Ÿ’ข

  • added the ability to link to a remotely hosted CSS style sheet via the URL using the new &css parameter. You can stylize OBS.Ninja without needing to host anything more than a CSS file.

&css=https://SOMEDOMAIN.com/STYLESHEET.css

example: `https://obs.ninja/?css=https%3A%2F%2Fs10.fun%2Fmain.css`

Chat-only overlay ๐Ÿ’ฌ

  • created a basic chat-overlay based on the OBSN chat. https://obs.ninja/chat?room=asdfasfdsdf

  • you can add room, password, or/and view as parameters. Other parameters are pre-configured to make it work as a faceless chat listener.

  • it's pretty ugly right now, but it's pretty easy to do CSS styling as needed directly in the OBS Browser source styling area.

Scene changes ๐Ÿ’ซ

  • Added &scenetype (aka, &type) . This is replacing &scene=2 with &scenetype=2. &scenetype=2 just shows the last guest that was added in the scene; it does a basic mute of the last guest also. &scenetype=1 does the same thing, but doesn't mute. It's not super sophisticated logic, but it should work in a pinch.

  • Director has access to more scene types by default (scene=5 , etc). You must manually create scene links for OBS to use these extended scene options, as links for scene=0 and scene=1 are the only ones provided by default still. You can use these added scene links to create dedicated "slots" for guests in an OBS layout.

  • If using &scene=2 or greater, for performance reasons, videos won't load immediately in the background when the scene becomes active; only once the video has been added to the scene will the video stream be loaded. Videos will still preload however if using &scene=1, (up to 500kbps anyways). This is a required performance optimization, imo, and it shouldn't impact existing use cases of OBS.NInja.

Changes to the built-in video "record" logic

General logic when setting the recording bitrate has been improved:

  • setting it to over 4mbps video bitrate will have the audio be set to 128kbps. (Inbound transfer and recording)

  • Set to over 2.5mbps, the audio bitrate will be around 80kbps inbound, with a 128kbps record bitrate.

  • Recording with PCM (versus the default of OPUS), the inbound audio will be at 256kbps. (regardless of video bitrate)

  • otherwise, audio inbound bitrates will be set as specified or as defaults (inbound audio bitrates default to around 32-kbps VBR Opus, normally)

Director's control room updates ๐Ÿค˜ ๐Ÿ’ช

  • &transparent will make the Director's room even more transparent now, for better or worse.

  • added the ability for the director to select audio or video devices via the URL, like how guests can do it using &vd=xxx / &ad=yyy

  • added a few more toggles for the director to use to customize links

  • Re-arranged how the director buttons appear and function, including making the the audio output channels and extended scene buttons available by default

  • The director now can set different resolutions for their camera via the settings ; gear icon appears.

  • if you enable `&showdirector` as a director, you will now appear as a performer kind of like other performers. add/remove from scene, highlight, record, order, and the solo-link is easy to access.

  • if pressing the "Solo talk" in OBS as the director, it will now un-mute you automatically. it will return you to the previous mute state after you un-solo talk.

  • Director can now change the URL of a guest remotely, sending them to any website or changing URL parameters.

  • &beep will now go off for the director each time a guest joins the room (with audio/video tracks added )

  • Director gets a chat notice that someone (label name used if available) raised their hand via the chat

  • added some initial state synchronization for the director (finally); auto-updates newly created scene/guests with existing state. (scene=1 + highlight state synced)

  • Added a button to get a glance of the stats for a video (shows the stats for the scene the video is in; nothing else)

  • added the ability to create Calendar invite links to the director's room. Apple calendar doesn't seem to offer an option to create a calendar invite easily, so I just support Google, Outlook, and Yahoo for now. (Bottom right of director's room)

  • you can use chrome's picture-in-picture within the director's room. This lets you increase the size of the preview's and move it around the screen.

  • hide/show guest's video can now be armed with CTRL (plus state is correct after director reloads)

  • added the ability to "hide" a guest's video -- this applies everywhere, in scenes and for group room guests.

  • when recording video as a director ("local record"), the system will now increase the inbound audio bitrate dynamically to be meet the quality targets.

  • added the ability to 'highlight' a guest's video, which essentially just means it makes it full-screen everywhere

Electron Capture app ๐Ÿง 

  • Electron Capture app updated for Windows PC, including now functional screen-share and optimized virtual-background support.

  • For those not familiar with the Electron Capture app, it's a free tool that replaces the OBS Browser source with a standalone-version. It is more reliable, uses less CPU, and offers better audio/video quality in general. It still is used in conjunction with OBS, but uses the OBS Window capture mode.

  • The Electron capture app can be found here: https://github.com/steveseguin/electroncapture (an updated macOS release is in the works)

Miscellaneous ๐Ÿ‘€

  • Green volume meter dot has a black outline to help make it more visible

  • Devices page (https://obs.ninja/devices) will generate an appropriate &outputdevice value for URL-based audio output device selection.

  • Translation files updated to be more aligned with V16/v17 changes

  • &optimize=0 will disable video tracks (video bitrate = 0) when the video track is not in an active OBS Scene

  • Added more MIDI control-change-based commands, including support for per guest-volume.

  • &nvb or &novideobutton hides the video button for guests (unable to mute their video) ; `&nmb and &nomicbutton` also added

  • added the &noremb command, which deletes the flag for Google' bandwidth estimation tool. Doesn't seem to do much though.

  • fixed a really annoying Android 11 bug that causes the screen to freeze on camera change.

  • fixed an annoying issue where when you disable the camera, the last image sometimes freezes in the preview.

  • added the &delay={milliseconds} parameter , which is guest-side, and delays the microphone by specified time in milliseconds. alias &micdelay and &md I already had a &latency= parameter, but that used a buffer-node and not a delay node. I am finding the buffer node to cause clicking, and the delay node does not. This is also not the same as the &sync or &buffer commands, as those are viewer-side delays.

  • added local video/mic state changes to the IFRAME API

  • improved re-reconnection logic ; should help reconnect things if there is an IP address change.

  • fixed an issue where audio wouldn't un-mute if the video was already already muted also

  • &nonacks, &codec=red , &codec=fec ,and &nopli have been added as a viewer-side parameters. They don't seem to do much it seems, but for advanced webRTC testing, they can maybe help override default webRTC behaviors, like potentially some bitrate throttling.

  • if a user disconnects without using the hangup button, there's a 50/50 chance they will have a lingering frozen 'last frame' on screen. Well, I got this frozen frame to clear after 8-seconds now (/w a 250ms fade out), versus 18-seconds, so 2.2x faster now. The video will fade-back in if it was just a connection issue that manages to reconnect though, as I do still wait the full 18-seconds or so before I hangup. Slightly less awkward I hope.

  • applied some more patches in an attempt to fix issues with some Samsung devices that glitch at certain resolutions; causing odd coloring. I'm applying the fix to all Android devices, just to be safe. May not eliminate the issue, but should reduce it.

  • using &pip on the view side will force the system-based PIP to trigger on the first video that loads. This was a user request.

  • updated the initial connection logic so it's compatible with asynchronous server-hosted TURN server credentials. (for self-hosted TURN server users)

  • `&maxframerate` (&mfps &mfr) , which is like &framerate, except it will allow for lower frame rates if the specific frame rate requested failed. Happy to add more options here, or to make the &framerate=XX option not fail (but go up or down), but i think the feedback that a frame rate isn't supported is helpful. You will still get an error if the only supported frame rate is higher than the specified frame rate; with either URL.

  • updated the error message for SLOBS on macOS, as StreamLabs on macOS is still not natively supported

  • the "no internet connection' error message won't show up in scenes or view links anymore

  • Screen-shares will try to provide higher quality resolutions despite still limited bitrates; I am treating the bitrate control code differently now for screenshares vs webcams. Might use up more CPU, but seems worthwhile

  • the mute button pulsates when it's pressed now. I hope this helps users notice that they are mute; the header bar turns red when muted also

  • Added the command &ptz, which can be added to a push link, which enables the pan/tilt control of the camera, if compatible. This will trigger a new permission popup though (Chrome only)

  • https://obs.ninja/supports This camera settings tool now properly supports pan/tilt detection. (Chrome only)

  • When using &cleanish and &record, you'll get the Record button showing, but nothing else

  • wrote up some WebHID code for the streamdeck -- TEST code here: https://obs.ninja/webhid I'll eventually add this all as hotkey support, though I have little idea how to let users customize what does what so far.

  • clicking anywhere outside a popup alert window will close the window now

  • updated the speedtest to only test with UDP and with the closest server (TCP connections rejected)

  • The &tcp as a flag will force TCP mode *if* connected to a TURN server, versus the default, which may be UDP or TCP.

  • More UDP-based TURN servers available, especially in Europe

  • the mini preview can now be maximized by clicking on it; it can also be minimized again by clicking on the Compress-icon that's normally there if a video is 'in focus'. Compatible with mobile/iOS.

  • added a link to less common known issues on the main sit

  • Added a mini-preview option; &mini or &minipreview will enable it. Auto-forces the preview on.

Remote monitoring support added ๐ŸŒ๏ธโ€โ™€๏ธ ๐Ÿ‰

This pretty much lets you remotely monitor a publisher's outbound video stats.

  • works with and without rooms

  • multiple graphs per viewer of stream are visible remotely

  • &remote=privateKey allows for sharing of stats with remote connections; privateKey value is optional.

  • Feel free to make contributions to Github with improvements to the `monitor.html` page

  • you can use &sid=xxx or &view=xxx, as view might be more familiar, but you're not really viewing a video-- hence sid. (stream ID)

  • If using this with a room, you'll need to still include &room=ROOMNAME; same with the password.

https://obs.ninja/speedtest?sid=xxxxxxx

https://obs.ninja/monitor?sid=xxxxxxx

or for a direct link

https://obs.ninja/?push=xxxxxxx&remote=privateKey

https://obs.ninja/monitor?sid=xxxxxxx&remote=privateKey

Community highlights ๐Ÿง™

Previous release Notes ๐Ÿฌ

Version 16.3 and 16.4 release notes were not published to Reddit, as they were not major updates, but they are still worth reviewing too. Find them here:

https://github.com/steveseguin/obsninja/wiki/v16.3-update-notes

https://github.com/steveseguin/obsninja/wiki/v16.4-update-notes

You can find a list of all previous release notes at https://github.com/steveseguin/obsninja/wiki/Older-releases

Thank you ๐Ÿฅฐ

Thank you to those in the community who have contributed both time and resources. It's not always possible for me to help everyone as OBS.Ninja grows, so the community support has been quite appreciated.


r/OBSNinja • • Mar 22 '20

What is OBS.Ninja

43 Upvotes

100% free; no downloads; no personal data collection; no sign-in

  • Bring video from your smartphone, laptop, computer, or from your friends directly into your OBS video stream

  • We use cutting edge Peer-to-Peer forwarding technology that offers privacy and ultra-low latency

  • YouTube video Demoing it here

  • Code is open-sourced: https://github.com/steveseguin/obsninja


r/OBSNinja • • Dec 24 '20

News Version 14 has been released. Happy holidays everyone

42 Upvotes

With no issues reported with the beta test over the last few days, I'm happy to announce that version 14 of OBS.Ninja is now released into production. ๐Ÿ’ฅ

Version 14 focused mostly on feature requests and fixing audio-device reconnection issues.

Please note: https://obs.ninja/v134 is where you can find the older version, incase the new version is bugged for you. Please report any bugs so I can fix them ASAP.

New features at a glance

Demo of new features in Video format here ๐Ÿ“บ

Guest labels

Display name labels have been added as a video overlay option. Thank to Jcalado for helping out here and for creating a set of styles.You can configure a publisher with a label by using &label=some_name or by just leaving it blank; &label. If blank, it will prompt for the userโ€™s input.

&showlabels or &showlabel will turn on this feature ๐Ÿ™‰

  • Font-size of labels will adjust slightly based on the window size

  • Underscores "_" used in label values will be replaced by spaces, allowing for word separation. ๐Ÿ“ท

  • CSS of the styles can be set via the OBS browser source stylesheet window. The CSS class name you can customize is called "video-label"

  • There are some "preset" styles you can use by passing skype, ninjablue, toprounded, fire, teams, OR zoom as a value. For example: &showlabel=fire

Improved Video aspect ratio change detection algorithm

Along with this change, some improvements to the auto-mixer were made, including detection and mix update of detected video aspect ratio changes. ๐Ÿง

Remote volume control

You can now remotely mute a guest from the directorโ€™s room; there are options to mute in just the scene, but also have the guest muted Everywhere.The volume control in the directorโ€™s room for a guest now applies to that guestโ€™s volume Everywhere.

Reworked audio pipeline

New audio pipelines for streams have been added for both inbound and outbound audio streams.You can disable it mostly by using &noaudioprocessing or just &noap as a URL parameter. ๐ŸฆปAdded a compressor, limiter, and equalizer for the guests to tinker with; off by default though.

  • &compressor(preset as a basic compressor) ๐Ÿฅฐ

  • &limiter(preset as a basic limiter)

  • &equalizer or just &eq ๐ŸŽ›(options to manually adjust are in the settings window, if enabled). Currently must be adjusted by the guest themselves, but will eventually be an option for the director to remotely control.

Change audio processing live ๐ŸŽš

You can change settings like Audio echo cancellation, noise suppression, and auto-gain dynamically during a live stream now. This will cause the video to flicker with some browsers and will only show if the browser supports it.

New TURN Servers

New TURN servers added to LA, Chicago, and I think New York? Anyways, these are all UDP-based TURN servers, while the previous set were TCP-based. You can check what TURN server you are connected to via the stats debug menu. (Ctrl + Left-click on PC; Command+LeftClick on macOS). UDP vs TLS is listed, along with the IP address, which opens up to show the hosted location of the TURN server. Check it out with https://obs.ninja/beta/speedtest

UI/UX Tweaks ๐Ÿ“ฑ

  • Scroll bar in the stats menu doesnโ€™t keep trying to scroll back up with each refresh

  • Listed Labels and Stats in the stats debug window are less buggy when there are more than one stream active

  • Thereโ€™s a drop down button on the main page that reveals a few new buttons. File share, Share Website, Speed Test, and a link to OBS.Ninja documentation.

  • Added a Bug Submission button in the bottom right. It shows up when an error occurs in the code; clicking it lets you submit that error information to an OBS.Ninja error reporting server. Only the console log errors and user-agent info is submitted.

  • I changed the "Glasses" icon that appears in the top-right of videos to a HQ and LQ icon instead. This button makes the video fill the window and increases the video bitrate to at least 1200-kbps. Useful for seeing detail in a screen-share while in a group room.

  • If entering the room "test", youโ€™ll get a notice now alerting you to the fact itโ€™s not a secure room to be joining. Many users seem surprised to see the room is rarely empty, so I hope this helps that out.

  • Added a notice to the Transfer room popup, alerting users that rooms being transferred to need to share the same password as the originating room.

  • Added a button that lets a user reload the video camera device without selecting another device first.

  • An incorrect password (with &hash used) returns a more stylized error message now.

  • If you hold CTRL (or command) when muting/unmuting the speaker output, it will force the audio output destinations to be reconnected. Should be useful for me to debug audio issues in the future, such as when your sound suddenly stops working.

  • The microphone icon in the bottom control bar now glows green on local mic activity. May change later.

  • Added a Reset button to the URL link invite generator.

  • Added a AUDIO ACTIVITY indicator in the top-right of the inbound videos. You can now see who is talking. You can force this on in the SCENE links by using &style=3 as well, as it doesnโ€™t show up there by default otherwise. Disabling audio processing will hide this all, as well. (&noap) ๐Ÿ“Š

  • Removed the header from iOS when invited as a guest. Just trying to free up more space where needed.

  • Improved the play button. Opaque and easier to see now.

Tools

  • Jcalado has revamped the Speed Test to be pretty dapper and stylish. Graphs and more.

  • The Speed Test contains more accurate packet-loss values and a "quality limitation reason" output now for publishers. This Quality LImitation value defines why a stream you are outputting isn't performing well; CPU or Network issues are options, if there are issues.

  • Jcalado again rescues us with an updated https://obs.ninja/devices page that lists available devices, but also it can be used to find the audio-device ID for a given audio output destination. An alternative to using the Electron Capture app. And you just need to click to copy to the clipboard.

Improved reconnection logic ๐Ÿ”ฉ

A significant amount of work has gone into adding reconnection logic for audio and video devices. If unplugging a device or adding a new device to the computer, or if a device is temporarily disconnected, the new logic will try to handle it. This will hopefully solve problems with Bluetooth headphones disconnecting during live streams and not reconnecting.

Improved file sharing

The &fileshare sharing function has been improved; more stable and less freezing for remote viewers.

New website sharing

The Share Website feature is experimental; it allows you to share third-party websites as an IFRAME. Some YouTube videos can be shared as "embedded" links, for example, with this option.

Chat window pop out

The chat window can now Pop Out, allowing you to type and read messages from another window. This cannot be shared cross-browsers, as it uses in-browser messaging.

Translations ๐Ÿ”ก

  • The Language translator has been improved. It now supports placeholder text and tool-tip text. Please feel free to update translation files on GitHub if not fully translated.

  • Portugese language updated (thank you again, Jcalado)

More parameters

  • The &enhance flag was added; this causes the Viewer of a stream to request its publishers to prioritize encoding and network sending of the audio stream. If you are facing clicking sounds as a viewer, such as with an OBS view link, this might help reduce audio clicking.

  • The parameter &iframe (aka &website) is added; this allows you to share a website with viewers. Please be aware this is still an experimental feature.

  • There are toggles for Advanced Video and Audio in the settings menu now. You can disable access to the settings menu by adding &nosettings

  • Added a RAISE YOUR HAND feature, via an icon in the guestโ€™s control bar. It causes a yellow button to appear on the directorโ€™s page when pressed. You can enable this with the &handsfeature, added to the guests' URL link.

  • A new screen-share button was added. You can FORCE it on with &ssb, or hide it with &nosettings. The UX for screen sharing is not quite perfect yet, but Iโ€™m interested to hear feedback regarding it. If you toggle the button off, it will open the settings menu currently, letting you change to a different video device --- It does not STOP the screen sharing when pressed. Not yet at least. (maybe in v15)

  • &nopreview now works when doing screensharing.

  • Added &exclude=xxx,yyy,zzz as a new parameter, which is like &view, but in reverse. Any stream ID added to the list of values will NOT be allowed to load. So, you can eliminate specific publishers in a room from loading in your group video layout.(no audio or chat either)

  • &audiooutput is now an alias of &outputdevice / &od

  • You can use the URL parameter &controlroombitrate or &crb to allow a guest to control their total allow room video bitrate. When added, a slider appears in the guestโ€™s settings menu. For guests that have limited CPU or Network bandwidth, lowering this slider will reduce the video bitrate of incoming video streams.

  • Added &ptime as an advanced audio URL parameter, Setting ptime or minptime to be like 60 might reduce audio clicking in some cases, although the browser defaults are set by default. Ptime represents the packet size in milliseconds of audio streams.

  • Useinbandfec (OPUS audio setting) is now enabled if &stereo or custom audio bitrates are used; overriding browser defaults. Iโ€™m hoping this reduces audio clicking if on bad Wi-Fi.

  • &latency=NN is a new URL parameter, which can be applied to the publisher of an audio stream. The browser default tends to be 10 milliseconds, but 20 or 30 might be a useful option to help reduce audio clicking caused by buffer underruns. The latency value sets the LatencyHint value of the WebAudio audioContext function.

  • Added &pass and &pw as aliases for &password

  • Added a &cleandirector URL parameter which hides the invite links and help information in the directorโ€™s room. This allows for a nice clean window.

  • When using the &optimize command, you can now pass bitrates to it. The default bitrate is 600 kbps. Using this command will allow you to disable video streams in OBS from streaming if they are not visible. Setting this value to 0 will have the streams turn off entirely while not actively visible in OBS. This command is not on by default.

New scenes

  • &scene=2 has been added as an option for OBS scene links. With this, when a video is added to a scene manually, it replaces any previous video that was added to the scene. This causes some state issues with buttons in the directorโ€™s room, but for now manually toggling the add to scene button can resolve this issue.

Improved director room ๐Ÿšช

  • If you leave &director as a URL parameter blank, it will create a random room name for you.

  • Thereโ€™s a checkmark option for setting up a group room with the &broadcast URL flag already added. This has it so any guest joining the room with the generated links will only be able to see the director's video. The other guests in the room can be heard, but not seen. This allows for larger group sizes.

  • Added an option to set the Default Video codec in the Directorโ€™s room during room setup. (appends the codec request to the SCENE links only)

  • The Invite and Scene links in the Directorโ€™s room can now be toggled as hidden or not. This frees up room in the Directorโ€™s room.

  • Volume activity levels are also seen in the Directorโ€™s room

  • When you publish your mic or camera as a Director now, I update the URL to show your stream ID. You can also manually set your own stream ID when joining the directorโ€™s room by adding &push=STREAMIDVALUE

  • I moved the Push to Talk button in the Directorโ€™s room to the bottom and renamed it.

Other

Support / Guides ๐Ÿ“–

Numerous more guides have been written this month. https://guides.obs.ninja is slowly being populated with some more polished guides; on-going project there. A guide on how to Stream from OBS.Ninja into Zoom without OBS. (trying to minimize repeating myself with support emails) https://docs.google.com/document/d/e/2PACX-1vR_5D2BSi_SJ8_g-GGnC_DtoX7HYEhzPvGlLExMasWh3UBpRv-x8Bj0tbdYIXjfgzImVHd-oNJbOTYb/pub

Bug fixes

  • Numerous fixes to support iOS devices better were added.

  • Fixed a bug on Google PIXEL smartphones where if lower resolutions were used the video would go all corrupted.

  • You can access the stats screen now even when using the &style=2 waveform effect.

  • Fixed a bug with the OBS Tally nights not working for the group

  • iOS devices can now see the loudness meter during camera setup

  • Fixed an issue with the lip sync code; specifically the &sync command

  • Fixed a bug where the audio selector in the settings pane required a double-click to work.

  • Fixed a bug in &maxpublishers and added the new &maxconnections paramter, which limits the total of both view and push connections. Maybe useful for like a call-in show style thing, where you don't want to get flooded.

  • Fixed an odd bug where if changing cameras too quickly during the camera selection window, you could end up with a dead video track being added to a waiting viewer instead of an active video track. (race condition)

  • Changed the transfer room so that if you get disconnected from a room you were transferred to, you also get force disconnected from any video streams from that room. This is going to have to be good-enough for the next month or so, until I can get a better solution in place.

  • Handshake connection isnโ€™t made until after camera selection page now (for publishers)

  • Camera-selection page had numerous changes and tweaks in an attempt to avoid camera-permission errors. There will be ongoing improvements here.

IFRAME API

  • Added an IFRAME API to let a user remotely control the tally light for a guest via the IFRAME API. sceneState=true | false. See https://obs.ninja/iframe for a dev sandbox.

Special Thanks ๐Ÿ’–

Special thanks also to TheFluffyToucan and Azyr for providing brilliant bug testing and UI/UX feedback. Their help allowed for Version 14 to be released on time for the holidays.

I'd also like to thank the generous individuals who have donated to me and this project over the course of the run. I wouldn't likely be able to afford hosting OBS.Ninja without your support.

And thank you to everyone I didn't mention, including those who have shared OBS.Ninja with friends and family. Your support has meant a lot to me.

happy holidays, ๐ŸŽŠ

steve


r/OBSNinja • • Aug 01 '21

Informative I made an OBS.NINJA Cheat Sheet because the official documentation was difficult for me to find the info I needed quickly.

Thumbnail
docs.google.com
41 Upvotes

r/OBSNinja • • Aug 16 '20

Guide New Feature: Live Captions using AI-based Speech to Text

40 Upvotes

While I spend much of my day coding, I also produce live content regularly for clients as well. One feature that comes up over and over with corporate clients is closed captioning for live streams. There are some great services out there already, though none have really met my needs.

So, I present to you the tool I've made for my own live streams in hopes of receiving user feedback.

Find it hosted here: https://obs.ninja/speechin (edit: Now also hosted here: https://caption.ninja)

[update: This feature is now added as a part of OBS.Ninja directly.]

If there is interest, I can add this feature directly into OBS.Ninja, along with guest-names demarking who is speaking. I can also allow for saving timestamped transcripts if desired. Please let me know what else might interest you.

There is no time limit that I know of and the app is free to use. It does use a server-based transcription service, so privacy cannot be guaranteed. I personally do not store any transcriptions however.

Anyways, using the app is pretty simple.

  1. When you open it, (ideally with Chrome), accept the microphone permission request.

  2. Next, a link will be copied to your clipboard. You can paste this link into OBS if you want to have the captions show there as an overlay.

  3. To trigger the speech to text, just start talking into your system's default microphone. The text will show up on the page and also in OBS, if you added the URL there.

  4. If you wish to use the audio from OBS.Ninja as a transcription audio input, use VB Cable (linked on the site) as a virtual microphone. In OBS, have the OBS.Ninja browser source output its audio output to both "Output and Monitor". Lastly, in OBS's advanced settings, set the Monitor output to be the VB Cable input device.

In the future I'll have this built into OBS.Ninja directly, although there are some technical hurdles I'll need to solve first.

Feedback welcomed and thank you,

-steve


r/OBSNinja • • Feb 01 '21

News Version 16 has dropped; change log contained here ๐Ÿค—

39 Upvotes

Hi Everyone!

OBS.Ninja has been updated to v16 over the weekend, so please note the new features. If there are bugs or issues, please report them. If v16 does not work for you, you can revert to the previous version at the link: https://obs.ninja/v15/ ๐Ÿฆ„

This release is a mix of new features and improvements. I'm excited by the introduction of a queuing option for those looking to screen guests, the beginnings of Streamdeck hotkey support, highly-requested improved screen sharing functionality, and further CPU-performance optimizations.

New features at a glance ๐Ÿพ

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 continuing 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.

Please note that a room setup to be a 'queue' isn't designed at the moment for chat or creating scenes with; the guest in queue needs to be transferred to another room to be 'unlocked' for those purposes. Moving a guest back into a queued room will have the guest no longer be in a queue however. I welcome feedback on how I can improve this!

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

Note G3 Toggle ChatNote A3 Toggle MuteNote B3 Toggle Video OutputNote C4Toggle Screen ShareNote D4 Hang upNote E4Raise Hand ToggleNote F4 Record Local Video ToggleNote G4 Enable the Directorโ€™s audio [director only]Note A4 Stop the Directorโ€™s Audio [director only]

midi=2

Note G1 Toggle ChatNote A1 Toggle MuteNote B1 Toggle Video OutputNote C2 Toggle Screen ShareNote D2 Hang upNote E2 Raise Hand ToggleNote F2 Record Local Video ToggleNote G2 Enable the Directorโ€™s audio [director only]Note A2 Stop the Directorโ€™s Audio [director only]

midi=3

Note C1 + Velocity 0 Toggle ChatNote C1 + Velocity 1 Toggle MuteNote C1 + Velocity 2 Toggle Video OutputNote C1 + Velocity 3 Toggle Screen ShareNote C1 + Velocity 4 Hang upNote C1 + Velocity 5 Raise Hand ToggleNote C1 + Velocity 6 Record Local Video ToggleNote 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

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 hot-keying remote guests as a director:

Value 0 Opens the Transfer PopupValue 1 Add/remove from sceneValue 2 Mute guest in sceneValue 3 Mute guest everyoneValue 4 Hangup the guestValue 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 cases.

  • 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 ๐Ÿ™ˆ ๐Ÿ™‰

  • &deaf or &deafen and &blind are URL options now. Have a room guest join a room blind or deaf.

  • 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.

For a video review of some of these features, there's a Youtube video hosted over at https://youtu.be/UdQ4v1pwcdk

Thank you to everyone who has contributed and supported this project in their own way. A special thanks to Jcalado and theFluffyToucan again for helping with testing, documentation, and support, along with many others out there.


r/OBSNinja • • Aug 17 '20

Important Version 10 Released โœจ Text chat and more added! See the change log here.

38 Upvotes

Welcome to the release of Version 10.

There was a silent version 9 release, which contained mostly bug fixes. Version 10 is a bit more substantial, with several user requested features as the main focus.

As always, please report bugs. If you run into new issues, you can still find the previous version of the app up at https://obs.ninja/v9/

Version 10 Change log:

Added text messaging CHAT.

-Pretty basic, but meet the needs of many

-red notification bubble implies you have a new message

-basic security/protections added to chat (no links can be sent, etc)

-HTML5 emojis are supported (https://www.w3schools.com/charsets/ref_emoji.asp)

-mobile compatible

-Built to be private and secure -- messages are peer to peer (no server)

Added the ability to Change the audio and video device while live streaming, including the option to screen share

-This was a time-consuming feature to add; please report any bugs you might encounter!

-Press the GEAR icon to bring out the settings menu. Click anywhere outside the menu to close it.

Added additional code to try to fix the OBS Vp8 pixel smearing problem

-Every 3 seconds it checks if there was moderate packet loss, if the codec is vp8, and if OBS is in use.

-If all true, and OBS didn't correct the packet loss, it acts on its own to trick the sender of video to send a keyframe.

-The point of this is to solve the RAINBOW PUKE problem.

-You can disable it with &obsfix=off or whatever.

-Please Report FEEDBACK and ISSUES with this new feature

Added a button that lets you FORCE a keyframe to all your connected viewers.

-If you are doing a live stream, you can use this to "kick" the stream if you start having problems.

-It will lower the video quality for a split second, but if the video is stuck or all smeared, this might help get it back to normal

-You can access this button via the Debug / Stats window on your local video preview (see below).

Improved the Debug Stats window to show things in kbps and to highlight the important stats better

- you can access it via CRTL + LEFT click on the video playback window

- made some UI/UX improvements to the way it can be closed

Added an "auto start" URL parameter that has a user auto-join the video, bypassing the camera/microphone selection page. &autostart , &autojoin, &aj

-Unless otherwise defined, it will use the default audio and video device as inputs/outputs.

-It won't auto start if an error occurs

-The user will still need to press an intial button, which is required to get needed "user gesture" permissions

Added the URL parameter &videodevice that hides the option to select a video device on join.

-if set to 0, it disables video for the guest. They can see video, but can't publish it

-if set to 1, it just hides the video selector; it will use the System Default video device intead.

-if added with no value, it is assumed to be equal to 1 (default camera)

- vd, vdevice are aliases

Also added the same function for audio, so &audiodevice hides the option to select audio inputs AND audio outputs.

-I also hide audio output as the goal is to make things less confusion, not more.

-you can still change audio/video via the settings icon once in the app

-you can use "&device" to represent both audio and video together.

Highlight specific videos in the group room

-Expanded &novideo and &noaudio so that streams listed as values are excepted

- https://obs.ninja?room=xxxx&novideo=MainVideo123,other123 --- in this case, MainVideo123 and other123 are both allowed to show video, but all other videos cannot.

- You can use this to have ONE video stream selected for everyone in a group chat, such as the output of OBS. This can help reduce the load on those in the group room, by only needing to pull and push one video stream.

Added the feature request to have bitrates per video be something you can set via the URL.

-so, ?view=aaa,bbb,ccc&bitrate=100,250,2000

- the first bitrate listed in the list becomes the default bitrate for all non-specified videos

Created a closed captioning (speech to text) translation tool added (https://obs.ninja/speechin)

Created an Invite URL Obfuscator tool with custom URL (https://invite.cam)

Improved the OBS Dock interface; now supports non OBS.Ninja domains

Created a speed test app, https://obs.ninja/speedtest that measure packet loss, transfer bandwidth, and more.

-Useful for analyzing performance and connection issues.

-Just reload if issues occur

๐Ÿค– Created an IFRAME and DUAL sample page app and an OBS.NINjA API.

I'll go more into this another time, but you can now use OBS.Ninja in an abstracted way via an API messaging layer.-I created the IFRAME sample pages as examples of how to code it.

-You can use it to create custom Control interfaces or custom video layouts

-the speed test uses this API to function; two Iframes + interface, all together.

-IFrames can be embedded into third party website and access data or control using custom interfaces

- https://obs.ninja/iframe (see the code here for reference of how it works)

Prototyped an app that lets you Screenshare and share your Webcam at the same time.

- Based on the above IFRAME sample code.

- https://obs.ninja/dual

- needs a lot more work, so keep an eye out for it. (It's just a prototype currently)

Made several UI/UX improvements to OBS.Ninja, including a better looking camera selection interface. (margins,paddings, colors, improved)

(Thank you Chris ๐Ÿ˜Ž for the continual feedback on this front)

Support for 60fps @ 1080p with OBS Virtualcam has been tweaked/improved. This is a great way to screen capture a game, versus Chrome's built in screen capture tool.

You can now wait to &view an upcoming stream that gets added to a group room while not part of the room. (passwords are still needed mind you)

If using a password, the Stream ID will be salted so it cannot be found without the password. This was already the case for Room names.

- passwords also encrypt the important parts of the data stream, as to make it impossible to make a peer connection if not correct

Went two months without server downtime or others major issue this summer. ๐Ÿคฏ

-Recently tho had to renew SSL certificates, apply system/security maintanence, etc.

The Backup server updated and consolidated into a single dedicated server box. https://backup.obs.ninja

- Also, added better messaging if you get the port 443 error. I also include a link to the Backup server in the message; failsafes ftw!

Video Player and Mirroring logic / UI improved

- When a video is mirrored, it now longer mirrors the video control bar also.

- Default Preview Video Mirroring is disabled for OBS VC, NDI tools, and rear cameras on mobile devices. It's on for others by default.

- Non-essential control bar elements have been deleted, such as the clock timer.

- Video Control bar is no longer visible at all in OBS . Before it unlocked after 3 seconds, but that was still causing some issues it seems

Tool tip added to audio selection menu, which explains how to select more than one audio source for mixing

Added support for iOS 14 Beta, which had a bug that broke the app.

If an OLD iOS device tries to use OBS.Ninja, I give them an error messaging now explaining what iOS versions are supported (iOS 11 and up)

More cameras are supported by Firefox now

Added an error message for MS Internet Explorer users , along with a link to download Chrome

moved the "HELP" icon to the lower right, next to the language locales button.

Numerous css/animation fixes throughout the site.

Pressing the "stop screen sharing" button will let you select a different screen automatically.

-based on user feedback

The manual video bitrate code now has a minimum bitrate floor that is set to 40% of the max bitrate set. I am hoping this adds some added stability to live streams.

I've added shortcut keys for mute / video
-- CTRL + m / b , respectively
-- on macOS, Mute is Command + ALT + m

Custom TURN server settings via the URL now delete existing TURN servers as options

Spanish, Dutch, and German Added as supported languages (v9 release)

Improved the Electron App

-manually specify width/height on Windows via CLI; also the URL. See the github for it.

-Supports High DPI displays (better performance now)

-Notorized the app for easier installation

-Improved the github website documentation for it

Improved the VOLUME meter visualization

-disabled on iOS since it was causing issues there

-made it more sensitive, horizontal, etc.

Made some minor tweaks to audio and video bitrate functions; hoping to make the packet sizes more appropriate, etc.

if the server disconnects, during a live a stream, there won't be a popup error message.

-only if the initial connection fails will there be an error now

Added Multichannel 5.1 audio support

-experimental

-add &stereo=4 to both view and push links to try out

When the video preview loads during device selection, the audio is now loaded afterwards and not together.

-speeds up loading of camera and avoids the camera failing if caused by a failed audio device. (and vice versa)

Lots of other minor changes, but that is the meat of it all.

๐ŸŒ‹ ๐ŸŒ‹ ๐ŸŒ‹

Last but not least, I wanted to say thank you to those who sought out ways to help support OBS.Ninja. I haven't asked for donations, but numerous individuals have done so regardless. It's extremely thoughtful and it has motivated me to work on OBS.Ninja more than I ever thought.

A list of everyone who has contributed via financial sponsorship can be found here: https://github.com/sponsors/steveseguin

There has also been numerous users who have spread the gospel of OBS.Ninja to their colleagues, live stream audience, and others. It's been really rewarding seeing the userbase grow and to be provided with such fantastic feedback. Feedback is at the heart of helping me improve the service, so it is worth its weight in gold to me.

๐Ÿ™ ๐Ÿ™ ๐Ÿ™ ๐Ÿ™

Thank you, everyone.

-Steve Seguin


r/OBSNinja • • Dec 21 '21

Important OBS.Ninja rebranded to VDO.Ninja, which includes a new sub-Reddit: check it out

35 Upvotes

New sub-reddit link => https://www.reddit.com/r/VDONinja

--

Hi all,

You might have noticed by now that OBS.Ninja was rebranded earlier in 2021 to VDO.Ninja; this new brand better reflects the diverse userbase of the service.

Beyond the branding changes, everything has stayed the same, including that things remain 100% free. As part of the rebranding, some links and logos have changed of course, which are listed below:

While existing OBS.Ninja links still work fine, but please consider switching over to the new domain when possible; https://vdo.ninja. ๐Ÿ‘Œ At some point in the future, obs.ninja links will auto-redirect to vdo.ninja instead.

There's also a new sub-reddit, https://www.reddit.com/r/VDONinja, which replaces the OBSNinja-branded one. Please consider switching to that sub-reddit for recent updates and support.

The old Discord is still the same, but with a new server name and icon-image. A perma-invite link to that Discord is: https://discord.vdo.ninja , but a mobile friendly invite is: https://discord.gg/T4xpQVv Please join our Discord for daily updates, live discussion, and further support.

The GitHub for the site has been renamed as well, please see: https://github.com/steveseguin/vdo.ninja

Documentation for VDO.Ninja can be found at http://docs.vdo.ninja

Media assets for VDO.Ninja can be found here: https://drive.google.com/drive/folders/1gYfxKEvFbKl_UgHBT5PeGc5PJ-8yrGqW?usp=sharing

Kindly,
Steve

oh, and in case you were curious, Vee-Dee-Ohh is how we are pronouncing VDO, which is intended to sound like "video" when said out-loud. This name was selected based on community feedback and polling.


r/OBSNinja • • Dec 21 '20

News the Beta version of OBS.Ninja v14 is ready for testing

32 Upvotes

Hi everyone!

After a month of hard work, a new feature-packed version of OBS.Ninja is nearing release. The BETA version is ready for testing and I'm hoping to collect user bug reports ahead of the release.

This is not the official release, as that will happen in a few more days, but I'd value some added user testing to ensure a smooth release. Please feel free to start using the beta version of OBS.Ninja , perhaps for show rehearsals, to catch any new bug in the system.

The beta version can be found at https://obs.ninja/beta

You can find a list of the new features here: https://github.com/steveseguin/obsninja/wiki/v14-release-notes I'll be on Discord fixing known bugs in the mean time if you need me.

๐ŸŽ

Thank you everyone!
Have some happy holidays,

steve


r/OBSNinja • • Oct 26 '20

News Version 13 Released - change log.

31 Upvotes

Version 13 just released. ๐ŸŽˆ

** PLEASE DO A HARD REFRESH on your mobiles, in OBS, and in Chrome. **The main new feature in this release is probably the rework of the Director's control room. The ability to transfer guests from one room to another opens up many new possibilities for green-screening.

Thank you to the sponsors who have been generous to help me afford to offer OBS.Ninja as a hosted service for free. Also thank you to fellow Discord users for contributions, feedback, and bug testing. Thefluffytoucan in particular helped a LOT with QA and bug-hunting in this release, so if there is a bug still, blame him. ๐Ÿ˜œ

CHANGE LOG:

Fixed some issues related to the director muting audio in scenes; can't unmute unless stream has been added first, etc.

Added a new button to the UI that lets guests mute other videos when they are in a room

Stats/debug window does not stack anymore; previous windows if open get closed when a new one opens.

The stats/debug window can be opened on mobile by rapidly tapping on the video of interest 5 times in a row.

The option to share a video or audio file can be enabled with the &fileshare (&fs) URL parameter. The media will auto-loop and can be scrubbed by the publisher only. The viewers remain in sync with the publisher, including play-state and volume-level.

Fixed an issue in Firefox where the START button could be triggered by the stream was actually ready, causing failed connections.

iOS devices can no longer select a custom listening audio-bitrate; if set it will be ignored. This bypasses a bug with iOS Safari that could cause distortion or a failure. If problems still persist with audio on iOS, fully-restarting Safari can help.

The click-to-reveal Notes in the Director's room have been updated

Removed pop-ups from the Electron landing page to avoid freezes; instead a subtle message bar has been added to communicate messages.

Organized numerous app styles, text, and the Director Room layouts to be more accessible and templated for easier customization.

The &obsfix can now have a parameter passed to it that can control the threshold for automatic keyframe requests based on packet loss rates. Default is &obsfix=15, which applies to VP8 and VP9 codecs. Setting it to 0 will turn it off.

The VP8 codec, typically the default in OBS, has been adjusted to be 30% more sensitive to requesting a keyframe if packet loss is detected. This is all in response to a bug in OBS Browser Source as OBS related to packet loss management This is not present with the Electron Capture app or Chrome. You can try different thresholds with &obsfix of course though.

The VP9 codec will now be forced to request a keyframe now in OBS if the packet loss is very heavy. VP9 is not seriously bugged in OBS, but it can still fail to handle heavy packet loss. This added fix tries to address that edge case of heavy packet loss that might cause video corruption.

Added some code to try to handle the case where a video freshly added to a scene changes size by a single pixel. This is in response to some odd behaviour with Chromium-based browsers.

Fixed an issue on Android where if rotating the device's orientation, some videos might not scale to fit their containers correctly, remaining quite small.

Added a WAVEFORM style option for cases where &novideo or such is used. By adding &style=2, any audio-only guests will be represented instead by an animated green on black audio waveform. Please provide feedback on your successes using this.

If using &style=2, the "loudness" level of each video will appear in the Stats/debug page, as well as become accessible via the IFRAME API at a rate of about ~25 updates per second. I'll eventually make this info on by default, but more testing is needed first.

Added &style=1 as an option, which hides audio-only media elements from the group-mixer. This is enabled by default for scenes used in OBS, but not on by default for guests themselves in group rooms. (naming structure for styles may change in the future)

&maxpublishers now exists ( previously it was just &maxviewers). Limits the number of incoming p2p connections.

Added &randomize as a new parameter. Just makes it so videos in a room don't always load in the same order. If you set &maxpublishers, combined with &randomize, you can now get a random sub-sample of the room's guests.

&cleanoutput had some bugs that allowed for alert pop-ups when not desired. That's been fixed.

The &security parameter was made less verbose and it now applies to both a max of one publisher and one viewer; not just one viewer.

If using &audiodevice=0, you won't get an alert popup now if you don't select an audio-source when screen-sharing.

The ability to transfer a guest from one room to another room is avaialble now. Guests will not know which room they were transferred to, providing for a secure call screening method. Guests will revert back to the original group room if they refresh their browser.

Guests will recieve a message in the chat-log if they get transferred to a new room by a director.

Only the FIRST director into a room's control center will be able to transfer guests; at least until they leave.

Multiple Guests can be transferred by holding CTRL (or command) when selecting guests to transfer.

If in a room, a guest's stream cannot be accessed from outside the room. This is a change from the previous behaviour.

iOS devices will show up as a low-quality video stream in the Director's room now. 30-kbps or so. It cannot be changed until adding &forceios to the director's URL.

iOS devices will now broadcast video to everyone in the group room. It sends a 30-kbps low-quality video stream to all the guests, using the VP8 codec, while it still sends a 720p H264 high-bitrate stream to OBS. Previously iOS devices only shared audio with other guests, unless &forceios was used. Not ideal for larger groups or older iOS devices.

The settings slide-in menu is scrollable now; useful for small screens.

If a sender disables their video device, it now deletes the video track for viewers. This allows for &style=2 to be used as a fallback to something other than just a grey-spinning window.

IFRAME API improved with fixed mic/speaker muting logic. Toggle code, etc, works better and is more explicit.

The INVITE Generator has been tweaked. More hover-over tool-tips and the secure option was changed to "force default mic" instead.

The &label=VALUE has added value. The label's value shows up in the Debug/stats window, the title of the Browser's window, and in the director's room. Additional uses for the label parameter are coming, but not yet done.

If setting &label and leaving it blank, it will request a user for a name via a pop-up prompt.

Got rid of the &scene=1 in the solo links for guests in the Director's view. It is now just "&scene", without the added value.

If the app needs to change/santitize a user's input (password, room name, etc), the app will alert the user to the change. Remember, AlphaNumeric characters are supported; other characters might be replaced with an UnderScore or nothing.

Improved the sanitization of user inputs. More consistency and simplicity should allow for less chance of a mismatch in complex user-entered passwords, for example.

took a stab at making some IFRAME documentation, although it's pretty awful currently: https://github.com/steveseguin/obsninja/blob/iframe-api-docs/IFRAME.md

Unless &password=0 is set, passwords are enabled by default now, even if it doesn't look like it. This is because a default password is now set and that can be changed is self-deploying the code. There is also an added new "salt" value, which is dervived by the domain name of the OBSN deployment. This means that every deployment of OBSN will have its own unique encryption applied automatically. Due to the default password, handsshake messaging is now client-side encrypted by default, improving privacy and security.

Stream IDs and Room names are salted and hashed if using a password, meaning that if doing a self-deployment of OBSN, the chance of a stream ID or Room name collision should be virtually impossible with other deployments, even if using a silly stream ID like "test".

if you specify a custom password manually, it will be used to isolate the stream ID on OBSN, not just within the room. The previous behaviour had room-names hashed when passwords were used, but now this applies to stream IDs as well. This increases privacy and security.

The Director can use the hotkey CTRL-M (command-M) to toggle the mic on and off, once the director's mic option has been enabled.

The Director's voice-of-god audio cannot be easily muted by guests in a room.

Improved the &webcam/&screenshare so they bypass the first button and just load directly in. No animations or close buttons; just straight to it. This is helpful for IFRAME API development uses.

Screen-sharing as an option has been removed by default for Mobile devices, including iOS. It doesn't work there, so why show it?

The Director's room got a new layout and styling. Thanks to thefluffytoucan and jcalado for helping out here.

If you enter just "&push" without a value set for it, it will create on automatically for you.

The landing page's big buttons look like buttons to the cursor now; finger pointer as a cursor vs arrow, etc.

global volume control is available for group chats and directors. Mute is on by default for the directors room still, but this lets you unmute all videos easily. (Director's mic cannot be muted by guests tho)

I'm hiding audio-only sources from OBS Scenes by default now. They still show for guests by default tho.

This version 13 is not compatible with past versions.

Purchased a Google Pixel phone to help test some new features, like camera exposure. Stil a work in progress, but you can see what your aspects your mobile device supports here: https://obs.ninja/supports (iOS devices have very little support for anything).

Added the &hash parameter. It stores a 4-character hashed representation of the password, which acts as a pre-validation step in ensuring the user types in the correct password. It auto adds when creating a room or generating a custom link with the invite section. If the user's entered password does not match the hashed expected result, then the user will get an alert the password is wrong. It's not a 100% check, but good enough to deal with accidental incorrect password entries.

Added the hashed-password check to the OBS dock URL link generator page. Gets added automatically when setting a password.

The current OBSN version info is now accessible. It's viewable via debug/stats page or at the bottom of the main page in very fine black text.

NDI devices should now be listed at the end of the device list, rather than potentially first/default. This was done to avoid NDI Tools drivers crashing the browsers right off the bat. If you run into problems, just refresh now.

Disabled stereo audio for guest-to-guest audio (goal being to reduce as many complications as possible for guests as possible). Too many users were having their guests push proaudio to other guests, not knowing the stress and complexity this was causing. Does not impact what OBS gets.

set the default audio bitrate to be variable (VBR) for group-room guests in all cases now; even if a bitrate is manually specified.

Added the &stats parameter, which causes the stats window load immediately without user input. This is useful for VMIX users who cannot hold CTRL to trigger the stats window that way.

made the option to select no-microphone on iOS available

Made the HANG UP button icon red, instead of white, to help indicate it's function.

The main director of a room can force a publishing room guest to remotely hang up (the remote user can just rejoin of course)

The main director of a room can remotely change focus/zoom of a participant without needing the &remote command now.

https://Invite.cam auto-copies the created URL to the clipboard now.

Fixed a bug related to the help info button being unclickable

I've added code limiting the group-room audio to 32kbps. Director gets capped at 32kbps audio as well, unless stereo is enabled that is.

Fixed an issue with video disconnecting on Beta when audio sources changed

implemented code to 'beef up' the video bandwidth if the audio is set very high. There was a bug that caused the video bitrate to drop if the audio bitrate was too high.

Improved the error messaging for when NDI craps out on Chrome. (10 second timeout before error now; vs 15s)

Created several more Youtube videos related to OBS.Ninja, such as guides. A playlist can be found here: https://www.youtube.com/watch?v=6R_sQKxFAhg&list=PLWodc2tCfAH1WHjl4WAOOoRSscJ8CHACe

added the ability to select audio and video device via the URL, by specifying a text phrase. Spaces can be represented by a "_" underscore character. Capitalization does not matter. &audiodevice=usb_preamp or something I guess

Figured out the bug that was causing the audio device to fail if the video device also failed on load.

updated the style for the preview video element; height is now consistent despite device selected.

Added the ability to change the background color to a HEX color code: &chroma=0fa or &chroma=ff00aa (black by default)

added a viewer-side keyframe control param. This essentially tells the remote publishers to send keyframes at a specified rate. ie) &keyframerate={milliseconds between forced keyframes} You don't need to be using OBS or VP8 to use it, and it is disabled by default, but it will reduce visual quality if set to a short interval. Useful if packet loss is really bad I guess?

added support for Firefox drag-in-drop LINKs from the director's room into OBS

Added a visual icon to let you know drag and drop is working; Chrome specific. Not all links are draggable; just those that can be used in OBS.

captions.ninja -> caption.ninja (bought the domain ; forwards, to avoid mistyping) Also fixed a few styling issues with the site.

You can set the TITLE of the Tab now using the &label command: ie) https://obs.ninja/?label=SomeNameGoes_here

New TURN servers in North America and Germany were deployed; these will replace the previous ones. These are also TCP-based by default and have a more reliable paid SSL certificate used.

&effects=x are added as well; 1 is face align and 2 is mirrored video. BOTH are experimental and are not fully fleshed out yet. &effects=1 requires Face Detection turned on in the Chrome experimental flags.

an initial guide on how to use OBS.Ninja for teleprompters (and how to mirror while full screen) : https://docs.google.com/document/d/e/2PACX-1vTcu1bsSLSSWZDAp6Csrbs9WHeYnNSobbY6sVzVATVrOFfzygDzCBrAyXynzHACbO7U4aLUlPdUnrsd/pub

&buffer and &sync work correctly now. &sync by default will enable &buffer=0 and offer a way to set the audio delay without impacting the video delay. &buffer will delay both audio and video, with the goal to improve lipsyncing and reduce packet loss. &sync works in OBS, but &buffer does not. &buffer only works in the Electron Capture app, VMIX, or Chromium-based browsers. &sync can accept values typically in a range from around -50 to 500 (milliseconds).

Russian Translations updated on production via KovalevArtem

There's new stat in the stats/debug menu, which shows how out of sync the video and audio is. I improved the stats menu; added some things like round-trip ping time, an reason why the connection sucks (bandwidth, cpu, none, etc), and some other random things

Wrote a quick reference guide for getting high quality streams with OBS.Ninja -- very basic and for beginners.

https://docs.google.com/document/d/e/2PACX-1vSR_J_n65_TEttaH1m4djpxO1VftQI30Dp1oXoTKxLAMTyR6LqB-Eq25rGEDuYaI9Yo-Xfrfaqh8X7B/pub

Updated the electron app so it requests mic/webcam permissions. v1.1.1 This allows for it to be used for publishing; not just capturing.

ordered a 6-channel mic source to let me do more troubleshooting on the 5.1 multi channel audio support. Still working to improve multi-channel audio support.

Increased the time before retrying to connect to a stream if the publisher disconnects. This avoids a potential race condition.

Added some new actions to the IFRAME page. Events for:

-starting to pubilsh a camera

-starting to publish a screen share

-having a new inbound connection start

-having a new outbound connection start

-acsess to loudness level of each guests' audio

๐ŸŽˆ ๐ŸŽˆ ๐ŸŽˆ ๐ŸŽˆ ๐ŸŽˆ

Anyways, I wanted to get this release out today as it is my Birthday. What better gift I say.

Thank you everyone.

Kindly,

Steve


r/OBSNinja • • May 22 '20

News New Version Released: performance improvements, more advanced features, & bug fixes

30 Upvotes

It's been two weeks and a new slew of updates for the site has just been released. New features include added reliability, tally-lights, group-room performance, and added parameter options.

You can find the old version still up at https://obs.ninja/v4/ if you find yourself suddenly facing new issues. Please also be sure to hard-refresh your browser and clear the cache in the OBS Browser source.

Change Log - v5

  • The Electron Capture app (designed for Window capturing mainly) lets you select an Audio Output Destination now when viewing a stream. This is useful for directly outputting to a Virtual Audio Cable.

  • You can access the Electron app's interface also via https://obs.ninja/electron, which may be useful for things outside of window capturing.

  • Initial Localization support was added. In the bottom right, you can select between French and Russian now. You can also set the language via a URL parameter. &ln=ru

  • You can Disable the TURN server now using just &turn=false. This is useful for debugging.

  • You can remotely control the zoom of an Android camera. Use the mouse-wheel over the video you wish to zoom in/out of. Both the viewer and the controller needs to have the parameter &remote=ourpasscode added for it to be work. This is a security precaution. Also, remote focus *may* work; the same as with zoom, except you hold CTRL (or Command) down while scrolling over the desired video.

  • There are two TURN servers available now; West and Central. They will be selected based on lowest latency to the peer, if needed at all.

  • Holding CTRL (or command) down while LEFT-Clicking on a remote video you are viewing brings up a debug menu. This debug menu will list stats, like resolution/bitrate, but will also list if you are connected to a relay (TURN) server, or not.

  • Re-worked the Buffer command to work with audio now. &buffer=0 will force the audio to be in sync with the video. This is supported on Chrome v76, which implies not yet supported by OBS. Increasing the buffer higher than 0-ms will help ensure consistent latency and reduced video corruption. &buffer=300 could help to keep remote lip-sync performers in-sync perhaps and avoid odd audio Darth Vader effects (that might occur if buffer is set to 0)

  • Added the ability to "MUTE VIDEO" when sending video. Privacy and performance optimizations.

  • Tips/hint windows can be hidden again after usage

  • Improved the audio-selection drop-down. Only 1-device can be selected at a time, unless you hold CTRL while selecting, then you can select multiple.

  • Added the control-bar back to videos previews in solo-link mode.

  • Added an "error page" to users using OBS for MacOS v25 via Browser Source. Tells them to downgrade to OBS v23 or use the Electron app, with links to the wiki support.

  • Added "tally lights" to the Solo-link video sender pages. This is based on whether OBS tells OBS.Ninja if a scene is active or not. Red = visible. Doesn't work until the first scene change, but useful for knowing when you are moved on or off air. [&obsoff on the OBS viewer link turns them off for everyone]

  • Optimized the video feeds in the group chat; much better performance now. Limited resolutions, unless manual-override.

  • When you have &optimize set as a viewer parameter, if a stream is not visible/active in OBS the bitrates will be reduced to 600kbps. This is mainly there to help with reducing computer load.

    • [Update: This does not apply to iPhone users. This feature is now off by default, unless you add &optimize now; this was based on user feedback]

  • &noaudio and &novideo will prevent a guest room member from seeing or hearing other member's audio or video feeds. Useful for audio-only group chats when network or CPU performance is proving to be limited.

  • Made changes to the "camera setup screen". Added a GEAR icon to hold the advanced resolution parameters.

  • You can now select a resolution in the screen share; 1080p and not just 720p anymore.

  • Better re-connection management if disconnected; not yet perfect though.

  • You can use the &quality command to preset resolutions for a guest via their guest invite link. To clarify, there is quality 0, 1, and 2. 0 is about 1080p, 1 is about 720p, and 2 is about 360p. Restricting the resolution can help improve frame-rates and reduce CPU load.

  • iOS devices do not push video into the group chat itself; just into OBS/directors room. This is because iOS has a limit of 3 streams it can publish. &forceios disables it.

  • Fixed bug where iOS device may go to sleep if "no audio" is selected.

  • It's possible to invite someone to a chat room name with the short-form: https://obs.ninja/myroomname You don't need to do the ?room=xxxxx with this method.

  • You can access the control room for a Group Chat by doing https://obs.ninja/?directors=myroomname This lets you now refresh the director's room if needed, even if mute states and unsaved video recordings will be lost,.

I'm sure I've forgotten some things. Please report any and all bugs, especially new ones, please. I'll update Youtube video and the wiki page in due time.


r/OBSNinja • • Jun 28 '20

News Version 8 just released; see the change log here.

27 Upvotes

Version 8 has just released. This change log contains some updates for v7 as well, as v7 was mainly silent infrastructure improvements.

As always, please clear your browser cache in OBS and in your browser if there are problems. This version is not backwards compatible. If problems persist, the previous version can be found at https://obs.ninja/v7

The focus on Version 8 was on UI/UX improvements, bug fixes, and adding some simple feature request.

For reference and details, all the available advanced URL parameters can be found on the updated wiki page: https://github.com/steveseguin/obsninja/wiki/Advanced-Settings

Change Log

  • There are new shortened aliases for most the URL parameters. &view=abc can be typed as &v=abc now, for example. This was done to both allow for obfuscating the URL parameters for links given to guests, but also to allow for shorter links. See the Wiki for details.

  • There is a password feature now. It applies to both rooms and stream IDs. It's a bit crude at present, but if you add &password to the URL as a viewer, director, or pusher, your room and streams will be made inaccessible to anyone who does not also enter the exact same password. Passwords can be entered as the parameter value or you will asked via a popup message prompt.

  • The &secure feature was fixed and improved so that it can support many of the other newly added features. It is useful for one on one conversations that require extreme privacy precautions. It should be compatible with the password feature as well.

  • Added language translations were added thanks to user contributions. The translation system in general was improved and more tools are available to make updating and adding new translations easier. Portuguese and Italian were the newest additions.

  • &icefilter=tcp was added to let users filter out ICE candidates that are UDP-based. This is mainly for debugging and testing for those deploying their own TURN servers.

  • If a user on macOS tries to use OBS.Ninja inside OBS v25 or Streamlabs, they will get an error message with help information. By adding &streamlabs to the URL, that error page will be removed and macOS users using StreamLabs can still try to do so.

  • Although persistence links exist, as per user request I've created the &sticky parameter option that will let a user store their session parameters. The next time the user visit OBS.Ninja, they can auto-load those previous settings, including push and room IDs, from a saved cookie file.

  • If a user fails to connect to the TURN server, which seems to happen occasionally for users that require it, the system will now auto-retry. This mostly fixes an issue with Group chat where not all guests load for all other guests.

  • Audio echo cancellation can be manually and individually turned on or off now via &aec URL parameters. The same goes for auto audio gain (&autogain) and audio noise reduction (&denoise)

  • &webcam and &screenshare will hide either the screenshare option or the webcam option for guest, when appended to their invite links. It helps funnel them to the options you want.

  • &maxvideobitrate can be used by a stream publisher; it sets a hard limit for a viewer so they cannot request a video bitrate higher than that of specified. 2500-kbps is the default.

  • For those wishing to limit the number of viewers of their stream, there is also the &maxviewers now. If the max is hit, other view requests will be ignored. It takes about 10 to 20 seconds for a disconnected users's connection to fully drop, so if you are at max already, you may need to retry connecting 20 to 30-seconds later.

  • If you press CTRL (or Command) AND Left Click your own local video during a stream, you will be shown stats that say how many connections you have; both inbound and outbound streams.

  • If you press CTRL (command) and Left Click on a remote video you are viewing, you will see added stats now; bitrates, but also the type of video codec being used and packet loss data. High packet loss can result in rainbow puke looking video; using VP9 can help resolve that.

  • Fixed a bug with custom bitrates when used with the VP9 video codec. VP9 with custom bitrates will use up a lot of CPU power, but it tends to not suffer from rainbow puke.

  • You can specify the designed audio bitrate now, individually, using &audiobitrate. 60-kbps is the default for mono, while 256-kbps is the default for stereo. 1024-kbps is the coded hard limit.

  • &scale can be used as viewer of a stream; it will request the publisher send video at a scaled down resolution. If the publisher has their max resolution set to 1080p, and you as a viewer set &scale=50, you will only receive the video at a max resolution of 540p; 50% of what is available. This can help give the OBS-side viewer more remote control over resolution and frame rates.

  • &mirror and &flip are commands for the viewer that flips and mirrors the video playback.

  • &optimize, if used in OBS, will have videos that are not active scale down in resolution and bitrate to 600kbps or so. Instead of disabling the Browser Source when not active, you can use this to just reduce the bitrate and CPU load, and it will automatically recover to full bitrate/resolution within about a second of being active again. By default, this feature is off.

  • The TURN server can be forced off with &turn=off now

  • &sink and the electron app lets you specific output audio devices.

  • &channels=8 will tell OBS.Ninja how to upmix audio tracks. This is useful when used in conjunction with &channeloffset

  • &channeloffset=N lets you shift audio from channel 1 to channel N. This is useful for routing audio from Chrome or the electron capture app directly to a specific channel on a virtual audio capture device, like Voicemeeter on Windows.

  • The auto-mixer (for group scenes) works better now; about 30% more efficient with spacing videos out, although it is still optimized for 16:9 aspect ratio videos mainly.

  • Vertical video in the director's room is handled better

  • It's possible to record multiple videos in the director room at a time now; not just one. If you run out of RAM though, the system will crash, so this is still considered experimental.

  • You can start the recording of several videos in the director room at once by holding down CTRL (or command) when pressing "Record" on each video. Defaults bitrate to 2500-kbps per video in this case.

  • The faux FullScreen icon is improved; lots of changes related to that

  • You can now actually full screen videos natively

  • New icons are used; transparent and line-based is the new theme there.

  • A HANG UP button has been added to streaming page now. Press it and all the connections close and the page clears.

  • You can create faux chat rooms by using a combination of multiple view IDs and a push ID. I fixed some bugs related to this feature. https://obs.ninja/view=guest1,guest2,guest&push=guest4

  • Faux chat rooms now work with custom bitrates; normal group "rooms" though have a bitrate that cannot be set by guests themselves.

  • Guests can no longer pause videos.

  • Your own local video stream does not show the control bar anymore -- this prevents guests from unmuting themselves and creating feedback during live streams

  • Stats get updated ever 3 seconds, instead of 5; Buffer sync code also updates more often now. Videos that are not playing also will auto-play with checks every 3 seconds. (user interaction is still needed to trigger this in Chrome)

  • Got rid of the large glow around videos and replaced it with a thin border. This thin border can be used for the tally light feature. In OBS, if a video is toggled into visibility, the guest of that video will see a red border around their video. This indicates that they are visible in OBS and that they may be on-air. It is experimental and can be disabled with *obsoff

  • An error message is given to those with NDI Tools problems when selecting a camera; after 20 seconds it will fail with an error message. Uninstalling NDI tools or updating NDI tools or using Firefox are solutions for now.

  • Lots of UI/UX polish to numerous places, including rounded edges, easier to read fonts, softer colours, etc.

  • If a connection to the handshake server fails, it will retry in 15 seconds, but it will also give a warning that it failed. This error message is mainly to help alert users that they may be blocking the required port to access the service.

  • Created the https://obs.ninja/dock file that can be added to OBS to help auto-generate invite links for users. The drag-into-OBS function has been improved.

  • Removed the messages that a user is trying to use your streamID; or at least I only show it once.

  • &cleanoutput is now set to hide a lot of error messages and text; useful if you want no error messages or text when doing a live stream in OBS.

  • Fixed an issue with iPhone 6s cameras

  • You cannot pause videos anymore; they will always auto-play if there is a user gesture. Auto play happens every 3 second or less, if event driven.

  • Overlay buttons are generally smaller; &cleanoutput will hide them also

  • State sync remains an issue with adding users to scenes from the Director's room, but you can now hold CTRL (or command) when pressing a button and it will re-issue the existing direction/command ; instead of toggling. This is useful if you wish to sync a scene without having to toggle a video in another scene also.

  • The group room video quality logic is now dependent on how many users are in the room. 1 guest is 300kbps each; while 4 guests is 120kbps each; and etc.

  • Managed to get NDI Tools to work in some more scenarios, but not all.

  • You can pass URLs via command line to the Electron Capture app; v1.0.2 via github releases if you wish to try it.

  • videos load faster when requested and load faster after a disconnection event.

Whew..., well, I'm sure there are lot more things I've forgotten to mention, but this is about 2 weeks worth of progress. I am heavily inspired by user feedback and requests, so please feel free to send your thoughts my way. You can also add issues or requests directly to the Github repo (as an issue); this is the best way to contribute bugs or requests, but I welcome them any way I can get them.

Please let me know if there are any issues or bugs with the new v8 release and I'll have them addressed asap. Thank you everyone; your support has been amazing.

-steve


r/OBSNinja • • Sep 13 '20

News OBS.Ninja Version 12 Released -- change log here.

26 Upvotes

Version 12.0 of OBS.Ninja has been released to production. โœจ

The previous production version is located at https://obs.ninja/v11. If you find any bugs with v12, please report them so I can fix immediately.

Please also ensure you clear the browser cache in OBS and hard-refresh in Chrome to avoid any conflicts.

๐Ÿ Change Log since v10

tl;dr; In this release I mainly tried to improve the connection reliability of the group rooms, added features to the Director's control room, added new URL parameters, and improved system scalability.

  • The title of browser windows are now dynamic; they update to reflect the video or room you are viewing

  • Alternative languages have been updated with more text and more language options

    • fixed a bug with the translator as well, where undefined appeared at times.

  • Direct linking to Google caching servers has been removed for some OBS.Ninja dependencies

  • &showonly=XXXXX is now an alias of &novideo

  • ICE Candidates are bundled up on transmission and sent p2p if possible

  • Validated that using the Electron Capture app to Screen Share into Zoom produces higher quality results than using VIrtualCam with Zoom

  • Wrote additional guides, including how to do 4K via OBSN. See the Wiki's Guides Section

  • New TURN servers deployed; Quebec and Germany. 10x capacity of current user usage.

    • New TURN servers now support TCP/443 for increased user-compatibility

    • Fixed some bugs in the TURN servers that were causing hiccups with some connections

    • TURN servers have had their SSL certificates upgrade to premium paid versions - 5 years lic

    • Created a more detailed guide on deploying your own TURN server; see turnserver.md on git

  • Moved the text captioning tool to http://CAPTION.ninja

    • Added language support to Caption.Ninja and removed Google Fonts hosting from site.

  • FAQ and Wiki updated; were out of date before. https://github.com/steveseguin/obsninja/wiki/FAQ

  • Small update to the text on the director's room's help page

  • the Stats debug menu has been updated (CTRL + Left-Click on a video to access)

    • stylized, organization, added detail, etc. (thanks to those who helped here)

  • Added TEXT CHAT to the Director's control room

  • Added a PUSH TO VOICE TALK to the Director's room

    • does not appear as a media source in the OBS Scenes. Just to the guests

    • you can push audio or video; changing the input source via the settings option

  • Added Twilio TURN server support, although only added for private debugging use

  • If a connection error occurs with a weakly-connected room guest, reconnection is more aggressive; this hopefully will combat the rare case of a lost room guest for only some people.

  • Added a fourth link to the Director's room using the &scene=0 parameter.

    • scene = 0 will automatically added any new room guest to this group scene for OBS, as they join the room.

    • conversely, the older scene =1 required videos be manually added via the Add Video to Scene button.

  • Added &hideheader as a URL option. This parameter hides the top header bar, including OBS.Ninja branding. Useful for making videos even larger when viewing them as a guest.

  • Fixed a bug with &novideo and &noaudio where before, when changing camera sources, things reverted back to showing video when it should have remained disabled

  • &novideo and &noaudio now work in the Director's control room

  • StreamID for guest videos are shown in the Director's control room now

  • Improved UI for the video previews in the director's control room

  • The Create Resuable Invite page has been cleaned up a bit -- via jcalado

  • Added a URL flag that disables the local self-preview. &nopreview

  • Added a 'test tone' to the camera selection screen for audio devices

  • The provided speedtest auto skips a few steps in camera selection.

  • &quality=0 works better now; was a bit bugged and didn't always do 1080 in screenshare

  • Screen sharing also works with 60-fps now by default; quite smooth

  • Added the &roombitrate=X parameter:

    • If X == 0, then no video is sent out to other video guests

    • If X > 0, then it sets the max video bitrate allowed to be sent to other room guests

    • Useful if you are on a mobile device or slow computer and want to reduce load

  • Added some advanced audio settings that can be set via URL parameters

    • &maxptime=60 (max packet size of audio in ms)

    • &minptime=10 (min packet size of audio in ms)

    • &vbr (sets audio bitrate to variable, instead of constant, when bitrate specified)

  • This page has been updated; https://obs.ninja/dual. It lets you screenshare and webcam share at the same time within the same tab, using Iframes, although it isn't user-friendly yet.

  • Updated the &mirror URL flag to have 0, 1, 2, and 3 as options.

    • no mirror parameter in the URL is the default. Local previews are mirrored

    • mirror=0 turns off ALL mirroring, for everything.

    • mirror=1 inverts the default. Local previews are not mirrored, but guests are mirrored.

    • mirror=2 mirrors ALL videos

    • mirror=3 is the same as default, except the entire website is mirrored, including Text (useful for teleprompters?)

  • &mute (or &muted) URL parameter added, which sets the mic of a guest to mute by default

  • Chat support was added to the iFRAME API

  • Chat was improved to support more special characters, without hurting security

  • I also added a &hidemenu parameter, so if used in conjunction with &autostart , you'll bypass the camera selection wizard faster

  • The publisher of a stream can see more details of the connect viewing peer, and vice versa.

    • user-agent, parameter settings, etc

  • Created https://obs.ninja/supports, which shows what your browser / camera supports

    • Focus and Telephoto zoom are supported by OBS.Ninja, if your camera/browser does also

  • Made another alias for &stereo; &proaudio

  • Created a linkedin page for OBS.Ninja.

  • Made some tweaks to the rtc.ninja -- removed branding. It's an alternative domain to OBS.Ninja

  • ... and many numerous other issues and CSS improvements

The electron capture app has also been updated -โšก v1.0.9

  • Always on top toggle option

  • Audio output auto-loads now

  • URL parameter to set always on top and window title

  • right-click to change page, refresh, open new window, or change window resolution to preset options

  • Window Title increments in value as new windows are made

I'd like to thank everyone for reporting bugs and providing user feedback. For the next release cycle I will be investing more into building out better testing systems and trying to nail down strategies to ensure long-term reliability of the site and its features. I'll also continue to improve the support articles and support tools.

Also, thank you to the sponsors of OBS.Ninja. Contributions do help me afford the TURN servers and other expenses, like SSL certificates and domain names. A list of some of the sponsors are here: https://github.com/sponsors/steveseguin

Thank you. โค๏ธ

Sincerely,

Steve Seguin


r/OBSNinja • • Nov 24 '20

News Version 13.4 of OBS.Ninja released - Change Log Here

25 Upvotes

Newly released Version 13.4 is another minor update release ๐Ÿ’ฅ, mainly focusing on polish, stability, and a few new features. (November 24th).

As always, please report bugs ๐Ÿ› and share feedback. ๐Ÿ’Œ In case of new problems, please note that the previous version, v13.3, can be found at http://obs.ninja/v13 for now, and v12 can be found at https://obs.ninja/v12 If serious problems occur, the backup deployment can be found at https://backup.obs.ninja

Change Log ๐Ÿšง - v13.4

  • Added the ability for the Director to send TEXT messages as overlays to specific performers. Font size is nice and large; each message lasts for 3 to 8 seconds on screen. Can be disabled with the added bell icon. ๐Ÿ’ฌ

  • Using &device=0 gives the user no option between webcam or screenshare now; just a join now button.

  • Some issues with "permissions not accepted" timeout errors fixed, especially when &webcam flag is used or when no audio device was found

  • Android-based Smartphones can use the "torch" or flashlight now; turn on via settings menu when the rear camera selected.

  • the Electron App's top-drag-bar-region has a minimum height now, so its easier to drag even if a very small window.

  • http://linkgen.obs.ninja/ has been created by a community user; a wizard-like interface for creating invite links. [work in progress?]

  • A community user-made quick-start / cheat sheet guide has been updated with automation workflows; Mac user-focused: https://github.com/steveseguin/obsninja/tree/quickstart

  • Improved compatibility of the Exposure/Focus controls for webcams/android devices, available via settings. (manual/continuous drop-down options were added)

  • Manual camera controls hidden behind a "Show Advanced" drop down menu now

  • Czech-language translation added (user contributed; thank you)

  • The &broadcast flag ๐Ÿ“บ was introduced. If added to a guest invite link, that guest will only be able to see video pushed by the director. (no website header and no video self preview either). You can also specify a stream ID manually (instead of the director) by passing it a value; &broadcast=STREAMIDHERE. Guests will be able to hear each other still; just not see each other, which reduces CPU/Bandwidth requirements for guests. This flag doesn't create new functionality; just simplifies existing functionality.

  • &noheader is now an alias of &hideheader

  • I changed the "faux full-screen" icon to a pair of glasses ๐Ÿ‘“, which I hope makes its purpose more clear

  • I changed the Director's room access to iOS streams to be h264-based by default, rather than VP8-based. I had it set to be VP8, but it broke the record-video function, so I've changed it back to h264.

  • You can change the bitrate of video previews as a director now from 0-bitrate, 50-kbps bitrate, and 1200-kbps bitrate. Three buttons are available per video to do this dynamically. 0-will FREEZE the video track as a result; might reduce some CPU/network load on guests by having the track paused like this if not needed.

  • On newer versions of Chromium, (86/87), there does seem to be support for Hardware Encoding now, although it is still highly experimental. It sometimes will trigger if &codec=h264 is set, and if the video resolution is higher than ~360p. Just noting this; it's not officially supported yet tho.

  • Added a new TURN relay server; located in US Central. Things are starting to get expensive, lol. Thank you to those who have donated; it takes the sting out. โคโคโคโค

  • &audiodevice=XXXX and &vd=XXXX device filters match device labels based on string 'contains' rather than 'starts with'.

  • Users can select the audio output destination now by label name instead of &sink=device_id; &outputdevice=NAMEHERE ๐Ÿ”‰ (alias &od)

  • Some JavaScript libraries were moved off of public CDNs and are now hosted locally instead

  • Changed redirecting MS IE users from Chrome to MS Edge instead.

  • On iOS, if using Chrome, I now give you a warning about Chrome on iOS not being compatible.

  • Updated https://obs.ninja/?fileshare so that the file sharing option will let you select multiple media files. Hold CTRL or whatever to multi-select multiple media files to play.

  • Updated the Electron Capture app; mac-specific issues fixed mainly.

  • Fixed an issue where &turn=false wasn't working as expected. Setting to false disables the TURN servers from being used.

  • added a bit of URL auto-correction code. If a user starts the URL params with & instead of ? the system will auto-fix it. Same goes if they forget to add a ? to the start entirely.

  • Lots of other minor changes; FPS-stat on Electron app, permissions bugs, UI tweaks, typos, etc.

Regarding the IFRAMES API ๐Ÿ‘“

  • added &manual as a URL parameter option, which disables the auto video mixer if used. This is mainly for IFRAME API users who want to perhaps control the video layouts themselves.

  • added an IFRAME API command that will allow for dynamic disable/enable control of the auto-mixer

  • added a way to specify a video by stream ID via the IFRAME API to set a custom style for the video; allows for dynamic stylings to videos (all-videos or one specific one at a time)

  • added a way to add or remove a video by stream ID from the mixer area.

  • added a way to list all available streamIDs and labels via the IFRAME API

  • added an IFRAME API function to change the innerHTML/text of a specified HTML element.

  • added the ability to insert custom CSS styles via the IFRAME API

  • Added the ability to mute the video (black it out) via the IFRAME api.

(samples of these changes added to the dev iframe sandbox page; https://obs.ninja/iframe)

Final words,

I've had a lot of great feature requests lately; apologies if I didn't get them all out this release. Staying ahead of stability issues has been the priority for me this month. More features coming though.

๐Ÿ™ Thank you to everyone who has helped with user support on Reddit and Discord this month; it has freed up time for me to get some sleep. Thank you to Chris for the detailed beta-testing. Thank you sincerely to those who have donated to the project. And also thank you to those who have shared OBS.Ninja with friends, family, and followers -- OBS.Ninja is growing and it's all thanks to you.

๐Ÿ“ˆ ๐Ÿ’— ๐Ÿš€


r/OBSNinja • • Feb 12 '21

News Raspberry Pi to OBS.Ninja code available for testing

22 Upvotes

Hi all,

As part of an effort to increase device support for OBS.Ninja, I've released some basic code that should enable users to publish video into OBS.Ninja using embedded devices like Raspberry Pi, Jetson, and other Linux systems.

Code can be found here, along with a downloadable image for a Raspberry Pi that has the required components for quick deployment. https://github.com/steveseguin/raspberry_ninja

What's special with this approach is that it can leverage the hardware encoders of these small embedded devices. Making your own streaming 1080p30 camera for under $50 is feasible with this approach.

This code is still early days and will require more development before it is ready for production. I welcome other developers to contribute to this project and to help me Ninjafy everything in reach.

๐Ÿง ๐Ÿง

-steve


r/OBSNinja • • Jul 07 '20

Appreciation OBS.Ninja Success Story: AWS Community Day Online

22 Upvotes

I just wanted to pass on my thanks for OBS.Ninja and explain how we have been using it.

AWS has User Groups in Australia who normally have in-person events, but this year we had to move online. The organizers decided to use pre-recorded presentations, but to bring the presenters onto the stream for Live Q&A. The hosts for the event would also present live.

We accomplished this while working remotely with:

  • OBS running on an Amazon WorkSpaces virtual machine, ensuring consistent bandwidth

  • Per-recorded videos playing from VLC via NDI to OBS: Newtek NDI plugin

  • OBS.Ninja bringing live guests into OBS via a Browser Source

In addition to adding live speakers, we used the OBS.Ninja virtual room to talk amongst the hosts and the producer controlling OBS. While videos were playing, we could all co-ordinate what was happening in the next live session. Also, while the presenters were 'live', the producer remained visible to the hosts in OBS.Ninja (but not on the stream), and could signal to the hosts when to start/end their segments (just via video -- the audio was muted).

This setup was then reproduced for a later event where we ran two parallel tracks, so everything was duplicated. Here's the control room:

Findings:

  • OBS.Ninja worked extremely well.

  • Some presenters had to play around to get their video and sound working (refreshing the browser page often helps)

  • Some presenters had bandwidth issues that made their picture freeze or look strange at times, but the sound kept coming through and the video self-corrected

  • The 'Manager' page occasionally froze and needed to be refreshed

The presenters were from all around the world (Australia, Netherlands, Singapore, Finland), with no notable impact based on location.

Some presenters made 'virtual cameras' through local OBS instances.

We also used screen-sharing to show slides. The presenter simply opened another browser tab and selected their presentation. This took a bit of playing around because the PowerPoint window changes when it is being 'presented'. We changed to Windowed mode and shared that PowerPoint window.

Here's one of the streams: https://www.twitch.tv/videos/672360802

Thank you for OBS.Ninja!


r/OBSNinja • • May 07 '20

News New Version released today, along with new features and bug fixes.

20 Upvotes

I've updated OBS.Ninja today. Hurrah!

Please do a hard-browser refresh on the main site, and also in OBS, to enable the changes.

Please note that the last version can be found here: https://obs.ninja/v3/
For future reference, the current version's archive can be found here: https://obs.ninja/v4/

If you have issues with the new version, please report them and I will try to debug over the coming few days. I have had the beta up for testing all week, and I thank the beta tester who have helped me test.

Some of the notable changes revolve around fixing issues with the Group Chat, refining the UX/UI, adding stream iso-recording, enabling camera zooming on Android, and allowing users to select multiple audio sources, disable audio, or disable the video.

Change list

  • Audio can be disabled and/or mixed with more than one audio input device

  • video can be disabled, allowing for audio-only publishing

  • avatar silhouette takes the place of a stream without a video

  • Some Android cameras can now zoom-in with a swipe up action.

  • The Create Invite Link option lets you select some advanced parameters, like bitrate and stereo, in a very easy way.

  • reduced the size of the preview window ; for camera and screens hare

  • made all OBS/invite links easier to copy, dragged into OBS v25, and seleced.

  • Most OBS/invite links can be right clicked to access custom menu

  • copy to clipboard links that are clicked

  • Viewers in Group Chat can magnify and increase the bitrate of one video at a time.

  • Pseudo-Fullscreen works in group chat now

  • Room names can be accessed via https://obs.ninja/myroomnamehere

  • You can record videos via the group control room; selectable bitrates. webm Format

  • filename of recorded files is the timestamp of the ended recording time; milliseconds

  • new iOS error messages

  • firefox shows camera labels now

  • Add a "secure" mode that increases verbosity and prevents a stream being accessed more than once

  • electron app interface works with the production code

  • It is harder to hit 'ready to go', before the camera is actually ready

  • expanded help information in a less annoying way

  • if you deny Screen-share permissions, it will let you try again without a page refresh

  • Custom generated invite links, if dragged into OBS v25, will be named according to the given label

  • Got rid of the cartoon cat; too much visual complexity

  • Numerous UX changes to the Control Room page

  • Codec remains set at VP8, but progress in OBS has made on its issues.

  • Added a new TURN video relay server to US West (LA). I've also increased the capacity of the existing US-Central server. 16x more capacity over all.

  • Video Control bar hidden in more cases; or delayed in showing

  • Increased readability of some fonts

  • Improved mobile layout and accessibility

  • Mute/Unmute button has been made more secure

  • No need to toggle mute in group chat to get the audio to work

  • pressing enter on input fields auto submits; no clicking needed

  • Dynamic bitrates improved

  • Group automixer improved a bit

  • no-cursor option works with Electron app now

  • cleaned up the Error page in OBS if it fails to load a video; no more 'leaked' streamIDs

  • renamed streamid, permaid, and roomid. They are now room, push, and view. backwards compatible tho still.

  • Invite to Room page is more mobile friendly and clean; less noise

  • iPad Pro treated like an iOS device; limits resolution to 720p

  • rounded corners of the big buttons because "looks more modern". ;/

  • and many others that I likely forgot about

As more users begin using OBS.Ninja for production, I'm making a greater effort to ensure releases are secure and tested. Updates seem to now be happening every two weeks, which allows for a week of rapid development, and then a week of polish and testing. Newly introduced bugs should be worked out over the coming days, if any exist at all. Thank you for your patients and understanding.

Thank you all for your interest in OBS.Ninja. It's been a blast so far.

stay awesome,
- Steve Seguin


r/OBSNinja • • Aug 19 '20

Appreciation this is amazing!!!

19 Upvotes

thank you very much, I hope to learn to master OBS Ninja!


r/OBSNinja • • Jan 20 '21

Appreciation Thank you!

18 Upvotes

Hi Steve, just wanted to drop in and say thanks for everything you've done with OBS.ninja. Reading through all the questions here you're alway extremely helpful. I'm completely new to OBS and have only used it a few times and was looking for something exactly like OBS.ninja, I'm still playing around with the parameters and settings but definitely look forward to using this more.

Thanks again!