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.

Comment ça marche

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.