# Install vdirsyncer with Homebrew, apk, apt, dnf, Nix, pacman, zypper Synchronize calendars and contacts. Version 0.20.0 via Homebrew; verified 2026-06-09. ## Install ```sh sudo av install brew:vdirsyncer ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install vdirsyncer ``` Evidence: local Homebrew formula metadata ### Linux - apk (92%): ```sh sudo apk add vdirsyncer ``` Evidence: Alpine Linux edge package indexes: vdirsyncer from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - Debian apt (92%): ```sh sudo apt install vdirsyncer ``` Evidence: Debian stable package indexes: vdirsyncer from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install python3-vdirsyncer ``` Evidence: Fedora Rawhide package metadata: python3-vdirsyncer from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#vdirsyncer ``` Evidence: nixpkgs package indexes: vdirsyncer from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix - pacman (92%): ```sh sudo pacman -S vdirsyncer ``` Evidence: Arch Linux sync databases: vdirsyncer from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install python311-vdirsyncer ``` Evidence: openSUSE Tumbleweed package metadata: python311-vdirsyncer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:vdirsyncer - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.20.0 - **Source summary:** Synchronize calendars and contacts - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** BSD-3-Clause - **Source archive:** - **Last updated:** 2026-06-09T13:20:34Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - vdirsyncer (cli) - vdirsyncer (alias) ## Dependencies - certifi - python@3.14 ## Install behavior - Post-install hook: not defined - Service: declared - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sequoia, sonoma, tahoe, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.20.0 - Package-manager updated: 2026-06-09 - Local data: ok - Upstream repository: https://github.com/pimutils/vdirsyncer - info: No cached GitHub release or tag data was available. ## Project history and usage vdirsyncer is a command-line synchronization tool for calendars and address books. It bridges CalDAV, CardDAV, Google-style DAV access, local vdir directories, and other storages so terminal applications can edit local .ics and .vcf data while servers remain in sync. Its README summarizes the intent as doing for calendars and contacts what OfflineIMAP did for email: keep local files and remote servers synchronized while letting users choose their preferred local clients. ### Project history The pimutils/vdirsyncer repository was created on 2014-02-15. Markus Unterwaditzer's 2014 project-history post explains the motivation in the context of leaving monolithic desktop PIM applications behind and preferring command-line applications with flat-file state. The changelog shows rapid early development through 2014 and 2015 around DAV compatibility, authentication, collection discovery, configuration format, iCloud, Baikal, ownCloud, Zimbra, Radicale, and metadata handling. In March 2016, vdirsyncer moved to the pimutils organization on GitHub, making it part of a broader command-line personal-information-management suite. ### Adoption history vdirsyncer became a core component in the pimutils ecosystem. The pimutils site describes the suite as command-line tools for contacts, calendars, and tasks, listing khal, todoman, and vdirsyncer together and noting that these programs use standards-based vdir storage for local data. The adoption pattern is less about mass-market visibility and more about durable Unix-workflow integration. Users pair vdirsyncer with khal for calendars, khard or other vCard tools for contacts, todoman for tasks, cron or systemd timers for periodic sync, and CalDAV/CardDAV servers such as Nextcloud, Radicale, Baikal, iCloud, FastMail, or Google endpoints. ### How it is used A typical setup defines storage sections and pair sections in the config file, runs vdirsyncer discover to discover remote collections, then runs vdirsyncer sync to move changed items. The official tutorial explains that synchronized address books become local folders containing one .vcf file per contact, and calendar sync follows the same pattern with .ics files. Conflict handling is explicit rather than magical. The tutorial documents conflict-resolution choices: stop with an error by default, choose one side, or run a merge command supplied by the user. ### Why package nerds care vdirsyncer is significant because it turns personal information management into a standards-and-files problem. The local vdir layout lets unrelated applications cooperate over ordinary files, while vdirsyncer handles the messy CalDAV/CardDAV protocol edge cases. For package maintainers, it is also a classic Python CLI maintenance story: the changelog records changing Python support windows, dependency changes, packaging guidelines, and distribution-facing fixes. The later pimsync work in the same ecosystem reflects accumulated lessons about modularity and packaging pain. ### Timeline - 2014-02-15: The pimutils/vdirsyncer GitHub repository was created. - 2014-06-12: Version 0.2.0 was released, adopting PyPI's icalendar package and requests-toolbelt. - 2014-12-31: Version 0.4.0 rewrote collection discovery and added XDG config lookup. - 2016-03-22: Version 0.9.3 moved the project to the pimutils GitHub organization. - 2016-09-29: Version 0.13.0 dropped Python 2 support. - 2017-06-02: Version 0.16.0 improved DAV discovery and Google storage behavior. - 2020-06-09: Version 0.16.8 was released for newer Python compatibility and marked final support for Python 3.5 and 3.6. - 2024-2025: pimutils published vdirsyncer 2.0 alpha/beta news and pimsync successor work. ### Related projects - vdirsyncer is closely related to khal, khard, todoman, pimsync, and the vdir storage format. It also occupies the same conceptual space as OfflineIMAP: a synchronizer that keeps server-backed personal data available as local files. ### Sources - - - - - - - - ## Security Notes formula declares a Homebrew service. - **Geiger risk:** orange / medium - formula declares a Homebrew service ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: $VDIRSYNCER_CONFIG, $XDG_CONFIG_HOME/vdirsyncer/config, ~/.config/vdirsyncer/config, ~/.vdirsyncer/config ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** vdirsyncer - **Version Scheme:** 0 - **Revision:** 7 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Debian apt - vdirsyncer - 0.19.3-3: normalized package name match | Debian stable package indexes: vdirsyncer from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Synchronize calendars and contacts | https://github.com/pimutils/vdirsyncer - Debian apt - vdirsyncer-doc - 0.19.3-3: normalized package name match | Debian stable package indexes: vdirsyncer-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Synchronize calendars and contacts - documentation | https://github.com/pimutils/vdirsyncer - Nix - vdirsyncer: normalized package name match | nixpkgs package indexes: vdirsyncer from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix - Ubuntu apt - vdirsyncer - 0.19.2-1: normalized package name match | Ubuntu 24.04 LTS package indexes: vdirsyncer from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Synchronize calendars and contacts | https://github.com/pimutils/vdirsyncer - Ubuntu apt - vdirsyncer-doc - 0.19.2-1: normalized package name match | Ubuntu 24.04 LTS package indexes: vdirsyncer-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Synchronize calendars and contacts - documentation | https://github.com/pimutils/vdirsyncer - apk - vdirsyncer - 0.20.0-r2: normalized package name match | Alpine Linux edge package indexes: vdirsyncer from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | CLI Synchronization for CalDAV and CardDAV | http://vdirsyncer.pimutils.org - apk - vdirsyncer-doc - 0.20.0-r2: normalized package name match | Alpine Linux edge package indexes: vdirsyncer-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | CLI Synchronization for CalDAV and CardDAV (documentation) | http://vdirsyncer.pimutils.org - apk - vdirsyncer-google - 0.20.0-r2: normalized package name match | Alpine Linux edge package indexes: vdirsyncer-google from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | CLI Synchronization for CalDAV and CardDAV | http://vdirsyncer.pimutils.org - apk - vdirsyncer-pyc - 0.20.0-r2: normalized package name match | Alpine Linux edge package indexes: vdirsyncer-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for vdirsyncer | http://vdirsyncer.pimutils.org - dnf - python3-vdirsyncer - 0.20.0-6.fc45: normalized package name match | Fedora Rawhide package metadata: python3-vdirsyncer from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Synchronize calendars and contacts | https://github.com/pimutils/vdirsyncer - dnf - vdirsyncer - 0.20.0-6.fc45: normalized package name match | Fedora Rawhide package metadata: vdirsyncer from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Synchronize calendars and contacts | https://github.com/pimutils/vdirsyncer - dnf - vdirsyncer-doc - 0.20.0-6.fc45: normalized package name match | Fedora Rawhide package metadata: vdirsyncer-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documentation for vdirsyncer | https://github.com/pimutils/vdirsyncer - pacman - vdirsyncer - 0.20.0-4: normalized package name match | Arch Linux sync databases: vdirsyncer from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | Synchronize CalDAV and CardDAV | https://vdirsyncer.pimutils.org/en/stable/ - zypper - python311-vdirsyncer - 0.20.0-1.4: normalized package name match | openSUSE Tumbleweed package metadata: python311-vdirsyncer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | CalDAV and CardDAV synchronization module | https://github.com/pimutils/vdirsyncer - zypper - python313-vdirsyncer - 0.20.0-1.4: normalized package name match | openSUSE Tumbleweed package metadata: python313-vdirsyncer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | CalDAV and CardDAV synchronization module | https://github.com/pimutils/vdirsyncer - zypper - python314-vdirsyncer - 0.20.0-1.4: normalized package name match | openSUSE Tumbleweed package metadata: python314-vdirsyncer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | CalDAV and CardDAV synchronization module | https://github.com/pimutils/vdirsyncer ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [diary](https://www.automicvault.com/pkg/brew/diary/) - Shares av.db curated category or tags: caldav, calendar, cli, productivity. - [khal](https://www.automicvault.com/pkg/brew/khal/) - Shares av.db curated category or tags: caldav, calendar, cli, productivity. - [khard](https://www.automicvault.com/pkg/brew/khard/) - Shares av.db curated category or tags: carddav, cli, contacts, productivity. - [abook](https://www.automicvault.com/pkg/brew/abook/) - Shares av.db curated category or tags: cli, contacts, productivity. - [calcurse](https://www.automicvault.com/pkg/brew/calcurse/) - Shares av.db curated category or tags: calendar, cli, productivity. - [ccal](https://www.automicvault.com/pkg/brew/ccal/) - Shares av.db curated category or tags: calendar, cli, productivity. - [ddate](https://www.automicvault.com/pkg/brew/ddate/) - Shares av.db curated category or tags: calendar, cli, productivity. - [gcalcli](https://www.automicvault.com/pkg/brew/gcalcli/) - Shares av.db curated category or tags: calendar, cli, productivity. - [offlineimap](https://www.automicvault.com/pkg/brew/offlineimap/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, productivity, python, python-3-14. - [bagels](https://www.automicvault.com/pkg/brew/bagels/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, productivity, python, python-3-14. ## Combined YAML source View the package source record on GitHub. [combined/vdirsyncer.yml](https://github.com/automic-vault/db/blob/main/combined/vdirsyncer.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph