You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Hugo Barrera 68ff37e677
Merge pull request #830 from pimutils/next
4 weeks ago
.github/workflows Add GitHub Action to publish releases 1 month ago
contrib Add systemd.timer files and a relevant tutorial (#635) 3 years ago
docker Test baikal using docker 1 month ago
docs Merge remote-tracking branch 'origin/master' into next 4 weeks ago
scripts Merge remote-tracking branch 'origin/master' into next 4 weeks ago
tests Merge remote-tracking branch 'origin/master' into next 4 weeks ago
vdirsyncer Update usage of deprecated method 1 month ago
.codecov.yml Use codecov tags 3 years ago
.coveragerc Refactor CI setup 3 years ago
.gitignore Make a maintenance release of vdirsyncer, fix #708 2 years ago
.gitmodules Test baikal using docker 1 month ago
.pre-commit-config.yaml Sort imports 1 month ago
.travis.yml Merge remote-tracking branch 'origin/master' into next 4 weeks ago
AUTHORS.rst Credit packagecloud 1 month ago
CHANGELOG.rst Prepare release 0.16.8 1 month ago
CODE_OF_CONDUCT.rst Add CODE_OF_CONDUCT.rst for completeness 3 years ago
CONTRIBUTING.rst Fix up links for new docs URL 3 years ago
ISSUE_TEMPLATE.md ISSUE_TEMPLATE: Clarify importance of debug output 3 years ago
LICENSE Update copyright year 1 month ago
MANIFEST.in Fix MANIFEST.in 3 years ago
Makefile Simplify coverage handling 1 month ago
README.rst Credit packagecloud 1 month ago
config.example config.example: Status path needs to be quoted (#573) 3 years ago
docker-compose.yaml Test baikal using docker 1 month ago
docs-requirements.txt (backport) Make docs build independent of app 2 years ago
setup.cfg Simplify coverage handling 1 month ago
setup.py Add compatibility with latest click 1 month ago
test-requirements.txt Simplify coverage handling 1 month ago

README.rst

==========
vdirsyncer
==========

.. image:: https://travis-ci.org/pimutils/vdirsyncer.svg?branch=master
:target: https://travis-ci.org/pimutils/vdirsyncer
:alt: CI status

.. image:: https://codecov.io/github/pimutils/vdirsyncer/coverage.svg?branch=master
:target: https://codecov.io/github/pimutils/vdirsyncer?branch=master
:alt: Codecov coverage report

.. image:: https://readthedocs.org/projects/vdirsyncer/badge/
:target: https://vdirsyncer.rtfd.org/
:alt: documentation

.. image:: https://img.shields.io/pypi/v/vdirsyncer.svg
:target: https://pypi.python.org/pypi/vdirsyncer
:alt: version on pypi

.. image:: https://img.shields.io/badge/deb-packagecloud.io-844fec.svg
:target: https://packagecloud.io/pimutils/vdirsyncer
:alt: Debian packages

.. image:: https://img.shields.io/pypi/l/vdirsyncer.svg
:target: https://github.com/pimutils/vdirsyncer/blob/master/LICENCE
:alt: licence: BSD

- `Documentation <https://vdirsyncer.pimutils.org/en/stable/>`_
- `Source code <https://github.com/pimutils/vdirsyncer>`_

Vdirsyncer is a command-line tool for synchronizing calendars and addressbooks
between a variety of servers and the local filesystem. The most popular usecase
is to synchronize a server with a local folder and use a set of other programs_
to change the local events and contacts. Vdirsyncer can then synchronize those
changes back to the server.

However, vdirsyncer is not limited to synchronizing between clients and
servers. It can also be used to synchronize calendars and/or addressbooks
between two servers directly.

It aims to be for calendars and contacts what `OfflineIMAP
<http://offlineimap.org/>`_ is for emails.

.. _programs: https://vdirsyncer.pimutils.org/en/latest/tutorials/

Links of interest
=================

* Check out `the tutorial
<https://vdirsyncer.pimutils.org/en/stable/tutorial.html>`_ for basic
usage.

* `Contact information
<https://vdirsyncer.pimutils.org/en/stable/contact.html>`_

* `How to contribute to this project
<https://vdirsyncer.pimutils.org/en/stable/contributing.html>`_

* `Donations <https://vdirsyncer.pimutils.org/en/stable/donations.html>`_

License
=======

Licensed under the 3-clause BSD license, see ``LICENSE``.