# Install vdirsyncer with Homebrew, apk, apt, dnf, Nix, pacman, zypper Synchronize calendars and contacts. Version 0.20.0 via Homebrew; verified 2026-06-09. Also installable with debian: sudo apt install vdirsyncer. ## 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 vdirsyncer ``` Evidence: Fedora Rawhide package metadata: vdirsyncer from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#vdirsyncer ``` Evidence: nixpkgs package indexes: pkgs/by-name/vd/vdirsyncer/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - 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 python313-vdirsyncer ``` Evidence: openSUSE Tumbleweed package metadata: python313-vdirsyncer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst ## Package facts - **Package key:** brew:vdirsyncer - **Package manager:** Homebrew - **Version:** 0.20.0 - **Source summary:** Synchronize calendars and contacts - **Homepage:** - **Repository:** - **Last updated:** 2026-06-09T13:20:34Z - **Generated:** 2026-08-03T19:37:03+00:00 ## Executables - vdirsyncer (alias) ## Install behavior - Bottle: not available ## Freshness - Page generated: 2026-08-03 - Package-manager version: 0.20.0 ## 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 ## 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: pkgs/by-name/vd/vdirsyncer/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - 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-7.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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Synchronize calendars and contacts | https://github.com/pimutils/vdirsyncer - dnf - vdirsyncer - 0.20.0-7.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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Synchronize calendars and contacts | https://github.com/pimutils/vdirsyncer - dnf - vdirsyncer-doc - 0.20.0-7.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/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-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 - python313-vdirsyncer - 0.20.0-1.5: normalized package name match | openSUSE Tumbleweed package metadata: python313-vdirsyncer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | CalDAV and CardDAV synchronization module | https://github.com/pimutils/vdirsyncer - zypper - python314-vdirsyncer - 0.20.0-1.5: normalized package name match | openSUSE Tumbleweed package metadata: python314-vdirsyncer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | CalDAV and CardDAV synchronization module | https://github.com/pimutils/vdirsyncer ## Combined YAML source View the package source record on GitHub. [combined/vdirsyncer.yml](https://github.com/mxcl/pkgdb/blob/main/combined/vdirsyncer.yml) ## Sources - pkg.so package database - Geiger risk classifier - curated configuration and credential file locations - curated package history - pkgdb category and tag curation - external package-manager database matches - cross-ecosystem install command graph