Cordee

Cordee shares an Obsidian vault with friends using your own server. Open the official directory entry, install Cordee, then open an invitation and choose a display name. The review of version 0.1.3 completed on November 10, 2026. Obsidian says in-app search can take up to 24 hours to update; BRAT remains an alternative with repository glm02/Obsidian-sync.

Privacy and network use: the plugin contacts only the server you choose after you explicitly create or join a shared vault. Notes, attachments, file paths, display names and change history are sent to that server. The host can read them; there is no end-to-end encryption in version 0.1. Excluded folders and Obsidian settings are not shared. There is no client analytics, advertising, payment or external account requirement. Data outside the open vault is not accessed. Access tokens are stored locally in the plugin's data.json; keep .obsidian/ out of public repositories. The server retains file versions until its operator removes them. See the publication report for tested platforms and current limits.

Partage un coffre Obsidian avec tes amis, sur ton propre serveur. Gratuit, auto-hébergé, sans compte GitHub, et ça marche sur téléphone.

• Les modifications arrivent chez les autres en quelques secondes.
• Une note modifiée par deux personnes est fusionnée ligne à ligne ; rien n'est perdu.
• Une invitation, c'est un lien à coller dans l'extension.

Détails des choix : docs/conception.md.

État : version 0.1, en test. Fais une copie de ton coffre avant de l'essayer.

Héberger le serveur

Sur un VPS avec Docker (HTTPS automatique)

1. Fais pointer un nom de domaine vers le VPS, par exemple cordee.exemple.fr.
2. Copie ce dépôt sur le VPS, puis :

cp .env.exemple .env      # mets ton domaine dans CORDEE_DOMAINE
docker compose up -d
docker compose exec cordee cat /donnees/code-creation.txt   # le code pour créer des coffres

Caddy obtient le certificat HTTPS tout seul. Les données sont dans le volume cordee-donnees : pour sauvegarder, copie-le.

Sur un VPS qui a déjà Caddy ou nginx

Les ports 80/443 sont déjà pris : on lance Cordée seul, sur 127.0.0.1:8800, et le proxy existant le publie.

CORDEE_DOMAINE=cordee.exemple.fr docker compose -f deploy/compose-proxy-existant.yml up -d --build

Bloc Caddy prêt à adapter : deploy/cordee.caddy. Le proxy doit écraser l'en-tête X-Real-IP (CORDEE_DERRIERE_PROXY=1), sinon le limiteur d'essais est commun à tous les visiteurs.

Sans Docker

Node 22.18 ou plus récent, aucune installation de paquet :

cd server
CORDEE_URL_PUBLIQUE=https://cordee.exemple.fr npm start

Mets toujours le serveur derrière HTTPS : les jetons passent dans les en-têtes.

Installer l'extension

Sans télécharger les fichiers un par un

La fiche officielle de Cordee est publiée ; l’installation depuis le catalogue attend la validation de la revue automatique. En attendant :

1. Ouvre de préférence un coffre vide pour rejoindre tes amis.
2. Dans les modules complémentaires d’Obsidian, installe et active BRAT.
3. Dans BRAT, choisis Add a beta plugin, colle glm02/Obsidian-sync, puis confirme l’installation et active Cordee.
4. Rouvre ton invitation sur le site et clique sur Ouvrir dans Obsidian. Ajoute ton prénom et confirme Rejoindre.

BRAT installe les fichiers et gère les mises à jour. Le nom du catalogue est Cordee sans accent, conformément au format du catalogue ; l’interface conserve la marque Cordée.

Installation manuelle de secours

Télécharge cordee.zip, décompresse le dossier cordee dans .obsidian/plugins/, puis active Cordee. Tu peux aussi copier les fichiers :

1. Dans ton coffre, crée le dossier .obsidian/plugins/cordee/.
2. Copies-y plugin/manifest.json, plugin/main.js et plugin/styles.css.
3. Obsidian → Réglages → Extensions communautaires → active Cordee.

Le logo Cordée apparaît dans la barre de gauche. Clique dessus pour ouvrir le panneau de partage, créer une invitation ou synchroniser. Le même panneau reste accessible dans les réglages et par la commande « Cordée : Ouvrir le panneau de partage ».

Obsidian gère les extensions coffre par coffre : installe et active Cordee dans chaque coffre où tu veux l’utiliser. Chaque coffre garde sa connexion indépendante ; l’installation ne partage aucune note à elle seule.

Le serveur et le nom affiché sont retenus sur cet appareil pour les prochains coffres. Un code d’invitation seul suffit alors ; une invitation complète renseigne son propre serveur. Le bouton Changer de serveur permet d’en choisir un autre. Les jetons d’accès et codes de création restent propres à leur connexion et ne sont pas recopiés dans ces préférences.

Ensuite, dans les réglages de Cordée :

• Pour créer un coffre partagé : adresse du serveur, nom du coffre, ton prénom et le code de création. Tout le coffre est envoyé.
• Pour rejoindre : colle le lien d'invitation et ton prénom. Le mieux est de partir d'un coffre vide.

Commandes : « Synchroniser maintenant », « Créer une invitation pour un ami », « Voir qui a modifié quoi ».

Piloter la synchronisation

Le panneau Cordée affiche son état, le nombre de fichiers partagés et l’heure de la dernière synchronisation réussie. Mettre en pause suspend les prochaines synchronisations automatiques et conserve ce choix après redémarrage ; une opération déjà lancée se termine normalement. Synchroniser lance une opération ponctuelle, même pendant la pause. Reprendre réactive les automatismes et synchronise immédiatement.

Voir l’activité ouvre les membres du groupe et les 40 derniers changements. Le panneau indique les problèmes de connexion, les accès refusés, les fichiers dépassant la limite de 50 Mo et les suppressions bloquées par le garde-fou. Les fonctions d’administration et de retrait d’un autre membre ne sont pas encore disponibles.

Photo de profil

Dans le panneau connecté, ouvre Mon profil, choisis une image JPEG, PNG ou WebP, vérifie l’aperçu puis confirme son envoi. L’extension recadre la photo en carré et la réencode localement avant de l’envoyer, sans les métadonnées du fichier original. Tu peux ensuite retirer la photo. Le profil est propre au groupe partagé et visible par ses membres, ainsi que par l’hébergeur du serveur.

Tu peux aussi y modifier ton Nom affiché, puis cliquer sur Enregistrer le nom. Le changement conserve ta photo et l’identifiant de tes contributions ; l’activité présente le nouveau nom pour tes changements.

Les membres et l’activité affichent la photo ou les initiales, toujours avec le nom de la personne. Les changements restent associés à l’identifiant de leur auteur, même si deux personnes portent le même nom. Cette fonction demande un serveur prenant en charge les profils ; la synchronisation reste compatible avec les serveurs précédents.

Développer

cd server
npm test

Les tests couvrent l'API, la fusion des notes et une synchro de bout en bout entre deux coffres simulés.

Pour préparer une release compatible Obsidian et BRAT : python scripts/prepare_release.py. Les fichiers sont produits dans dist/<version>/, ignoré par Git. Le manifeste à la racine et sa copie dans plugin/ doivent rester identiques. Le tag GitHub doit correspondre exactement à leur version, sans préfixe v.

Licence

MIT