Collaboration

Introduction

Depuis la version bêta 2.0, Butterfly prend en charge la collaboration. Cela signifie que vous pouvez modifier le même fichier avec plusieurs personnes en même temps. C’est utile lorsque vous souhaitez travailler ensemble sur un document.

Swamp

Swamp is a protocol that allows you to share your document with other people by using a remote server. This is useful if the other person is not in the same network as you. The server will just be a proxy for the connection and cannot read the data since it is all end to end encrypted.

Setup Sawmp

Create a swamp server by visiting the swamp website. Now enter the url of the server in the collaboration view. The url should look like this: wss://example.com or ws://example.com. Please note that only secure connections are allowed on the web. Please also make sure that the server is reachable from the internet.

Now you can just click on Start to start the server. With the given link you can share the document with other people. They can just enter the link in the connect dialog and click on Connect. This will connect them to the server and they will be able to edit the document.

Websocket

Butterfly utilise un serveur Websocket qui sera hébergé sur votre ordinateur. Ce serveur doit être accessible depuis internet ou depuis votre réseau local. Le client se connectera sur ce serveur. Le serveur synchronise toutes les modifications et tous les événements avec tous les clients.

Configuration du serveur

Tout d’abord, activez la collaboration expérimentale dans les paramètres. Ensuite, ouvrez le document que vous souhaitez partager. Puis cliquez sur le bouton de partage qui se situe dans l’angle supérieur gauche, à droite du titre. Cela ouvrira une boîte de dialogue. Cliquez sur Début.

Par défaut, le serveur sera hébergé sur toutes les interfaces sur le port 28005. Vous pouvez changer cela dans la boîte de dialogue. Vous devez vous assurer que ce serveur est accessible au client. Dans le réseau local, cela devrait fonctionner sans problème. Si vous souhaitez accéder au serveur depuis internet, vous devez rediriger le port sur votre routeur. Vous pouvez trouver plus d’informations à ce sujet ici.

Si vous ne pouvez pas rediriger le port, vous pouvez utiliser un service comme ngrok. Cela va créer un tunnel vers votre serveur local. C’est utile si vous voulez partager le document avec d’autres personnes.

Pour ngrok, la commande ressemblerait à ceci :

ngrok http 28005

Se connecter au serveur

Vous devez maintenant vous connecter au serveur. Pour ce faire, allez à la page d’accueil et cliquez sur le bouton “plus” comme si vous alliez créer un nouveau document. Là, vous verrez un nouvel élément de menu appelé Connecter.

Cliquez dessus et vous verrez une boîte de dialogue. Entrez ici l’url de connexion. Si vous êtes sur le même réseau, vous pouvez utiliser l’adresse IP locale de l’ordinateur où le serveur fonctionne. L’URL devrait ressembler à ceci : ws://{IP}:28005. Replace {ip} with the ip address of the computer. You can find the ip address with the command ipconfig on windows or ifconfig on linux. On android you can find the ip address in the wifi settings.

If you are not in the same network, you need to use the public ip address of the computer. You can find this by searching for what is my ip in your favorite search browser. The url should look like the one above, but with the public ip address.

If you use ngrok, the setup is a bit different. Replace the https with wss and add the port :28005 at the end. The url should look like this: wss://{random}:28005. Replace the random part with the part that ngrok gives you.