Kalendarz

Podłączenie

Naciśnij „Połącz” obok Kalendarza na ekranie głównym Exportera, a potem „Otwórz folder kalendarza”. Okno otwiera się w folderze Kalendarza, ~/Library/Group Containers/group.com.apple.calendar: naciśnij „Wybierz ten folder”. Potem wybierz, gdzie trafią pliki, i naciśnij „Użyj tego folderu”.

macOS nie prosi o dostęp do kalendarza, a Exporter nigdy o niego nie prosi: wydarzenia są czytane z bazy w udostępnionym folderze, a nie przez EventKit. Okno uprawnień, które znasz z innych aplikacji, należy do tamtej drogi.

Gdzie trafiają pliki

Jeden plik Markdown na miesiąc, w jednym folderze: 2026-09.md, 2026-10.md. Folder leżący wprost w katalogu domowym, na przykład ~/Documents, dostaje w środku folder calendar-export; głębszy, na przykład ~/Documents/kalendarz, jest brany taki, jaki jest. Miesiąc bez wydarzeń nie dostaje pliku.

Co jest eksportowane

Każde wydarzenie z kalendarzy zaznaczonych na karcie, w ustawionym zakresie. Wybór grupuje kalendarze pod ich kontami, tak jak pasek boczny Kalendarza, więc jedno odznaczenie może pominąć konto.

Wydarzenie trafia do miesiąca, w którym się zaczyna, dokładnie raz, nawet jeśli trwa poza koniec miesiąca.

Powtórzenia

Wydarzenie cykliczne jest w każdym dniu, w którym się odbywa, nie tylko w dniu, w którym je utworzono. Exporter czyta wystąpienia, które Kalendarz trzyma na potrzeby własnych widoków, więc plik zgadza się z aplikacją, a linia mówi, jak wydarzenie się powtarza.

Format

Zawsze Markdown: frontmatter miesiąca, potem nagłówek na dzień i jedna linia na wydarzenie.

Dzień zaczyna się od wydarzeń całodniowych, potem idzie według godziny rozpoczęcia, czyli w kolejności, w jakiej Kalendarz go rysuje. Wydarzenie całodniowe pisze „all day”; nigdy nie dostaje 00:00, którego nie miało.

Plik

klucz	zawiera
title, month	„Kalendarz, wrzesień 2026” oraz 2026-09
events	ile wydarzeń zawiera plik
calendars	kalendarze miesiąca, najpełniejszy pierwszy

Linia to godzina, wydarzenie, kalendarz, z którego pochodzi, i gdzie się odbywa, a potem pola, o które vault może zapytać:

pole	zawiera
repeats::	daily, weekly, every 2 weeks
join::	link do wideorozmowy, jeśli wydarzenie go ma
with::	ile osób w nim jest

## 2026-09-17, czwartek

- all day Urodziny Marilyn · Urodziny
- 09:30-10:00 Standup · Praca · Zoom [repeats:: weekly] [with:: 6]
- 13:00-14:00 Obiad z Kevinem · Prywatne · Philz Coffee

Jak daleko wstecz czyta

Wiersz „reads” na karcie: ten rok, 2 lata, 5 lat albo wszystko. Zmienia, które pliki są zapisywane, więc węższy zakres to mniejszy eksport.

Kalendarz trzyma około dwóch lat wystąpień na potrzeby własnych widoków i tyle jest do odczytania: na prawdziwym Macu 2 lata, 5 lat i wszystko zwracają te same wydarzenia. „wszystko” znaczy wszystko, co ma ten Mac, a nie wszystko, co kiedykolwiek się wydarzyło.

Bezpłatnie i po odblokowaniu

Pierwsze 100 wydarzeń jest bezpłatne i takie zostaje. Odblokowanie Kalendarza eksportuje resztę (cennik).

Synchronizacja i pełna synchronizacja

Po pierwszym „sync now” Exporter zapisuje miesiąc na nowo, gdy coś się w nim zmieni, najwyżej raz na minutę. Przeniesienie wydarzenia zapisuje na nowo jego miesiąc i tylko ten.

„full resync” najpierw pyta, potem usuwa pliki miesięcy zapisane przez Exportera i zapisuje na nowo każdy zaznaczony kalendarz. Wszystko inne w folderze zostaje.

Problemy i rozwiązania

• „no calendar database in that folder (pick the Calendar folder itself)”: naciśnij „connect” ponownie i wybierz folder, w którym otwiera się okno
• brakuje kalendarza: jest odznaczony na karcie albo odznaczone jest całe jego konto. Wybór grupuje kalendarze według konta
• brakuje starych wydarzeń: wiersz „reads” stoi na krótszym zakresie albo sam Kalendarz już ich nie ma
• twoje przypomnienia są w eksporcie: Kalendarz pokazuje zaplanowane przypomnienia jako osobny kalendarz. Odznacz konto „Reminders” na karcie