Contatos

Conectar

Clique em “conectar” no cartão Contatos. O painel abre na sua pasta AddressBook, ~/Library/Application Support/AddressBook: clique em “Selecionar esta pasta”. O Exporter lê só essa pasta, sem pedido de permissão, e lê dela também os seus cartões do iCloud e do Exchange. Depois clique em “escolher pasta de destino”.

Onde ficam os arquivos

Um arquivo Markdown por cartão, Anna Kowalski.md. Duas pessoas com o mesmo nome recebem cada uma um sufixo curto de id, para que nenhum arquivo sobrescreva o outro. Uma pasta logo dentro da sua pasta pessoal, como ~/Documents, ganha uma pasta contacts-export dentro dela; uma mais funda, como ~/Documents/contacts, é usada como está.

A aba em que o cartão está também define a organização das pastas:

aba	os arquivos ficam em
Todos, Recentes	o nível de cima da pasta de exportação
Grupos	groups/<group>/; um cartão em dois grupos é gravado uma vez, no primeiro
Empresas	companies/<company>/

Trocar de aba move os arquivos na próxima sincronização, e o cartão avisa isso abaixo das abas. “Recentes” lista os 100 cartões alterados mais recentemente; as árvores de “Grupos” e “Empresas” terminam com “Sem grupo” e “Sem empresa”.

O que é exportado

Os cartões marcados no cartão Contatos, com todos os campos que eles têm. Ficam de fora os registros só de e-mail que o Gmail coleta para cada endereço para o qual você escreveu. Não há exportação em vCard ou CSV: para um .vcf, use Arquivo > Exportar > Exportar vCard no Contatos.

Formato

Sempre Markdown.

O arquivo

Cada chave só aparece quando o cartão tem um valor. Os valores em lista trazem o seu rótulo, como +1 415 555 0123 (mobile).

chave	contém
title	o nome
aliases	o apelido e o nome de solteira
id, source_url	o id do cartão e um link addressbook:// que o abre no Contatos
created, modified	quando o cartão foi criado e alterado pela última vez
organization, job_title, department	as linhas de trabalho
birthday	o aniversário
email, phone	o primeiro e-mail e o primeiro telefone, simples, para modelos
emails, phones, addresses, urls	todos, cada um com o seu rótulo
social, im	perfis sociais e contas de mensagens
dates, relationships	outras datas e nomes relacionados, como father: Tom Kowalski
groups	os grupos do Contatos a que o cartão pertence
conversations	links para as conversas do cartão, quando o Mensagens também é exportado

O corpo traz o nome, a linha do cargo e a nota do cartão:

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

Grátis e desbloqueado

Seus primeiros 100 cartões entre os que você marcou são exportados e continuam sincronizando grátis, e um cartão apagado devolve a sua vaga; o resto precisa do desbloqueio único (preços).

Sincronização e ressincronização completa

Depois do primeiro “sincronizar agora”, um cartão editado regrava o seu arquivo enquanto o Exporter está aberto, e o arquivo de um cartão apagado sai na próxima sincronização.

“ressincronização completa” pergunta antes e depois remove apenas os arquivos que o Exporter gravou, grava todos os cartões de novo e escolhe outra vez os 100 grátis. Todo o resto na pasta de exportação fica.

Problemas e soluções

• “nenhum banco de contatos nessa pasta (escolha a própria pasta AddressBook)”: clique em “conectar” de novo e selecione a pasta em que o painel abre
• os arquivos foram para outras pastas: o cartão mudou de aba. Volte para a aba que você quer e clique em “sincronizar agora”
• falta um cartão: ele passou dos 100 grátis, está desmarcado ou é um registro só de e-mail do Gmail
• um cartão falhou: “última sincronização” mostra um link vermelho “detalhes” com os cartões que falharam e um link “abrir” para cada um