Installing.fr

🌐 English · Deutsch

Installation (gramps-connect-desktop)

gramps-connect-desktop est la version autonome de Gramps Connect : une application téléchargeable qui regroupe le frontend app/ et le backend de gramps-web-api avec SQLite, et s'exécute entièrement sur votre propre machine. C'est le moyen le plus simple d'essayer Gramps Connect dès aujourd'hui, et une véritable alternative à Gramps Desktop pour le travail quotidien sur votre propre arbre — pas un aperçu limité d'autre chose.

Elle est conçue pour un seul utilisateur : elle n'écoute que sur 127.0.0.1, donc rien n'est accessible via un réseau, et elle a toujours exactement un identifiant fixé en dur, admin / admin. Pour connecter toute une famille à un même arbre partagé, ou pour voir les fonctionnalités de collaboration en direct en action, voir plutôt Déploiement — la version autonome n'a personne d'autre dont regarder apparaître les modifications.

Chaque téléchargement actuel se trouve sur la dernière version. Tous démarrent avec un arbre vide — importer votre propre fichier Gramps XML (.gramps) ou GEDCOM (.ged) via l'écran Arbres généalogiques → Importer… de l'application une fois qu'elle tourne.

Le premier lancement crée un petit répertoire de données dans votre dossier personnel (.gramps-connect-desktop) contenant cet arbre ; les lancements suivants le réutilisent. Supprimer ce dossier pour repartir d'une page blanche. Ce sont des builds non signés, x86_64 uniquement, d'où les avertissements du système décrits ci-dessous — pas un signe que quelque chose ne va pas.

Windows

1. Télécharger gramps-connect-desktop-windows.zip depuis la dernière version et le décompresser (clic droit → Extraire tout).
2. Ouvrir le dossier extrait et double-cliquer sur gramps-connect-desktop.exe.
3. Windows affichera probablement un avertissement SmartScreen (« Windows a protégé votre ordinateur ») car ce n'est pas un exécutable signé. Cliquer sur Informations complémentaires, puis Exécuter quand même.
4. Une fenêtre s'ouvre automatiquement, l'application tourne. Se connecter avec admin / admin.

macOS (Apple Silicon)

Pour les Mac M1/M2/M3/M4.

1. Télécharger gramps-connect-desktop-macos-arm64.zip depuis la dernière version et le décompresser (double-clic, ou clic droit → Ouvrir, selon les réglages du Mac) pour obtenir gramps-connect-desktop.app.
2. Double-cliquer sur gramps-connect-desktop.app. Ce build est signé avec un Developer ID et notarié par Apple, il devrait donc s'ouvrir normalement sans aucun avertissement Gatekeeper. Si un avertissement apparaît quand même, voir le Dépannage ci-dessous.
3. Une fenêtre s'ouvre automatiquement, l'application tourne. Se connecter avec admin / admin.

macOS (Intel)

Pour les Mac Intel plus anciens (avant Apple Silicon). Mêmes étapes que pour Apple Silicon ci-dessus, mais télécharger plutôt gramps-connect-desktop-macos-intel.zip.

Linux (.deb — Debian, Ubuntu et dérivés)

1. Télécharger le fichier .deb (gramps-connect-desktop_*_amd64.deb) depuis la dernière version.
2. L'installer : sudo apt install ./gramps-connect-desktop_*_amd64.deb (installation depuis un fichier local plutôt qu'un dépôt, apt avertira donc probablement que le paquet n'est pas signé — attendu, voir Dépannage).
3. Lancer gramps-connect-desktop depuis un terminal, ou chercher « Gramps Connect Desktop » dans le menu des applications.
4. Cela s'ouvre dans sa propre fenêtre native, en utilisant GTK3 + WebKit2 déjà présents sur le système (courant sur les bureaux Linux — beaucoup d'applications en dépendent déjà ; aucun des deux n'est fourni avec ce paquet). Si le système ne les a pas, cela s'ouvre plutôt dans un onglet de navigateur (voir Dépannage). Se connecter avec admin / admin.
5. Pour désinstaller : sudo apt remove gramps-connect-desktop.

Linux (.rpm — Fedora, RHEL, AlmaLinux et dérivés)

1. Télécharger le fichier .rpm (gramps-connect-desktop-*.x86_64.rpm) depuis la dernière version.
2. L'installer : sudo dnf install ./gramps-connect-desktop-*.x86_64.rpm (sur un système sans dnf, sudo rpm -i gramps-connect-desktop-*.x86_64.rpm fonctionne aussi, simplement sans résolution automatique des dépendances). Comme pour le .deb ci-dessus, installer depuis un fichier local signifie que dnf/rpm avertira probablement que le paquet n'est pas signé — attendu.
3. Lancer gramps-connect-desktop depuis un terminal, ou chercher « Gramps Connect Desktop » dans le menu des applications.
4. Cela s'ouvre dans sa propre fenêtre native (ou bascule vers un onglet de navigateur) — comme pour le .deb ci-dessus. Se connecter avec admin / admin.
5. Pour désinstaller : sudo dnf remove gramps-connect-desktop.

Configuration

gramps-connect-desktop fonctionne sans aucune configuration. Le seul réglage optionnel est l'e-mail sortant : par défaut, tout ce qui enverrait un e-mail (réinitialisation de mot de passe, confirmation d'e-mail, notification de nouvel utilisateur — bien qu'il n'y ait personne à notifier sur un build mono-utilisateur) échoue simplement avec « Connection was refused », puisqu'il n'y a pas de serveur de messagerie sur votre machine à qui parler. Pour réellement envoyer ces e-mails, définir ces variables d'environnement avant de lancer l'application :

