Platform Specific Issues

FAQ

Project Information and Support Links

web service URL: https://OBS.Ninja project development URL: https://github.com/steveseguin/obsninja developer/maintainer: [email protected] donations: via GitHub Sponsors

Community Support

Discord: discord.gg/EksyhGA Reddit: reddit.com/r/obsninja

Where can I get support?

The preferred support mechanism is via Reddit or Discord, which offer community-assisted support. Development issues, feature requests, and bugs are tracked on Github. For mission critical support issues, or business-related inquiries, you can contact Steve directly.

Where can I report a bug?

It is most helpful to report bugs via the official Github. While we monitor the Reddit and Discord channels, it is easy to miss issues/details that occur in comments and older threads.

Group Chat (aka, a room)

The group chat feature creates a virtual room where multiple devices can connect to share audio and video. It offers echo-cancellation and text-chat support as well. A room's ‘director’ can manage the guests from the control room, easily accessing individual sources for integration into OBS.

How does Group Chat work?

  • Guests have their own link to join the chat room. They will be able to see all of those in the chatroom, including themselves. Settings to restrict what sources each group member can see or hear are also available.

  • The "director" will be able to view the chat room, without joining it themselves, and they will have controls provided that will let them modify aspects of how the room shows up in their OBS. For example, they will be able to mute certain people so they can't be heard or seen in OBS.

  • The director will be provided isolated direct links to each of those video streams in the group room, allowing for fine-grain mixing control in OBS.

  • Text-chat is available to those in the group chat

  • Passwords are available to keep rooms secure, but are optional

  • Guest devices present in the Group Chat room will see and hear all other present device video/audio streams.

  • The video quality of those in a group room will appear low to guests, but this is to ensure more bandwidth and CPU resources are made available for the OBS's access to the stream.

  • Group rooms are not restricted in size, although more than 10 guests can start to be challenging.

Using OBS Virtualcam (or the Mac equivalent), you can even let your guests view the OBS live stream with sub-100ms of latency. In this case, each guest only needs to view one video stream, the main mixed OBS stream, freeing up group resources to allow for even larger group rooms.

Privacy, Policies, and Data-collection

OBS.Ninja is a peer-to-peer network, which implies it naturally will share your IP address with remote guests you are connecting with. There are ways to prevent this, such as using VPNs or enabling IP-leak protection in your browser, but this is not the default behavior. In no way does OBS.Ninja accept responsibility if your IP address is leaked. Connecting only with trusted peers, such as people you know and trust, is recommended for most cases.

OBS.Ninja does not store IP addresses or other personal information for longer than is needed to provide the service. This might include for purposes of TURN relay server error reporting or Denial of Service abuse prevention. There are no user-accounts, although you may use third-party services such as Discord, Reddit, Email, or Youtube to communicate with OBS.Ninja developers, support, and community.

OBS.Ninja uses Cloudflare as a file caching service and for site security. Cloudflare may use technical cookies and data-collection to provide reliable service and very basic analytics for OBS.Ninja. These general usage analytics may be shared with the community, such as when the service sees a large spike in usage.

Video data may at times be transferred via a hosted TURN video relay server, but this is done only to ensure service. This media data is not stored and only accessible to the intended remote peer. In most cases though, the video data is directly transferred between two peers, without the use of such servers. Any data that passes through the TURN server remains encrypted per the WebRTC standard, and some TURN servers provided offer further TLS encryption on top of it.

OBS.Ninja on its own does not use cookies, except for some opt-in cookies for storing preferences/settings. These are not used for analytics or tracking.

Deploying the OBS.Ninja code yourself will still reveal your IP address to some servers, such as STUN/TURN/WSS servers, which are needed for WebRTC to function. The OBS.Ninja hosted and operated servers do not collect personal data, although it may be possible that error or system logs will occasionally capture an IP address. These logs are generally cleared and are not stored longer than needed to ensure reliable and bug-free service.

When using the service, Stream ID values and Room names should be kept secure and treated like passwords when possible. Actual passwords are available additionally though, which are used to enable a client-side encryption mechanism that ensure two peers are unable to connect if passwords do not match. Passwords are not shared with any server and remain client-side. Passwords also are used to encrypt room names. To further protect the user, any deployment of OBS.Ninja to a private domain name will be further secured, as the domain name will be used as a salting mechanism for both room names, stream IDs, and encryption. As a result, a stream or room on one domain will not be accessible from another hosted deployment on another domain.

While nearly all data transfer is peer to peer based, the initial handshake between two peers is still handled by a server. Once the peer connection is established though, the two peers use that to negotiate transfer of personal data, media streams, chat messages, and other aspects. Backup handshake servers are hosted to ensure reliability, such as with https://backup.obs.ninja. Website and handshake servers are hosted in the USA, while other servers, such as TURN relay servers, are hosted internationally.

OBS.Ninja cannot guarantee privacy, service, or security, despite its efforts to protect you. You use the site, code, or service at your own risk and acceptance. Questions or requests related to privacy can be made out to [email protected]