diff --git a/templates/default/documentation.html.ep b/templates/default/documentation.html.ep
index cf9bb2f..79dffdd 100644
--- a/templates/default/documentation.html.ep
+++ b/templates/default/documentation.html.ep
@@ -22,7 +22,8 @@
There are several more or less similar hosted solutions available (like
talky.io,
appear.in,
- vLine.com for example).
+ vLine.com
+ for example).
Most of them are more polished than VROOM, but I've found none entirely opensource, so I started this project.
@@ -38,11 +39,11 @@
VROOM implements the following features:
- - Audio/Video conversations (no limit on the number of peers per room)
- - Text chat (with possibility to save the history)
- - Screen or single windows sharing sharing
- - Invite anyone by email
- - Be notified (by email) when someone joins one of your rooms
+ - P2P Audio/Video conversations (no limit on the number of peers per room)
+ - P2P text chat
+ - Screen or single windows sharing
+ - Send invitations by email
+ - Be notified when someone joins one of your rooms
- Persistent/reserved rooms
- Chairman functionnalities (mute/pause/kick other peers)
- Grant chairman role to other peers
@@ -60,24 +61,35 @@
How it works
- WebRTC allows browsers to browsers direct connections. This provides the best latency as it avoids round trip through a server,
+ WebRTC allows browsers to browsers direct connections. This provides the best latency as it avoids round trip through a server,
which is important with real time communications. But it also ensures the privacy of your communications. VROOM takes advantage of those
new technologies, and does the following:
- When a client joins a room, it establishes a websocket connection to VROOM server.
This is called the signaling channel. With this, all peers are able to exchange small messages with each other. But messages sent through this channels are
- routed through VROOM server, so it's not yet peer to peer
+ routed through VROOM server, so it's not peer to peer yet
- When a second peer joins the same room, he gets informations about how to connect directly to the other one(s) through this signaling channel.
- Now, both peer exchange their video and audio stream directly
- The signaling channel stays open and is used to transmit non sensitive informations (peer colors synchronization, notification of muting/kicking etc...)
- - Everything else (audio/video/text chat) is sent through data channels
+ - Everything else (audio/video/text chat) is sent directly between peers through data channels
- As long as possible, data channels and audio/video streams are established directly between peers, but in some situations, this is not possible (NAT, firewalls etc...). In those cases
+ As long as possible, data channels and audio/video streams are established directly between peers, but in some situations, this is not possible (NAT, restrictive firewalls etc...). In those cases
data streams are relayed through a
TURN server
+
+ Technologies
+
+ VROOM is composed of two distincts
+
+ - The client side: written in Javascript, it's the code executed on the browsers. This is where webcam streams are captured and sent to other peers. The biggest part is
+ SimpleWebRTC.
+ - The server side: mainly written in Perl using the fabulous Mojolicious framework. This is where room are created
+ their configurations are stored, and where permissions are managed
+
+
Install your own VROOM instance
@@ -89,13 +101,13 @@
If you want to run your own VROOM instance, you'll need the following components
- - Mojolicious 5 or better
- A MySQL compatible server (MySQL or MariaDB)
- A webserver supporting HTTPS and reverse proxying, including websocket reverse proxying (Apache can do this with mod_proxy_wstunnel)
- The following perl modules
- DBI
- DBD::mysql
+ - Mojolicious
- Mojolicious::Plugin::Mail
- Mojolicious::Plugin::Database
- Mojolicious::Plugin::StaticCompressor
@@ -133,11 +145,11 @@
It's also advised to run VROOM on a systemd powered distribution (simply because that's what I use and I include service units for VROOM).
- For the same reason, I recommend running Apache as webserver (others like Nginx probably work too, but I provide configuration sample only for Apache)
+ For the same reasons, I recommend running Apache as webserver (others like Nginx probably work too, but I provide configuration sample only for Apache)
- VROOM can probably work with other DB engine (like PostgreSQL) with minor modifications.
- If you're interrested in adding support for other engines, you're welcome to help
+ VROOM can probably work with other database engines (like PostgreSQL) with minor modifications.
+ If you're interrested in adding support, you're welcome to help
While VROOM should run on any distro, it's only tested on CentOS 7 x86_64, so it's the recommended platform.