Перейти к содержимому

Интеграции14 нояб. 2026 г.5 минут чтения

CalDAV

Большинство календарных серверов работают по открытому стандарту CalDAV. Аккаунт CalDAV подключается прямо из приложения, без какой-либо настройки на сервере, и Mitra синхронизирует его события и задачи в обе стороны.

Ваши календари остаются на вашем сервере, поэтому все остальные приложения CalDAV, которыми вы пользуетесь, например календарь на телефоне, видят те же записи. В этом отличие от календарей Mitra, которые может открыть только Mitra.

  1. Выберите Добавить интеграцию внизу боковой панели, а затем CalDAV.
  2. Заполните форму:
    • URL сервера: адрес CalDAV вашего сервера, например https://caldav.example.com. Для популярных провайдеров он указан в таблице ниже.
    • Имя пользователя: обычно имя вашего аккаунта или адрес электронной почты.
    • Пароль: пароль от аккаунта или пароль приложения, если ваш провайдер его выдаёт.
  3. Нажмите Подключить. Mitra покажет календари аккаунта, все включённые, и укажет, что хранится в каждом, например «События · Задачи».
  4. Выключите ненужные и нажмите Сохранить.

Mitra импортирует оставленные календари, а затем синхронизирует их каждые 10 секунд, пока приложение открыто (подробнее в разделе Как работает синхронизация).

Чтобы позже сменить пароль, откройте меню ⋯ аккаунта на боковой панели, выберите Изменить, введите новый пароль и нажмите Сохранить. URL сервера и имя пользователя изменить нельзя; другой аккаунт подключите отдельно.

Адреса серверов популярных провайдеров

Section titled “Адреса серверов популярных провайдеров”

Укажите адрес CalDAV провайдера, и Mitra найдёт по нему календари.

Если в адресе указан пользователь, например https://<your-radicale>/<user>/, Mitra покажет календари этого пользователя, а не ваши, в той мере, в какой сервер открыл вам к ним доступ. Каждый такой адрес подключайте отдельно.

ПровайдерURL сервера
Nextcloudhttps://<your-nextcloud>/remote.php/dav
Radicalehttps://<your-radicale>/ (или .../<user>/)
Fastmailhttps://caldav.fastmail.com/
mailbox.orghttps://dav.mailbox.org/
Baïkalhttps://<your-baikal>/dav.php

Google Календарь и iCloud тоже поддерживают CalDAV, но не принимают обычный пароль: Google просит войти на своей странице, а Apple требует пароль приложения. Поэтому используйте для них отдельные плитки, как описано в разделах Google Календарь и Календарь Apple.

Каждый календарь на сервере соответствует одному календарю в Mitra. В нём хранятся события, задачи или и то и другое, в зависимости от того, что разрешает сервер. Большинство серверов разрешают и то и другое; в календаре, который принимает только один вид записей, новые записи всегда будут этого вида.

Синхронизируется всё, что Mitra хранит о записи, если ваш сервер это сохраняет:

  • Записи на весь день и на несколько дней, места, описания, цвета и напоминания.
  • Отображается ли запись как занятое или свободное время, а также её видимость.
  • Статус и прогресс задачи.
  • Участники. Приглашения рассылает и ответы собирает ваш сервер.
  • Подзадачи и зависимости.
  • Вложения. Другие приложения, работающие с тем же календарём, видят файлы, а Mitra показывает файлы, добавленные ими.

NOTE

Другие календарные приложения читают у отдельных записей только названия цветов, поэтому показывают цвет записи как ближайшее название, например синий цвет Mitra как steelblue. Mitra сохраняет точный цвет, и другие установки Mitra тоже его считывают, кроме как через Google, который его отбрасывает.

Повторяющаяся запись остаётся на сервере одной серией. Когда вы изменяете одно повторение, Mitra спрашивает, что вы имеете в виду: Эта запись, Эта и последующие записи или Все записи, и соответственно изменяет серию.

Задача сохраняет время в календаре, срок и оценку времени. На сервере они сохраняются так:

  • Начало как DTSTART.
  • Длительность как ESTIMATED-DURATION: на сколько задача запланирована или, пока у неё нет начала, её оценка времени.
  • Срок как DUE.

Задача с началом, но без длительности, считается моментом.

Календари, к которым вам открыли доступ только для просмотра, помечаются как доступные только для чтения. Их по-прежнему можно переименовывать, менять им цвет и порядок и скрывать; подробнее в разделе Календари только для чтения.

Доступность, которую вы отметили как Занят, добавляется в её календарь в виде событий с пометкой «занят», поэтому это время отображается как занятое на вашем телефоне и для всех, кто вас приглашает. Настраивать ничего не нужно.

  • Каждая занятая доступность становится повторяющимся событием с тем же временем и правилом повтора, отмеченным как занятое. Событие получает название доступности, а если его нет, то «Занят», а также её место и видимость, например Личная.
  • В самом Mitra вы видите саму доступность, а не эти события, чтобы время не показывалось дважды.
  • Mitra поддерживает события в соответствии с вашей доступностью. Если событие изменили, переместили или удалили в другом приложении, Mitra восстановит его при следующей синхронизации.
  • События удаляются, если снова отметить доступность как Свободен, удалить её, выключить её календарь или удалить аккаунт. Если переместить доступность в другой календарь, её события переместятся вместе с ней.
  • В календарь, который хранит только задачи или в который у вас нет права записи, события не добавляются.

NOTE

Изменения отдельного дня занятой доступности не переносятся. Событие по-прежнему следует правилу повтора, поэтому день, который вы сдвинули или сократили, другие видят в обычное время.

Так же это работает для Google Календаря и Календаря Apple, к которым Mitra тоже подключается по CalDAV.

  • Если какого-то календаря нет, значит, он выключен. Так бывает с календарями, которые вы выключили при подключении, и с календарями, созданными на сервере позже: Mitra добавляет их выключенными. Включите его в меню аккаунта ⋯ → Изменить и нажмите Сохранить. Кнопка Обновить там показывает календари, созданные на сервере после последней синхронизации.
  • Если Mitra сообщает «Этот аккаунт уже подключён», значит, аккаунт уже есть на боковой панели. Измените его через меню ⋯ → Изменить, например чтобы ввести новый пароль.
  • Если подключиться не удаётся, проверьте, что URL сервера начинается с https:// и ведёт на адрес CalDAV, а не на веб-страницу, где вы входите в аккаунт. Чтобы видеть все запросы Mitra к серверу, установите уровень журналирования debug.
  • Если после обновления Mitra календарь выглядит неправильно, выберите Импортировать записи заново в его меню ⋯. При синхронизации загружается только то, что изменилось на сервере, поэтому неизменённые записи больше не читаются; повторный импорт читает их все. Подробнее в разделе Импортируйте календарь заново.