# Contacts

Le fonctionnement de l’export Contacts, de la connexion à la résolution des problèmes.

## Connexion

Appuyez sur « connecter » sur la carte Contacts. Le panneau s’ouvre dans votre dossier AddressBook, `~/Library/Application Support/AddressBook` : appuyez sur « Sélectionner ce dossier ». Exporter ne lit que ce dossier, sans demande d’autorisation, et y lit aussi vos fiches iCloud et Exchange. Appuyez ensuite sur « choisir le dossier ».

## Où vont les fichiers

Un fichier Markdown par fiche, `Anna Kowalski.md`. Deux personnes du même nom reçoivent chacune un court suffixe d’identifiant : aucun des deux fichiers n’écrase l’autre. Un dossier situé directement dans votre dossier personnel, comme `~/Documents`, reçoit un dossier `contacts-export` ; un dossier plus profond, comme `~/Documents/contacts`, est utilisé tel quel.

L’onglet sur lequel se trouve la carte détermine aussi la disposition des dossiers :

| onglet | les fichiers arrivent dans |
| --- | --- |
| Tous, Récents | la racine du dossier d’export |
| Groupes | `groups/<group>/` ; une fiche présente dans deux groupes n’est écrite qu’une fois, sous le premier |
| Sociétés | `companies/<company>/` |

Changer d’onglet déplace les fichiers à la synchronisation suivante, et la carte l’indique sous les onglets. Récents liste les 100 fiches modifiées le plus récemment ; les arborescences Groupes et Sociétés se terminent par « Sans groupe » et « Sans entreprise ».

## Ce qui est exporté

Les fiches cochées sur la carte, avec tous leurs champs. Exclues : les entrées réduites à une adresse e-mail que Gmail collecte pour chaque adresse à laquelle vous avez écrit. Il n’y a pas d’export vCard ou CSV : pour un `.vcf`, utilisez Fichier > Exporter > Exporter une vCard dans Contacts.

## Format

Toujours du Markdown.

## Le fichier

Chaque clé n’apparaît que si la fiche a une valeur. Les valeurs de liste portent leur libellé, comme `+1 415 555 0123 (mobile)`.

| clé | contient |
| --- | --- |
| `title` | le nom |
| `aliases` | le surnom et le nom de jeune fille |
| `id`, `source_url` | l’identifiant de la fiche, et un lien `addressbook://` qui l’ouvre dans Contacts |
| `created`, `modified` | la création de la fiche et sa dernière modification |
| `organization`, `job_title`, `department` | les lignes professionnelles |
| `birthday` | l’anniversaire |
| `email`, `phone` | le premier e-mail et le premier téléphone, en valeur simple, pour les modèles |
| `emails`, `phones`, `addresses`, `urls` | chacun, avec son libellé |
| `social`, `im` | profils sociaux et comptes de messagerie |
| `dates`, `relationships` | autres dates et noms associés, comme `father: Tom Kowalski` |
| `groups` | les groupes Contacts auxquels appartient la fiche |
| `conversations` | des liens vers les conversations de la fiche, quand Messages est aussi exporté |

Le corps contient le nom, la ligne du poste et la note de la fiche :

```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.
```

## Gratuit et débloqué

Vos 100 premières fiches parmi celles que vous avez cochées s’exportent et restent synchronisées gratuitement, et une fiche supprimée libère sa place ; les autres nécessitent le déblocage unique ([tarifs](https://exporter.dev/pricing)).

## Synchronisation et resynchronisation complète

Après le premier « synchroniser », une fiche modifiée réécrit son fichier tant qu’Exporter tourne, et le fichier d’une fiche supprimée disparaît à la synchronisation suivante.

« resynchronisation complète » demande d’abord confirmation, puis supprime uniquement les fichiers écrits par Exporter, réécrit toutes les fiches et choisit à nouveau les 100 fiches gratuites. Tout le reste du dossier d’export demeure.

## Problèmes et solutions

- « aucune base de contacts dans ce dossier (choisissez le dossier AddressBook lui-même) » : appuyez à nouveau sur « connecter » et sélectionnez le dossier dans lequel s’ouvre le panneau
- des fichiers ont changé de dossier : la carte est passée à un autre onglet. Revenez à l’onglet voulu et appuyez sur « synchroniser »
- une fiche manque : elle dépasse les 100 gratuites, elle est décochée, ou c’est une entrée Gmail réduite à une adresse e-mail
- une fiche en échec : `dernière synchro` affiche un lien rouge « détails » avec les fiches en échec et un lien « ouvrir » vers chacune

## 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/fr/docs/contacts
every page: https://exporter.dev/llms.txt