# Agenda

Hoe de Agenda-export werkt, van verbinden tot het oplossen van problemen.

## Verbinden

Druk op «Verbinden» naast Agenda op het startscherm van Exporter, en daarna op «Map van Agenda openen». Het venster opent in de map van Agenda, `~/Library/Group Containers/group.com.apple.calendar`: druk op «Kies deze map». Kies daarna waar de bestanden komen en druk op «Gebruik deze map».

macOS vraagt niet om agendatoegang, en Exporter vraagt er nooit om: de afspraken worden gelezen uit de database in de vrijgegeven map, niet via EventKit. Het toestemmingsvenster dat je van andere apps kent hoort bij die andere weg.

## Waar de bestanden komen

Eén Markdown-bestand per maand, in één map: `2026-09.md`, `2026-10.md`. Een map direct in je thuismap, zoals `~/Documents`, krijgt er een map `calendar-export` in; een diepere, zoals `~/Documents/agenda`, wordt gebruikt zoals die is. Een maand zonder afspraken krijgt geen bestand.

## Wat wordt geëxporteerd

Elke afspraak in de op de kaart aangevinkte agenda's, binnen de ingestelde periode. De kiezer groepeert agenda's onder hun accounts, zoals de navigatiekolom van Agenda, zodat één vinkje een account kan weglaten.

Een afspraak hoort bij de maand waarin die begint, precies één keer, ook als die doorloopt tot na het einde van de maand.

## Herhalingen

Een terugkerende afspraak staat op elke dag dat die plaatsvindt, niet alleen op de dag dat die is gemaakt. Exporter leest de herhalingen die Agenda voor zijn eigen weergaven bijhoudt, dus het bestand klopt met de app, en een regel zegt hoe de afspraak zich herhaalt.

## Opmaak

Altijd Markdown: de frontmatter van de maand, daarna een kop per dag en één regel per afspraak.

Een dag begint met de afspraken van een hele dag en gaat daarna op begintijd, de volgorde waarin Agenda hem tekent. Een afspraak van een hele dag schrijft «all day»; die krijgt nooit een 00:00 die er niet was.

## Het bestand

| sleutel | bevat |
| --- | --- |
| `title`, `month` | “Agenda, september 2026” en `2026-09` |
| `events` | hoeveel afspraken het bestand bevat |
| `calendars` | de agenda's van de maand, de volste eerst |

Een regel is de tijd, de afspraak, de agenda waar die uit komt en waar die is, en dan de velden die een vault kan bevragen:

| veld | bevat |
| --- | --- |
| `repeats::` | `daily`, `weekly`, `every 2 weeks` |
| `join::` | de link van het videogesprek, als de afspraak er een heeft |
| `with::` | hoeveel mensen erbij horen |

```markdown
## 2026-09-17, donderdag

- all day Verjaardag van Marilyn · Verjaardagen
- 09:30-10:00 Standup · Werk · Zoom [repeats:: weekly] [with:: 6]
- 13:00-14:00 Lunch met Kevin · Privé · Philz Coffee
```

## Hoe ver terug het leest

De regel «reads» op de kaart: dit jaar, 2 jaar, 5 jaar of alles. Die verandert welke bestanden worden geschreven, dus een kortere periode is een kleinere export.

Agenda bewaart ongeveer twee jaar aan herhalingen voor zijn eigen weergaven, en meer is er niet te lezen: op een echte Mac geven 2 jaar, 5 jaar en alles dezelfde afspraken. «alles» betekent alles wat deze Mac heeft, niet alles wat er ooit is gebeurd.

## Gratis en vrijgespeeld

Je eerste 100 afspraken zijn gratis, en dat blijven ze. Agenda vrijspelen exporteert de rest ([prijzen](https://exporter.dev/pricing)).

## Synchroniseren en volledig opnieuw

Na de eerste «sync now» herschrijft Exporter een maand wanneer daarin iets verandert, hoogstens één keer per minuut. Een afspraak verplaatsen herschrijft die maand, en alleen die.

«full resync» vraagt eerst, verwijdert dan de maandbestanden die Exporter schreef en schrijft elke aangevinkte agenda opnieuw. Al het andere in de map blijft.

## Problemen en oplossingen

- «no calendar database in that folder (pick the Calendar folder itself)»: druk opnieuw op «connect» en selecteer de map waarin het venster opent
- een agenda ontbreekt: die is uitgevinkt op de kaart, of het hele account is dat. De kiezer groepeert agenda's per account
- oude afspraken ontbreken: de regel «reads» staat op een kortere periode, of Agenda zelf heeft ze niet meer
- je herinneringen staan in de export: Agenda toont geplande herinneringen als een eigen agenda. Vink het account «Reminders» uit op de kaart

## Related

- [Agenda](https://exporter.dev/nl/calendar): Elke maand als Markdown-bestand
- [Herinneringen](https://exporter.dev/nl/docs/reminders): Lijstbestanden, velden en oplossingen
- [MCP-server](https://exporter.dev/nl/docs/mcp): Verbind Claude en andere agents

---

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