# Kontakty

Jak działa eksport Kontaktów, od połączenia po naprawianie problemów.

## Połączenie

Naciśnij „połącz” na karcie Kontaktów. Panel otworzy się w folderze AddressBook, `~/Library/Application Support/AddressBook`: naciśnij „Wybierz ten folder”. Exporter czyta tylko ten folder, bez pytania o uprawnienia, i czyta z niego także twoje wizytówki z iCloud i Exchange. Potem naciśnij „wybierz folder eksportu”.

## Gdzie trafiają pliki

Jeden plik Markdown na wizytówkę, `Anna Kowalski.md`. Dwie osoby o tym samym imieniu i nazwisku dostają krótki przyrostek z id, więc żaden plik nie nadpisuje drugiego. Folder leżący bezpośrednio w twoim folderze domowym, na przykład `~/Documents`, dostaje w środku folder `contacts-export`; głębszy, na przykład `~/Documents/contacts`, jest używany bez zmian.

Zakładka, na której jest karta, wyznacza też układ folderów:

| zakładka | pliki trafiają do |
| --- | --- |
| Wsz., Ostatnie | głównego poziomu folderu eksportu |
| Grupy | `groups/<group>/`; wizytówka w dwóch grupach jest zapisywana raz, w pierwszej |
| Firmy | `companies/<company>/` |

Zmiana zakładki przenosi pliki przy następnej synchronizacji, a karta informuje o tym pod zakładkami. Ostatnie pokazuje 100 ostatnio zmienionych wizytówek; drzewa Grupy i Firmy kończą się pozycjami „Bez grupy” i „Bez firmy”.

## Co jest eksportowane

Wizytówki zaznaczone na karcie, z każdym polem, jakie mają. Pomijane: wpisy zawierające tylko adres e-mail, które Gmail zbiera dla każdego adresu, do którego pisałeś. Nie ma eksportu vCard ani CSV: plik `.vcf` zrobisz w Kontaktach przez Plik > Eksportuj > Eksportuj vCard.

## Format

Zawsze Markdown.

## Plik

Każdy klucz pojawia się tylko wtedy, gdy wizytówka ma wartość. Wartości na listach mają swoją etykietę, na przykład `+1 415 555 0123 (mobile)`.

| klucz | zawiera |
| --- | --- |
| `title` | imię i nazwisko |
| `aliases` | pseudonim i nazwisko panieńskie |
| `id`, `source_url` | id wizytówki i link `addressbook://`, który otwiera ją w Kontaktach |
| `created`, `modified` | kiedy wizytówka powstała i kiedy ostatnio się zmieniła |
| `organization`, `job_title`, `department` | dane zawodowe |
| `birthday` | urodziny |
| `email`, `phone` | pierwszy e-mail i telefon, bez etykiety, do szablonów |
| `emails`, `phones`, `addresses`, `urls` | wszystkie, z etykietami |
| `social`, `im` | profile społecznościowe i konta komunikatorów |
| `dates`, `relationships` | inne daty i powiązane osoby, na przykład `father: Tom Kowalski` |
| `groups` | grupy w Kontaktach, do których należy wizytówka |
| `conversations` | linki do rozmów z tą osobą, jeśli eksportujesz też Wiadomości |

W treści jest imię i nazwisko, stanowisko i notatka z wizytówki:

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


## Darmowe i odblokowane

Pierwsze 100 wizytówek spośród zaznaczonych eksportujesz i synchronizujesz za darmo, a usunięta wizytówka zwalnia swoje miejsce; reszta wymaga jednorazowego odblokowania ([cennik](https://exporter.dev/pricing)).

## Synchronizacja i pełna resynchronizacja

Po pierwszym „synchronizuj teraz” edycja wizytówki nadpisuje jej plik, dopóki Exporter działa, a plik usuniętej wizytówki znika przy następnej synchronizacji.

„pełna resynchronizacja” najpierw pyta, potem usuwa tylko pliki zapisane przez Exporter, ponownie zapisuje każdą wizytówkę i od nowa wybiera darmową setkę. Wszystko inne w folderze eksportu zostaje.

## Problemy i poprawki

- „brak bazy danych kontaktów w tym folderze (wybierz sam folder AddressBook)”: naciśnij ponownie „połącz” i wybierz folder, w którym otworzy się panel
- pliki przeniosły się do innych folderów: karta przeszła na inną zakładkę. Wróć na zakładkę, którą chcesz, i naciśnij „synchronizuj teraz”
- brakuje wizytówki: jest poza darmową setką, jest odznaczona albo to wpis z samym adresem e-mail z Gmaila
- wizytówka z błędem: `ostatnia synchronizacja` pokazuje czerwony link „szczegóły” z wizytówkami, których eksport się nie udał, i linkiem „otwórz” do każdej z nich

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