Supported Software

Client applications

The following software has been reported to work well with vdirsyncer, however, none of it is regularly tested.

Calendars

  • khal, a CLI calendar application supporting vdir. You can use vdirsyncer.storage.FilesystemStorage with it.
  • Many graphical calendar apps such as dayplanner, Orage or rainlendar save a calendar in a single .ics file. You can use vdirsyncer.storage.SingleFileStorage with those.

Contacts

Supported servers

CalDAV and CardDAV servers not listed here may work anyway.

Radicale

Radicale is a very lightweight server, however, it intentionally doesn’t implement the CalDAV and CardDAV standards completely, which might lead to issues even with very well-written clients.

That said, vdirsyncer is continuously tested against the git version and the latest PyPI release of Radicale. Older versions have substantial deficiencies, and using them is neither supported nor encouraged.

ownCloud

Vdirsyncer is continuously tested against the latest version of ownCloud.

  • Versions older than 7.0.0: ownCloud uses SabreDAV, which had problems detecting collisions and race-conditions. The problems were reported and are fixed in SabreDAV’s repo, and the corresponding fix is also in ownCloud since 7.0.0. See issue #16 for more information.

FastMail

Vdirsyncer is irregularly tested against FastMail. There are no known issues with it. FastMail’s support pages provide the settings to use:

[storage cal]
type = caldav
url = https://caldav.messagingengine.com/
username = ...
password = ...

[storage card]
type = carddav
url = https://carddav.messagingengine.com/
username = ...
password = ...

iCloud

Vdirsyncer is irregularly tested against iCloud. There are no known issues with it.

[storage cal]
type = caldav
url = https://caldav.icloud.com/
username = ...
password = ...

[storage card]
type = carddav
url = https://contacts.icloud.com/
username = ...
password = ...

DavMail (Exchange, Outlook)

Using vdirsyncer with DavMail is currently not recommended (if even possible).

  • DavMail (or the server it is proxying) handles URLs case-insensitively. See issue #144.

Baikal

Vdirsyncer is continuously tested against the latest version of Baikal.

  • Baikal up to 0.2.7 also uses an old version of SabreDAV, with the same issue as ownCloud, see issue #160.

Google

Vdirsyncer can currently download events from Google Calendar, but any writing/uploading is explicitly prohibited by Google. Google’s support forum explains how to set up its CalDAV support:

[storage cal]
type = caldav
url = https://www.google.com/calendar/dav/
username = ...
password = ...
read_only = true

Unfortunately vdirsyncer current doesn’t support Google Contacts in any way.

See issue #8 for the discussion.