# Wallet

Як працює експорт із Гаманця, від під’єднання до розв’язання проблем.

## Під’єднання

Натисніть «Підключити» поруч із Гаманцем на головному екрані Exporter, потім «Відкрити папку Passes». Панель відкриється в папці, де macOS тримає ваші картки, `~/Library/Passes`: натисніть «Вибрати цю папку». Далі виберіть, куди підуть файли, і натисніть «Використати цю теку».

Беріть саму папку Passes, а не папку `Cards` усередині. Exporter читає картки з `Cards`, а `passes23.sqlite` поруч лише заради одного: дня, коли картку було підписано, єдиної дати, яку має багато старіших карток.

## Куди йдуть файли

Один файл Markdown на картку, в одній папці, названий її датою і тим, чим картка є: `2026-09-17 united airlines SFO-EWR.md`, `2026-09-11 the sf database meetup.md`. Картка зовсім без дати має лише свою назву (`apple store.md`). Папка просто в домашній теці, як-от `~/Documents`, отримує всередині папку `wallet-export`; глибша, як-от `~/Documents/wallet`, використовується як є.

## Що експортується

Кожна картка, позначена на картці джерела: посадкові талони, квитки на потяг і автобус, квитки на події, картки магазинів, купони й загальні картки. Пігулки лише фільтрують список: картки (усі), польоти (разом із потягами й автобусами), події та картки магазинів.

Дві картки, які дали б однакову назву файлу, отримують короткий суфікс зі свого id, тож жодна не перезапише іншу. Знята позначка прибирає файл картки за наступної синхронізації; позначте знову, і він повернеться.

## Формат

Завжди Markdown: front matter картки, заголовок і один рядок про те, де і коли, далі поля точно так, як їх малює картка, зворот під заголовком `Back` і номер штрихкоду.

## Файл

| ключ | містить |
| --- | --- |
| `title`, `id` | як називається картка і який id дає їй Гаманець |
| `kind` | `flight`, `transit`, `event`, `card` або `other` |
| `date`, `date_source` | коли картка діє і чи це дата видавця, її завершення, чи день підписання |
| `organization`, `pass_type` | видавець і його ідентифікатор типу картки |
| `expires`, `voided` | коли вона спливає і чи позначив Гаманець її як використану |
| `coordinates` | точка місця, якщо картка її несе |

Розділ `Details` несе типізовані поля Apple, яких картка й так не показує: термінали, вихід прибуття, часові пояси, тарифний клас. Розділ `Where` називає місце. Штрихкод, повідомлення якого двійкове, каже про це замість писати у файл керівні символи.

```markdown
---
title: "United Airlines SFO-EWR"
kind: flight
date: 2026-09-17T18:20:00
date_source: relevant
organization: "United Airlines"
---
# United Airlines SFO-EWR

San Francisco (SFO) → Newark (EWR) · 17 Sep 2026

- FLIGHT: UA 274
- GATE: F19
- SEAT: 34D

## Back

- CONFIRMATION: GGCLMQ
```

## Дати, навіть коли їх немає

Картка лягає під свій власний день, у часовому поясі, який написав видавець: рейс, що вилітає з Денвера о 23:25, це той день у Денвері, а не наступний там, де ви його читаєте. Старіші квитки на події часто не мають дати взагалі; вони лягають під день підписання, і `date_source: signed` каже про це у файлі.

## Картки іншими мовами

Картка може тримати свої слова у файлі `pass.strings` усередині пакета, а в самій картці лишити тільки ключі. Exporter розвʼязує їх мовою вашого Mac, тож квиток показує назву події, а не `EVENT_NAME`.

## Безкоштовно й після розблокування

Ваші 20 найновіших карток безкоштовні й такими лишаються. Розблокування Гаманця експортує решту ([ціни](https://exporter.dev/pricing)).

## Синхронізація та повторна синхронізація

Після першого «Синхронізувати зараз» Exporter переписує файл картки, коли ця картка змінюється, щонайбільше раз на хвилину. Виходи, місця й час посадки змінюються в день подорожі, і кожна зміна переписує лише файл тієї картки.

«Повна повторна синхронізація» спершу запитує, потім прибирає файли карток, які записав Exporter, і записує знову кожну позначену картку. Усе інше в папці лишається.

## Проблеми й рішення

- «у цій папці немає карток (виберіть папку Passes у своїй бібліотеці)»: натисніть «під’єднати» ще раз і виберіть папку, в якій відкривається панель
- бракує картки: вона не позначена на картці джерела, або 20 безкоштовних вичерпано. Розблокуйте Гаманець і натисніть «Синхронізувати зараз»
- у назві картки немає дати: вона її не несе, а базу Гаманця не вдалося прочитати. Під’єднайте саме `~/Library/Passes`, а не `Cards`
- немає номерів банківських карток: їх немає на Mac. Гаманець тримає платіжні картки в Secure Element, і Exporter їх ніколи не бачить

## Related

- [Гаманець](https://exporter.dev/uk/wallet): Кожна картка як файл Markdown
- [Початок роботи](https://exporter.dev/uk/docs/getting-started): Встановлення, під’єднання, перший експорт
- [Сервер MCP](https://exporter.dev/uk/docs/mcp): Під’єднайте Claude та інших агентів

---

human version: https://exporter.dev/uk/docs/wallet
every page: https://exporter.dev/llms.txt