# Contacten

Hoe de export van Contacten werkt, van verbinden tot problemen oplossen.

## Verbinden

Druk op "verbinden" op de kaart Contacten. Het paneel opent in je map AddressBook, `~/Library/Application Support/AddressBook`: druk op "Kies deze map". Exporter leest alleen die map, zonder toestemmingsvraag, en leest daaruit ook je kaarten van iCloud en Exchange. Druk daarna op "exportmap kiezen".

## Waar de bestanden komen

Eén Markdown-bestand per kaart, `Anna Kowalski.md`. Twee personen met dezelfde naam krijgen elk een kort id-achtervoegsel, zodat het ene bestand het andere niet overschrijft. Een map direct in je thuismap, zoals `~/Documents`, krijgt daarin een map `contacts-export`; een diepere, zoals `~/Documents/contacts`, wordt gebruikt zoals hij is.

Het tabblad waarop de kaart staat, is ook de mapindeling:

| tabblad | bestanden komen in |
| --- | --- |
| Alle, Recent | bovenin de exportmap |
| Groepen | `groups/<group>/`; een kaart in twee groepen wordt één keer geschreven, onder de eerste |
| Bedrijven | `companies/<company>/` |

Van tabblad wisselen verplaatst de bestanden bij de volgende synchronisatie, en de kaart meldt dat onder de tabbladen. Recent toont de 100 kaarten die het laatst zijn gewijzigd; de lijsten Groepen en Bedrijven eindigen met "Zonder groep" en "Zonder bedrijf".

## Wat wordt geëxporteerd

De kaarten die op de kaart zijn aangevinkt, met elk veld dat ze hebben. Blijft weg: de items met alleen een e-mailadres die Gmail verzamelt voor elk adres waar je naar schreef. Er is geen export naar vCard of CSV: voor een `.vcf` gebruik je Archief > Exporteer > Exporteer vCard in Contacten.

## Formaat

Altijd Markdown.

## Het bestand

Elke sleutel verschijnt alleen als de kaart een waarde heeft. Waarden in lijsten dragen hun label, zoals `+1 415 555 0123 (mobile)`.

| sleutel | bevat |
| --- | --- |
| `title` | de naam |
| `aliases` | de bijnaam en de meisjesnaam |
| `id`, `source_url` | het id van de kaart, en een `addressbook://`-link die haar opent in Contacten |
| `created`, `modified` | wanneer de kaart is gemaakt en voor het laatst gewijzigd |
| `organization`, `job_title`, `department` | de werkregels |
| `birthday` | de verjaardag |
| `email`, `phone` | het eerste e-mailadres en telefoonnummer, zonder label, voor sjablonen |
| `emails`, `phones`, `addresses`, `urls` | allemaal, elk met zijn label |
| `social`, `im` | sociale profielen en berichtenaccounts |
| `dates`, `relationships` | andere datums en verwante namen, zoals `father: Tom Kowalski` |
| `groups` | de groepen in Contacten waar de kaart bij hoort |
| `conversations` | links naar de gesprekken van de kaart, als Berichten ook is geëxporteerd |

De hoofdtekst is de naam, de functieregel en de notitie van de kaart:

```markdown
---
title: "Anna Kowalski"
id: "410FE041:ABPerson"
created: 2019-04-02T10:15:33
modified: 2026-08-30T19:02:11
source_url: "addressbook://410FE041:ABPerson"
organization: "Northwind Studio"
job_title: "Art director"
birthday: 1990-12-10
email: "anna@northwind.example"
phone: "+1 415 555 0123"
phones:
  - "+1 415 555 0123 (mobile)"
groups:
  - "Studio"
---

# Anna Kowalski

Art director · Northwind Studio

Met at the print fair.
```

## Gratis en ontgrendeld

Je eerste 100 kaarten van de kaarten die je aanvinkte, exporteer en synchroniseer je gratis, en een verwijderde kaart geeft haar plek terug; de rest vraagt de eenmalige ontgrendeling ([prijzen](https://exporter.dev/pricing)).

## Synchroniseren en volledig opnieuw synchroniseren

Na de eerste "nu synchroniseren" herschrijft een gewijzigde kaart haar bestand zolang Exporter draait, en verdwijnt het bestand van een verwijderde kaart bij de volgende synchronisatie.

"volledig opnieuw synchroniseren" vraagt eerst om bevestiging, verwijdert dan alleen de bestanden die Exporter schreef, schrijft elke kaart opnieuw en kiest de gratis 100 opnieuw. Al het andere in de exportmap blijft staan.

## Problemen en oplossingen

- "geen contactendatabase in die map (kies de map AddressBook zelf)": druk opnieuw op "verbinden" en kies de map waarin het paneel opent
- bestanden zijn naar andere mappen verplaatst: de kaart is naar een ander tabblad gegaan. Ga terug naar het tabblad dat je wilt en druk op "nu synchroniseren"
- er ontbreekt een kaart: die valt buiten de gratis 100, is uitgevinkt, of is een item met alleen een e-mailadres uit Gmail
- een mislukte kaart: `laatste synchronisatie` toont een rode link "details" met de kaarten die mislukten en voor elk een link "openen"

## Related

- [Contacts](https://exporter.dev/contacts): Every contact card as a Markdown file
- [Contacts guides](https://exporter.dev/guides/contacts): People notes in Obsidian
- [Messages](https://exporter.dev/docs/messages): Conversations, media, fields and fixes

---

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