# Календар

Як працює експорт Календаря, від під'єднання до розв'язання проблем.

## Під'єднання

Натисніть «Підключити» поруч із Календарем на головному екрані Exporter, потім «Відкрити папку календаря». Вікно відкривається в теці Календаря, `~/Library/Group Containers/group.com.apple.calendar`: натисніть «Вибрати цю папку». Далі виберіть, куди підуть файли, і натисніть «Використати цю теку».

macOS не просить доступу до календаря, і Exporter ніколи його не просить: події читаються з бази всередині дозволеної теки, а не через EventKit. Вікно дозволу, яке ви бачили в інших застосунках, належить тому іншому шляху.

## Куди йдуть файли

Один файл Markdown на місяць, в одній теці: `2026-09.md`, `2026-10.md`. Тека просто у вашій домашній теці, як-от `~/Documents`, отримує всередині теку `calendar-export`; глибша, як-от `~/Documents/kalendar`, береться такою, як є. Місяць без подій файла не отримує.

## Що експортується

Кожна подія в календарях, позначених на картці, в межах налаштованого періоду. Вибір групує календарі під їхніми обліковими записами, як бічна панель Календаря, тож одне знімання позначки може лишити осторонь обліковий запис.

Подія належить до місяця, у якому починається, рівно один раз, навіть якщо триває за межі кінця місяця.

## Повторення

Повторювана подія є в кожен день, коли вона стається, а не лише в день, коли її створили. Exporter читає входження, які Календар тримає для власних переглядів, тож файл збігається із застосунком, а рядок каже, як подія повторюється.

## Формат

Завжди Markdown: frontmatter місяця, далі заголовок на день і один рядок на подію.

День починається з подій на цілий день, далі йде за часом початку, тобто в порядку, у якому Календар його малює. Подія на цілий день пише «all day»; вона ніколи не отримує 00:00, якого не мала.

## Файл

| ключ | містить |
| --- | --- |
| `title`, `month` | «Календар, вересень 2026» і `2026-09` |
| `events` | скільки подій містить файл |
| `calendars` | календарі місяця, найповніший перший |

Рядок це час, подія, календар, з якого вона прийшла, і де відбувається, далі поля, які може запитати vault:

| поле | містить |
| --- | --- |
| `repeats::` | `daily`, `weekly`, `every 2 weeks` |
| `join::` | посилання на відеодзвінок, якщо подія його має |
| `with::` | скільки людей у ній |

```markdown
## 2026-09-17, четвер

- all day День народження Мерилін · Дні народження
- 09:30-10:00 Standup · Робота · Zoom [repeats:: weekly] [with:: 6]
- 13:00-14:00 Обід із Кевіном · Особисте · Philz Coffee
```

## Як далеко назад читає

Рядок «reads» на картці: цей рік, 2 роки, 5 років або все. Він змінює, які файли пишуться, тож вужчий період це менший експорт.

Календар тримає близько двох років входжень для власних переглядів, і це все, що є прочитати: на справжньому Mac 2 роки, 5 років і все повертають ті самі події. «все» означає все, що має цей Mac, а не все, що будь-коли сталося.

## Безкоштовно і після розблокування

Перші 100 подій безкоштовні, і такими лишаються. Розблокування Календаря експортує решту ([ціни](https://exporter.dev/pricing)).

## Синхронізація і повна синхронізація

Після першого «sync now» Exporter переписує місяць, коли в ньому щось змінюється, щонайбільше раз на хвилину. Перенесення події переписує її місяць, і лише його.

«full resync» спершу питає, далі прибирає файли місяців, які написав Exporter, і пише наново кожен позначений календар. Усе інше в теці лишається.

## Проблеми і розв'язання

- «no calendar database in that folder (pick the Calendar folder itself)»: натисніть «connect» ще раз і виберіть теку, у якій відкривається вікно
- бракує календаря: з нього знято позначку на картці, або знято з усього його облікового запису. Вибір групує календарі за обліковим записом
- бракує старих подій: рядок «reads» стоїть на коротшому періоді, або сам Календар їх уже не має
- ваші нагадування в експорті: Календар показує заплановані нагадування як окремий календар. Зніміть позначку з облікового запису «Reminders» на картці

## Related

- [Календар](https://exporter.dev/uk/calendar): Кожен місяць як файл Markdown
- [Нагадування](https://exporter.dev/uk/docs/reminders): Файли списків, поля й рішення
- [Сервер MCP](https://exporter.dev/uk/docs/mcp): Під’єднайте Claude та інших агентів

---

human version: https://exporter.dev/uk/docs/calendar
every page: https://exporter.dev/llms.txt
