Différences
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
vdirsyncer [Le 03/11/2022, 12:24] AdeDidou [Section Paire] |
vdirsyncer [Le 04/11/2022, 10:59] (Version actuelle) AdeDidou [Automatisation] |
||
|---|---|---|---|
| Ligne 52: | Ligne 52: | ||
| [storage nom_stockage] | [storage nom_stockage] | ||
| type = "TYPE" | type = "TYPE" | ||
| - | path = "DOSSIER_DE_STOCKAGE" ou url = "URL" | ||
| - | fileext = "EXTENSION_DES_FICHIERS" | ||
| </code> | </code> | ||
| + | Liste des stockages supportés et leur différents paramétrages : | ||
| + | * [[https://vdirsyncer.pimutils.org/en/stable/config.html#caldav-and-carddav|CalDAV and CardDAV]] | ||
| + | * [[https://vdirsyncer.pimutils.org/en/stable/config.html#google|Google]] | ||
| + | * [[https://vdirsyncer.pimutils.org/en/stable/config.html#etesync|EteSync]] | ||
| + | * [[https://vdirsyncer.pimutils.org/en/stable/config.html#local|Local]] | ||
| + | ===Google=== | ||
| + | Vdirsyncer prend en charge la synchronisation avec les calendriers Google avec quelques restrictions. La synchronisation avec les contacts Google est moins fiable, pensez à toujours sauvegarder vos données. | ||
| + | Il faut tout d'abord [[:tutoriel:comment_installer_un_paquet|installer le paquet]] **[[apt>python3-pip|python3-pip]]**.\\ | ||
| + | Puis installer des dépendances supplémentaires : | ||
| + | <code>pip install vdirsyncer[google]</code> | ||
| + | |||
| + | Enfin, vous devez enregistrer vdirsyncer en tant qu’application vous-même pour obtenir client_id et client_secret afin de respecter les Conditions d’utilisation de Google : | ||
| + | - Accédez à [[https://console.cloud.google.com/apis/dashboard|Google API Manager]] et créez un nouveau projet sous n’importe quel nom. Il faut cliquer sur la liste déroulante en haut à gauche à droite de "Google Cloud"{{:screenshot_2022-11-03_at_13-03-38_parametres_iam_et_administrati_go-next_google_cloud_console.png?direct&200|}} Puis sur nouveau projet en haut à droite de la fenêtre qui s'ouvre{{:screenshot_2022-11-03_at_13-04-06_parametres_iam_et_administrati_go-next_google_cloud_console.png?direct&200|}} | ||
| + | - Dans ce projet, activez les API « CalDAV » (pour les calendrier) et/ou « CardDAV » (pour les contacts). Il devrait y avoir une boîte de recherche où vous pouvez simplement entrer ces termes. {{::caldav.png?direct&200|}} | ||
| + | - Dans la barre latérale, sélectionnez « Identifiants » puis sur configurer l'écran d'autorisation. Vous pouvez choisir externe | ||
| + | - Créez un nouveau « OAuth Client ID ». Vous serez invité à créer d’abord un écran de consentement OAuth. Remplissez ce formulaire comme vous le souhaitez. En ajoutant dans les utilisateur autorisés votre compte Google. Enfin, vous devriez avoir un code de client et un secret de client. Fournissez-les dans votre config de stockage. | ||
| + | |||
| + | Exemple de configuration de stockage pour les calendriers Google : | ||
| + | <code> | ||
| + | [storage calendrier_google] | ||
| + | type = "google_calendar" | ||
| + | token_file = "~/.vdirsyncer/google" | ||
| + | client_id = "ID_CLIENT_SUR_API" | ||
| + | client_secret = "CODE_SECRET_DU_CLIENT_SUR_API" | ||
| + | </code> | ||
| + | |||
| + | Lors du premier lancement de vdirsyncer, il faudra se connecter à Google puis copier dans le terminal le code d'autorisation qui s'affiche. Ensuite, la connexion est automatique. | ||
| + | ===Nextcloud=== | ||
| + | Exemple de configuration de stockage pour les calendriers Nextcloud : | ||
| + | <code> | ||
| + | [storage calendrier_nextcloud] | ||
| + | type = "caldav" | ||
| + | url = "URL_SERVEUR_NEXTCLOUD" | ||
| + | username = "UTILISATEUR" | ||
| + | password = "MOT_DE_PASSE" | ||
| + | </code> | ||
| ====Configuration avancée==== | ====Configuration avancée==== | ||
| Pour plus de détails, vous pouvez consulter la [[https://vdirsyncer.pimutils.org/en/stable/tutorial.html|configuration avancée | Pour plus de détails, vous pouvez consulter la [[https://vdirsyncer.pimutils.org/en/stable/tutorial.html|configuration avancée | ||
| ]] | ]] | ||
| + | ===Synchronisation Google et Nextcloud=== | ||
| + | Exemple de configuration pour synchroniser deux calendriers entre Google et Nextcloud : | ||
| + | <code> | ||
| + | [pair google_nextcloud] | ||
| + | a = "calendrier_google" | ||
| + | b = "calendrier_nextcloud" | ||
| + | collections = [["CALENDRIER_1","ID_CALENDRIER_1_GOOGLE","ID_CALENDRIER_1_NEXTCLOUD"], ["CALENDRIER_2","ID_CALENDRIER_2_GOOGLE","ID_CALENDRIER_2_NEXTCLOUD"]] | ||
| + | </code> | ||
| + | <note tip>Si vous ne connaissez pas les identifiants de vos calendriers, vous pouvez mettre n'importe quoi pour les identifiants puis lancer <code>vdirsyncer discover</code> | ||
| + | Vous verrez alors apparaître la liste des calendriers sur les serveurs sous ce format : | ||
| + | <code> | ||
| + | calendrier_google: | ||
| + | - "ID_CALENDRIER_1_GOOGLE" ("NOM_CALENDRIER_1_GOOGLE") | ||
| + | - "ID_CALENDRIER_2_GOOGLE" ("NOM_CALENDRIER_2_GOOGLE") | ||
| + | calendrier_nextcloud: | ||
| + | - "ID_CALENDRIER_1_NEXTCLOUD" ("NOM_CALENDRIER_1_NEXTCLOUD") | ||
| + | - "ID_CALENDRIER_2_NEXTCLOUD" ("NOM_CALENDRIER_2_NEXTCLOUD") | ||
| + | </code> | ||
| + | Pensez à mettre non quand l'application vous demande si vous souhaitez créer les collections non trouvées. | ||
| + | </note> | ||
| ===== Utilisation===== | ===== Utilisation===== | ||
| Ligne 71: | Ligne 124: | ||
| vdirsyncer sync | vdirsyncer sync | ||
| </code> | </code> | ||
| + | ====Automatisation==== | ||
| + | En utilisant systemd.timer, vdirsyncer peut s'exécuter à un intervalle régulier (par défaut toutes les 15 minutes). Pour activer la minuterie, lancez | ||
| + | <code bash>systemctl --user enable vdirsyncer.timer</code> | ||
| + | Pour voir les journaux des analyses précédentes, utilisez <code bash>journalctl --user -u vdirsyncer</code> | ||
| ===== Désinstallation ===== | ===== Désinstallation ===== | ||