CalDAV Calendar (vdirsyncer + khal)

CalDAV Calendar (vdirsyncer + khal) — это инструмент для синхронизации и работы с календарями CalDAV (iCloud, Google, Fastmail, Nextcloud и др.) с использованием связки vdirsyncer и khal. Работает в Linux и позволяет управлять событиями напрямую из командной строки.

vdirsyncer синхронизирует календари в локальные файлы формата .ics, а khal используется для чтения и записи этих данных.

Сначала синхронизация

Перед любыми запросами или после внесения изменений всегда выполняйте синхронизацию:

vdirsyncer sync

Просмотр событий

khal list # Сегодня
khal list today 7d # Ближайшие 7 дней
khal list tomorrow # Завтра
khal list 2026-01-15 2026-01-20 # Диапазон дат
khal list -a Work today # Конкретный календарь

Поиск

khal search "meeting"
khal search "dentist" --format "{start-date} {title}"

Создание событий

khal new 2026-01-15 10:00 11:00 "Название встречи"
khal new 2026-01-15 "Событие на весь день"
khal new tomorrow 14:00 15:30 "Звонок" -a Work
khal new 2026-01-15 10:00 11:00 "С заметками" :: Описание события

После создания события выполните синхронизацию, чтобы отправить изменения на сервер:

vdirsyncer sync

Редактирование событий (интерактивно)

Команда khal edit работает в интерактивном режиме и требует TTY. Для автоматизации можно использовать tmux:

khal edit "поисковый запрос"
khal edit -a CalendarName "поисковый запрос"
khal edit --show-past "старое событие"

Доступные действия в меню:

• s — изменить заголовок
• d — изменить описание
• t — изменить дату и время
• l — изменить локацию
• D — удалить событие
• n — пропустить (сохранить и перейти дальше)
• q — выйти

После редактирования обязательно синхронизируйте изменения:

vdirsyncer sync

Удаление событий

Удаление выполняется через khal edit — выберите событие и нажмите D.

Форматы вывода

Для использования в скриптах можно задать формат вывода:

khal list --format "{start-date} {start-time}-{end-time} {title}" today 7d
khal list --format "{uid} | {title} | {calendar}" today

Доступные плейсхолдеры: {title}, {description}, {start}, {end}, {start-date}, {start-time}, {end-date}, {end-time}, {location}, {calendar}, {uid}. :

Кэширование

khal кэширует события в файле ~/.local/share/khal/khal.db. Если данные устарели после синхронизации — удалите файл кэша и выполните повторную синхронизацию. :

Начальная настройка

1. Настройте vdirsyncer (файл ~/.config/vdirsyncer/config) — укажите CalDAV-провайдера (например, iCloud, Google или Nextcloud).

2. Настройте khal (файл ~/.config/khal/config) — укажите путь к календарям и параметры отображения.

3. Выполните первичное обнаружение и синхронизацию:

vdirsyncer discover
vdirsyncer sync

После этого система готова к работе — вы можете просматривать, создавать и редактировать события прямо из терминала без использования графического интерфейса. :