Intégration communautaire CalDAV, gratuite et open source

Synchronisez vos calendriers CalDAV (Google, iCloud, Nextcloud, Fastmail…) dans Gladys.
Cette intégration copie vos calendriers CalDAV (Google, iCloud, Nextcloud, Fastmail, Infomaniak, Baïkal, Radicale, SOGo, Synology Calendar…) dans le calendrier de Gladys. Les événements apparaissent dans la vue calendrier, peuvent déclencher des scènes (« un événement arrive ») et sont connus de l'assistant.
La synchronisation est à sens unique : Gladys lit votre serveur CalDAV, il n'y écrit jamais. Un événement créé ou modifié dans Gladys sur un calendrier synchronisé n'est pas renvoyé au serveur.
Activer l'intégration pour votre compte
Chaque utilisateur de Gladys active l'intégration pour lui-même : vos calendriers sont des données personnelles, rien n'est synchronisé tant que vous ne l'avez pas activée.
- Ouvrez l'intégration CalDAV, onglet Configuration.
- Dans le bloc Mes calendriers, renseignez :
- votre fournisseur : Google, iCloud, Fastmail et Infomaniak ne demandent pas d'URL ;
- sinon (fournisseur « Autre »), l'URL du serveur CalDAV (voir le tableau ci-dessous) — une URL saisie ici est toujours utilisée, quel que soit le fournisseur ;
- votre nom d'utilisateur ;
- votre mot de passe — utilisez un mot de passe d'application si votre fournisseur en propose un.
- Cliquez sur Activer. Vos calendriers apparaissent quelques secondes plus tard.
| Fournisseur | URL du serveur | Remarques |
|---|---|---|
dans la liste (https://www.google.com/calendar/dav) | Adresse Gmail + mot de passe d'application (validation en deux étapes activée) | |
| iCloud | dans la liste (https://caldav.icloud.com) | Identifiant Apple + mot de passe d'application (obligatoire) |
| Fastmail | dans la liste (https://caldav.fastmail.com) | Mot de passe d'application avec l'accès CalDAV |
| Infomaniak | dans la liste (https://sync.infomaniak.com) | Identifiant Infomaniak (pas l'adresse e-mail) + mot de passe d'application |
| Nextcloud | https://cloud.exemple.fr/remote.php/dav | Mot de passe d'application : Paramètres → Sécurité |
| Framagenda | https://framagenda.org/remote.php/dav | Mot de passe d'application : Paramètres → Sécurité |
| Baïkal | https://dav.exemple.fr/dav.php | |
| Radicale | https://dav.exemple.fr (ou http://ip:5232) | |
| SOGo | https://mail.exemple.fr/SOGo/dav | |
| Synology | https://nas.exemple.fr:5001/caldav |
L'intégration découvre elle-même vos calendriers depuis cette URL (principal et dossier de calendriers) : inutile d'indiquer l'adresse de chaque calendrier. Les listes de tâches sont ignorées.
Calendriers abonnés (webcal)
Les calendriers auxquels votre compte est abonné par une adresse (jours
fériés, matchs, emploi du temps scolaire… — adresses webcal:// ou
https://) sont synchronisés eux aussi, lorsque votre serveur conserve les
abonnements dans votre compte : c'est le cas de Nextcloud, iCloud, SOGo. Ils
apparaissent dans Gladys comme vos autres calendriers, avec les mêmes
interrupteurs.
- L'intégration lit le flux elle-même, à son adresse : le flux doit être joignable depuis votre Gladys. Il est lu sans vos identifiants CalDAV.
- Un flux est lu à chaque synchronisation, mais n'est écrit dans Gladys que si son contenu a changé.
- Un abonnement qui n'existe que dans une application (un calendrier abonné seulement dans Thunderbird ou sur un téléphone) n'est pas sur le serveur : l'intégration ne peut pas le voir.
Choisir quoi synchroniser et partager
Chaque calendrier synchronisé apparaît dans Gladys avec deux interrupteurs :
- Synchroniser — désactivez-le pour ignorer un calendrier : ses événements sont retirés de Gladys. Réactivé, il est re-rempli à la synchronisation qui suit.
- Partager — un calendrier est privé au départ. Partagé, il devient visible par tout le foyer, et utilisable par les scènes.
Le nom, la description et la couleur d'un calendrier suivent ceux du serveur.
Réglages (administrateur)
Ces réglages s'appliquent à tous les utilisateurs :
- Intervalle de synchronisation — toutes les 15 minutes par défaut (de 5 minutes à 24 heures).
- Jours d'historique — les événements passés de plus de 30 jours (par défaut) ne sont pas synchronisés.
- Jours à venir — 365 jours par défaut (jusqu'à 730) : les événements récurrents sont développés jusqu'à cet horizon.
- Logs détaillés — désactivé par défaut. Activé, chaque requête CalDAV et son résultat sont écrits dans les logs de l'intégration (voir Dépannage).
Le bouton Synchroniser maintenant relit immédiatement tous les comptes et affiche le nombre de calendriers et d'événements synchronisés.
Bon à savoir
- Un événement supprimé sur le serveur disparaît de Gladys à la synchronisation qui suit ; un calendrier supprimé sur le serveur est supprimé de Gladys avec ses événements.
- Les événements récurrents (y compris les exceptions et occurrences déplacées) sont développés en occurrences individuelles.
- Les événements annulés (
STATUS:CANCELLED) ne sont pas importés. - Un événement à heure « flottante » (sans fuseau horaire) est lu en UTC.
- Limites de Gladys : 50 calendriers par utilisateur (abonnements compris), 10 000 événements par calendrier ; les textes trop longs sont tronqués.
- Désactiver l'intégration pour votre compte supprime de Gladys vos calendriers synchronisés (ils restent intacts sur le serveur).
Dépannage
L'écran de configuration indique combien de comptes sont en échec. Les causes les plus fréquentes :
- URL incorrecte — vérifiez l'URL dans un client CalDAV (Thunderbird,
DAVx⁵) ; essayez l'URL racine du serveur, la découverte
/.well-known/caldavest automatique. - Identifiants refusés — avec la double authentification activée, un mot de passe d'application est indispensable.
- Certificat auto-signé — le serveur doit présenter un certificat HTTPS valide (ou être joint en HTTP sur le réseau local).
- « N object(s) the server could not return were skipped » — le serveur liste un événement qu'il n'arrive ensuite pas à renvoyer (Google le fait sur certains calendriers). Le reste du calendrier est synchronisé ; seuls ces objets manquent.
- « feed … : 404 Not Found » (ou « not an iCalendar feed ») — un calendrier abonné dont l'adresse ne fonctionne plus : vérifiez-la dans votre application de calendrier. L'erreur ne cite que l'hôte du flux, son adresse complète pouvant contenir une clé privée.
L'administrateur trouve le détail des erreurs dans les logs de l'intégration (page de l’intégration, onglet de supervision). Les mots de passe n'y apparaissent jamais.
Pour signaler un problème, activez Logs détaillés dans les réglages, cliquez sur Synchroniser maintenant, copiez les logs puis désactivez l'option : ils montrent chaque étape de la découverte et chaque requête envoyée au serveur, avec les URL des calendriers (souvent votre adresse e-mail) — relisez-les avant de les publier.
Paramètres de configuration
Voici les paramètres demandés par CalDAV dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Chaque utilisateur active l'intégration pour lui-même dans le bloc « Mes calendriers » ci-dessous, avec son propre serveur CalDAV et ses identifiants. Ses calendriers et événements sont copiés dans Gladys, à sens unique : Gladys n'écrit jamais sur le serveur CalDAV. Les réglages ci-dessous s'appliquent à tous les utilisateurs. |
| Intervalle de synchronisation (minutes) | number | Non | Fréquence de lecture des calendriers de chaque utilisateur sur son serveur CalDAV. |
| Jours d'historique | number | Non | Les événements passés plus anciens ne sont pas synchronisés. |
| Jours à venir | number | Non | Horizon de la synchronisation : les événements récurrents sont développés jusqu'à ce nombre de jours. |
| Logs détaillés | boolean | Non | Écrit chaque requête CalDAV et son résultat dans les logs de l'intégration, pour diagnostiquer un calendrier qui ne se synchronise pas. Ils contiennent les URL des calendriers : désactivez-les une fois terminé. |
Comment installer CalDAV dans Gladys
- Dans Gladys, ouvrez Intégrations : CalDAV apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/bertrandda/gladys-caldav-sync:1.1.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/bertrandda/gladys-caldav-sync.
CalDAV nécessite Gladys >=5.2.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
CalDAV est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par bertrandda, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation