Contacts

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 :

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

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