vdirsyncer 0.1.3

A syncronization tool for vdir

vdirsyncer synchronizes your calendars and addressbooks between two storages. The supported storages are CalDAV, CardDAV, arbitrary HTTP resources and vdir.

It aims to be for CalDAV and CardDAV what OfflineIMAP is for IMAP.

While i use it daily and haven’t experienced data loss (even when vdirsyncer crashed), i don’t know if the documentation is sufficient. If you have any questions regarding the usage, feel free to open a new issue.

CardDAV/CalDAV Server Support

vdirsyncer is currently tested against the latest versions of Radicale and ownCloud. While Radicale seems to work perfectly, ownCloud currently has problems detecting collisions and race-conditions. However, given that this is a problem with every setup involving ownCloud, and that ownCloud is widely used, it apparently isn’t big enough of a problem yet.

See Bug #16 for informations on problems with ownCloud.

How to use

As all Python packages, vdirsyncer can be installed with pip:

pip install --user vdirsyncer  # use the pip for Python 2

Then copy example.cfg to ~/.vdirsyncer/config and edit it. You can use the VDIRSYNCER_CONFIG environment variable to change the path vdirsyncer will read the config from.

Run vdirsyncer --help. If you experience any problems, consult the wiki’s troubleshooting page or create a new issue.

How to run the tests

sh install-deps.sh
py.test tests/

License

vdirsyncer is released under the MIT License, see LICENSE for more details.