Variable	Rôle
GRAMPSWEB_EMAIL_HOST	Nom d'hôte du serveur SMTP
GRAMPSWEB_EMAIL_PORT	Port du serveur SMTP (par défaut 465)
GRAMPSWEB_EMAIL_HOST_USER	Nom d'utilisateur de connexion SMTP
GRAMPSWEB_EMAIL_HOST_PASSWORD	Mot de passe de connexion SMTP
GRAMPSWEB_DEFAULT_FROM_EMAIL	Adresse « De » des e-mails envoyés
GRAMPSWEB_EMAIL_USE_SSL	true/false — connexion TLS/SSL implicite
GRAMPSWEB_EMAIL_USE_STARTTLS	true/false — connexion simple mise à niveau via STARTTLS
GRAMPSWEB_EMAIL_USE_TLS	true/false — alias plus ancien ; préférer les deux ci-dessus (par défaut true, c.-à-d. TLS implicite)

Seules les variables définies prennent effet ; tout ce qui n'est pas défini retombe sur la propre valeur par défaut de gramps-web-api pour cette option. Par exemple, pour envoyer via Gmail avec un mot de passe d'application :

GRAMPSWEB_EMAIL_HOST=smtp.gmail.com \
GRAMPSWEB_EMAIL_PORT=587 \
GRAMPSWEB_EMAIL_HOST_USER=you@gmail.com \
GRAMPSWEB_EMAIL_HOST_PASSWORD=your-app-password \
GRAMPSWEB_EMAIL_USE_STARTTLS=true \
GRAMPSWEB_DEFAULT_FROM_EMAIL=you@gmail.com \
./gramps-connect-desktop

Lancé depuis un terminal, --browser saute la fenêtre native sous macOS/Windows et ouvre toujours le navigateur par défaut à la place — le même repli que Linux utilise toujours (voir Architecture), simplement choisi délibérément plutôt qu'automatique. Pratique pour utiliser les propres outils de développement/extensions de son navigateur, ou pour écarter la webview native quand quelque chose semble anormal :

./gramps-connect-desktop --browser

Dépannage

• Windows SmartScreen (« Windows a protégé votre ordinateur ») — attendu, puisque ce build n'est pas signé. Cliquer sur Informations complémentaires → Exécuter quand même.
• macOS Gatekeeper (« ne peut pas être ouvert car Apple ne peut pas vérifier l'absence de logiciel malveillant ») — ce build est signé avec un Developer ID et notarié par Apple, cela ne devrait donc pas arriver. Si c'est le cas, essayer d'abord de retirer l'indicateur de quarantaine de toute la .app d'un coup : xattr -cr gramps-connect-desktop.app (à exécuter depuis le Terminal, dans le dossier où elle a été décompressée). Merci de le signaler également — cela veut probablement dire que le ticket de notarisation n'a pas survécu au téléchargement/décompression comme prévu, ou que le build n'a pas été notarié correctement.
• apt/dnf avertit que le .deb/.rpm n'est pas signé, ou saute une vérification OpenPGP — attendu. Ces paquets sont construits par la propre CI de ce dépôt, non publiés sur un dépôt de distribution signé, les installer depuis un fichier local a donc toujours cette apparence ; cela ne veut pas dire que quelque chose ne va pas.
• dnf: command not found / rpm: command not found — votre distribution est basée sur Debian/Ubuntu (ou ne fournit pas rpm autrement), le paquet .rpm est donc le mauvais téléchargement. Prendre plutôt le fichier .deb et l'installer avec sudo apt install ./gramps-connect-desktop_*_amd64.deb (voir la section .deb ci-dessus).
• Aucune fenêtre ni onglet de navigateur n'apparaît, sur aucune plateforme — l'application essaie toujours d'en ouvrir un automatiquement une fois son serveur prêt ; si cela échoue d'une façon ou d'une autre, ouvrir soi-même http://127.0.0.1:5050. Si rien n'écoute là non plus, quelque chose a planté avant d'atteindre ce point — vérifier la sortie du terminal (Windows : lancer gramps-connect-desktop.exe depuis une fenêtre cmd/PowerShell plutôt que par double-clic, pour pouvoir la voir) pour une erreur, et envisager d'ouvrir un ticket avec cette sortie.
• L'application ne démarre pas / port déjà utilisé — une seule instance peut tourner à la fois (elle est fixée en dur sur 127.0.0.1:5050). Fermer toute autre copie en cours d'exécution, ou tout ce qui utilise le port 5050, et réessayer.
• Un onglet de navigateur s'ouvre à la place d'une fenêtre native — l'application essaie toujours d'abord une fenêtre native et bascule automatiquement si ce n'est pas possible : WebView2 sous Windows (présent par défaut sous Windows 10/11) ou WKWebView sous macOS (toujours présent) n'a pas pu être atteint, ou sous Linux, GTK3 + WebKit2 ne sont pas installés au niveau du système (installer python3-gi, gir1.2-gtk-3.0 et gir1.2-webkit2-4.1, ou les équivalents de votre distribution, et relancer pour obtenir une fenêtre native à la place). L'application fonctionne pleinement dans l'onglet de navigateur dans les deux cas — cela n'affecte que la présentation, pas ce qu'elle peut faire.
• Repartir d'un arbre vide — supprimer le dossier .gramps-connect-desktop dans votre répertoire personnel, puis relancer.
• Vous cherchez un vrai déploiement multi-utilisateur plutôt que ce build local mono-utilisateur ? Voir Déploiement.

Voir aussi FAQ pour des questions sur la sécurité des données et la comparaison entre gramps-connect-desktop, Gramps Desktop et le déploiement serveur.