first commit vdirsyncer

This commit is contained in:
Milka64 2021-06-28 23:43:16 +02:00
parent c8a0352ed0
commit 7bae9a5366

View file

@ -1,11 +1,138 @@
Vdirsyncer & Khal Gerer son agenda en cli
################# #######################
:date: 2021-06-20 18:30 :date: 2021-06-20 18:30
:modified: 2021-06-20 23:30 :modified: 2021-06-20 23:30
:tags: divers, cli :tags: divers, cli
:category: cli :category: cli
:slug: vdirsyncr_khal :slug: agenda_cli
:authors: Milka64 :authors: Milka64
:summary: vdirsyncer & khal :summary: vdirsyncer & khal
:status: draft :status: draft
Si il y a bien un truc que j'aime c'est de pouvoir *TOUT* gerer via le terminal. De pouvoir m'affranchir si besoin de tout interface graphique. De rester indépendant de tout problème d'affichage.
Et dans ce lot d'utilitaire accessible en console, j'ai recement découvert le duo vdirsyncer & khal.
Vdirsyncer
----------
Vdirsyncer permet de syncroniser un calndrier en ligne (caldav, google calendar, etesync, etc...) avec un dossier local. Il permet également de syncroniser des contact avec un serveur cardav, mais je ne developperais pas cette partie.
Le fichier de configuration se trouve ici :
.. code-block:: bash
.config/vdirsyncer/config
Tout d'abbord, conficurons le status_path
.. code-block:: ini
[general]
status_path = "~/.vdirsyncer/status/"
Ensuite, nous pouvons configurer les deux calendriers à syncroniser.
L'un local et l'autre distant.
.. code-block:: ini
[storage local]
type = "filesystem"
path = "~/.calendars/"
fileext = ".ics"
[storage remote]
type = "caldav"
url = "https://caldav.server/
username = "foo"
password = "bar"
Maintenant que nous avons configuré les calendriers, nous pouvons enfin configurer la syncronisation entre les deux calendriers. Cette étape parait idiote mais elle est indispensable parce que l'outil permet de syncroniser plusieurs agendas.
.. code-block:: ini
[pair caldavserver]
a = "local"
b = "remote"
collections = ["from a", "from b"]
metadata = ["color"]
Il ne reste plus qu'a syncroniser tout ça.
.. code-block:: console
$ vdirsyncer discover
$ vdirsyncer sync
Khal
----
Maintenant que nouqs avons Vdirsyncer qui stocke les agendas dans le dossier ``.calendars``, nous pouvons demander a khal de nous afficher les évenements.
Mais un minimum de configuration est necessaire
.. code-block:: ini
[calendars]
[[local]]
path = ~/.calendars/*
type = discover
[locale]
timeformat = %H:%M
dateformat = %d/%m/%Y
longdateformat = %d/%m/%Y
datetimeformat = %d/%m/%Y %H:%M
longdatetimeformat = %d/%m/%Y %H:%M
[default]
default_calendar = personal
Rien de particulier a dire sur cette configuration qui me parrait plutôt claire.
.. code-block:: console
$ khal list
No events
$ khal search dentiste
02/07/2021 10:30-02/07/2021 11:30 Dentiste Dr Brutal
$ khal --help
Usage: khal [OPTIONS] COMMAND [ARGS]...
Options:
-v, --verbosity LVL Either CRITICAL, ERROR,
WARNING, INFO or DEBUG
-l, --logfile LOGFILE The logfile to use [defaults
to stdout]
-c, --config PATH The config file to use.
--color / --no-color Use colored/uncolored output.
Default is to only enable
colors when not part of a
pipe.
--version Show the version and exit.
--help Show this message and exit.
Commands:
at Print all events at a specific
datetime...
calendar Print calendar with agenda.
configure Helper for initial configuration of
khal.
edit Interactively edit (or delete)
events...
import Import events from an .ics file (or
stdin).
interactive Interactive UI.
list List all events between a start
(default:...
new Create a new event from arguments.
printcalendars List all calendars.
printformats Print a date in all formats.
printics Print an ics file (or read from
stdin)...
search Search for events matching
SEARCH_STRING.