# 使用 Homebrew, apk, apt, dnf, Nix, pacman, zypper 安装 vdirsyncer

查看 vdirsyncer 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:vdirsyncer
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install vdirsyncer
```

  证据: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add vdirsyncer
```

  证据: 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
```

  证据: 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
```

  证据: 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
```

  证据: 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
```

  证据: 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
```

  证据: openSUSE Tumbleweed package metadata: python313-vdirsyncer from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## 软件包事实

- **软件包键:** brew:vdirsyncer
- **软件包管理器:** Homebrew
- **版本:** 0.20.0
- **来源摘要:** Synchronize calendars and contacts
- **主页:** <https://github.com/pimutils/vdirsyncer>
- **仓库:** <https://github.com/pimutils/vdirsyncer>
- **最后更新:** 2026-06-09T13:20:34Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- vdirsyncer (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.20.0
## 项目历史与用法

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.

### 项目历史

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.

### 采用历史

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.

### 使用方式

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.

### 为什么软件包爱好者会关心

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.

### 时间线

- 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.

### 来源

- <https://api.github.com/repos/pimutils/vdirsyncer>
- <https://github.com/pimutils/vdirsyncer>
- <https://pimutils.org/>
- <https://unterwaditzer.net/2014/vdirsyncer.html>
- <https://vdirsyncer.pimutils.org/_/downloads/en/0.16-maintenance/pdf/>
- <https://vdirsyncer.pimutils.org/en/stable/changelog.html>
- <https://vdirsyncer.pimutils.org/en/stable/tutorial.html>
- <https://whynothugo.nl/journal/2022/04/18/a-vdirsyncer-rewrite/>


## 安全说明

formula declares a Homebrew service.

- **Geiger 风险:** orange / 中
- 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
## 其他软件包管理器记录

- 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)


## 来源

- 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
