Big issues with contacts on macOS - finally solved

Open
#286 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
35/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Stale
Tech stack
python
Domain
documentation

Research direction

The report describes two CardDAV setup problems: macOS requires the server URL to include https://, and contacts may sync into a different collection. Start by locating the setup instructions and any CardDAV URL or collection handling they describe. Document the confirmed URL requirement and clarify how users can find or select the collection; the issue gives no specific files or tests to start from.

Written by the indexing model from the issue text.

Description

I thought somebody may be interested in this story.

I struggled a lot to get contact sync working on macOS. My calendars worked fine, SSL was set up.

Setup

It turns out that the protocol really matters. Initially I omitted it because the example in the text field was "example.com", just bare. But with the https:// omitted, the mac wouldn't contact the server at all, always responding "Unable to verify account name or password" (even after sometimes allowing adding the account and then asking for the password again later). This also applies to the advanced mode with SSL explicitly enabled.

Actual sync

WIth that out of the way I could finally see my ... where are my contacts? Nothing would show up at all. There wouldn't be any errors and I could create contacts, but they wouldn't show up in my collection. ... it turns out that they showed up in another contacts collection. Not a huge surprise, since at no point did I have to specify which one to use (Apple Contacts has lists for this, but I don't know whether that's also a CardDAV concept). Maybe it would be good to be able to specify which collection to use via the URL. If you already can, it would be nice to have it documented.
My fix was eventually to delete all contacts collections except for the main one. And - oh look - my contacts would appear.

Maybe this report will help somebody with similar frustrations.
These pitfalls should probably be documented or fixed.

Dominant language
Python
Stars
332
Forks
61
PR merge metrics
No merged PRs in 30d

Getting set up

  • Ships a Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from etesync/etesync-dav

All issues in etesync/etesync-dav

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.