briefing
Secure video chat via pure WebRTC
Privacy is the driving force behind this project. It uses secure technologies like WebRTC to directly connect between participants. The website that provides the web app and mediates the communication stores as few data as possible and does not know anything about the contents of established conversations. No accounts are required. No cookies are used.
The difference between Briefing and most similar projects is, that it does not use a central server that distributes the video streams (SFU). The advantage of an SFU is that it saves bandwidth due to the fact that the own video does not being uploaded to each participant but only once. The SFU can also do more optimizations the clients might not support. But then the video signal is not end-to-end encrypted anymore, i.e. you have to trust the SFU provider. Briefing instead sends data from peer to peer directly ("Mesh") and therefore the data does not travel over the server under normal operation. The WebRTC peers however still trust the signaling server for the authenticity of the peer-to-peer communications encryption in place.
Web App / Native Apps
Briefing is a PWA i.e. it is a web app, that can be installed from inside the browser on some platforms. To put Briefing on your home screen in iOS Safari tap on the "Share" icon and choose "Add to Home Screen". You can do the same in browsers like Google Chrome. Therefore, native apps are not really required.
But alongside to these awesome out-of-the-box features, we still have some native support as well:
Native iOS App
Briefing is available in the Apple AppStore. You can find sample code in the ios
folder.
Native Electron App
Briefing is available in the Microsoft Store. The source is available in the electron
folder.
Native Android App
The android
folder contains a sample. Build your own distribution following this guide.
Adopt Briefing for your Project
Briefing needs quite some adoptions and modifications if you want to use it in your project. Please remember, that if you don't plan to publish your changes under EUPL, you'll need to purchase a commercial license.
However, you can just use the installation on the website https://brie.fi/ng for free, as long as you keep the branding intact
1. Link
The simplest way to use Briefing is to distribute links to it. The have the form of https://brie.fi/ng/<room-name>
, where you need to replace <room-name>
by some random name you can choose.
2. Embedding
You can also embed Briefing in your website using an iframe
. Visit this configuration page to find the best setting for you.
3. Installation
But in case you want to run it on your own hardware, it is important to understand what parts are required.
Servers
-
Frontend: The web app the user interacts with. You find it in the
app
folder. Build it vianpm run build
and put the contents ofdist
on your server. Briefing uses some tricks to have the neat/ng
path working. -
Signaling Server: You can use mine for the start, which is located at
wss://sig03.brie.fi
. If you want to use your own, you find the source code in the signal` folder. It is a simple node.js app that just connects peers in one room by helping to establish the WebRTC connection. -
STUN/TURN Server: You can use mine or any other for the start. STUN is required to get peer to peer connections through firewalls. TURN is used if that does not succeed. The later one can cause some server load.
VUE_APP_ROOM_URL = https://example.com/room/
VUE_APP_ROOM_PATH = /room/
Similar settings are available for your own signaling and STUN/TURN servers.
When you build the distribution for your website via npm run build
these settings will be baked in.
Author
We are a team named DevMastery, I'm a project manager and backend developer located in Russia.