For the complete documentation index, see llms.txt. This page is also available as Markdown.

&secure

Disconnects communication with the handshake server as soon as possible and provides verbose feedback

General Option! (&push, &room, &view, &scene)

Details

With &secure, the publisher or viewer disconnects from the handshake server after its first peer connection is established. No further peers can connect through that server until you refresh the page.

The feature also makes the connection activity verbose, letting you know when someone starts watching your stream and when that viewer disconnects.

The security mode also limits the max number of viewers to just one viewer, and if they do disconnect, they cannot reconnect. No one can actually; you will have to re-setup via a page refresh to let someone try connecting again.

This can help prevent someone from destroying a live stream due to accidentally screen sharing the stream ID to the public.

Technical Benefits

  • The handshake server has no way of talking to the publisher after the stream starts. Fully decentralized once initialized.

  • The publisher cannot be spammed by "Watch Stream" requests if the invite link gets shared accidentally.

  • The publisher can clearly see when someone has joined and when someone has disconnected.

  • Increased security and privacy, with just some minor added inconveniences.

Alternatives

  • If you wish to host your own handshake server, there is one available that is adequate for private for personal use here: https://github.com/steveseguin/websocket_server/

  • If interesting in hiding your IP address from a remote guest, you can use &privacy instead, which will use a TURN server to connect with remote guests, acting as a middleman for the peer connection.

  • While it should be tested, you can also perhaps try &icefilter=host which will attempt to filter out connections with remote guests that are behind a firewall. Feedback and test results welcomed.

Last updated

Was this helpful?