This is a CalDAV and CardDAV front-end/proxy for EteSync.

This package provides a local CalDAV and CardDAV server that proxies requests to an EteSync server for use with desktop CalDAV and CardDAV clients.

If all you want is to access your data from a computer, you are probably better off using the web app.

This is essentially a compatibility layer between EteSync and DAV clients.

This depends on the radicale_storage_etesync module and the Radicale server for operation.

Installation

pip install etesync-dav

Configuration and running

You need to first add an EteSync user using etesync-dav-manage, for example:

etesync-dav-manage add [email protected]

and then run the server: etesync-dav

After this, set up your CalDAV/CardDAV client to use the username and password you got from etesync-dav-manage, or alternatively run: etesync-dav-manage get [email protected] to get them again.

Depending on the client you use, the server path should either be:

• http://localhost:37358/
• http://localhost:37358/[email protected]/

On most clients this should automatically detect your calendars/address books. If it doesn't, it means you'd have to set your exact collection url for each collection which is not trivial to get at this point. In order to get it, you'd either need to get it using example.py from pyetesync, or copy it from the debug page in the EteSync app. When using example.py, the EteSync server address that should be used is https://api.etesync.com when interacting with the production server.

Client support

The following clients have been tested:

• Thunderbird
  • CardDAV: Works.
    • Notes: requires the CardBook plugin, path should include the username as above, and vCard version should be set to v4.0 when prompted
  • CalDAV: Only works when providing full collection path.

Known issues

• This package is missing startups script for automatic execution on startup.
• Due to an issue with one of the dependencies, some contacts, namely groups, will sometimes fail to work. Revelant PR: skarim/vobject#77