vdirsyncer/README.rst
2014-12-15 15:55:54 -03:00

39 lines
1.6 KiB
ReStructuredText

==========
vdirsyncer
==========
Vdirsyncer synchronizes your calendars and addressbooks between two storages.
The most popular purpose is to synchronize CalDAV and CardDAV with a local
folder or file. The local data can then be `accessed via a variety of programs
<https://vdirsyncer.readthedocs.org/en/latest/supported.html>`_, none of which
have to know or worry about syncing to a server.
It aims to be for CalDAV and CardDAV what `OfflineIMAP
<http://offlineimap.org/>`_ is for IMAP.
.. image:: https://travis-ci.org/untitaker/vdirsyncer.png?branch=master
:target: https://travis-ci.org/untitaker/vdirsyncer
.. image:: https://coveralls.io/repos/untitaker/vdirsyncer/badge.png?branch=master
:target: https://coveralls.io/r/untitaker/vdirsyncer?branch=master
Installation and usage
======================
If you already have it installed and want to quickly configure it, copy the
``example.cfg`` to ``~/.vdirsyncer/config`` [1]_ and edit it.
If that method doesn't work for you or you want a deeper understanding of what
you just did, check out `the tutorial
<https://vdirsyncer.readthedocs.org/en/latest/tutorial.html>`_.
.. [1] The configuration file can also be placed in ``$XDG_CONFIG_HOME/vdirsyncer/config`` (normally ``~/.config/vdirsyncer/config``) for XDG-Basedir spec compliance.
Donations
=========
.. image:: https://img.shields.io/gratipay/untitaker.svg
:target: https://gratipay.com/untitaker/
.. image:: https://api.flattr.com/button/flattr-badge-large.png
:target: https://flattr.com/submit/auto?user_id=untitaker&url=https%3A%2F%2Fgithub.com%2Funtitaker%2Fvdirsyncer