# Wallet

Jak działa eksport z Portfela, od podłączenia po rozwiązywanie problemów.

## Podłączenie

Naciśnij „Połącz” obok Portfela na ekranie głównym Exportera, a potem „Otwórz folder Passes”. Panel otworzy się w folderze, w którym macOS trzyma Twoje karty, `~/Library/Passes`: naciśnij „Wybierz ten folder”. Potem wybierz, gdzie trafią pliki, i naciśnij „Użyj tego folderu”.

Weź sam folder Passes, a nie folder `Cards` w środku. Exporter czyta karty z `Cards`, a `passes23.sqlite` obok tylko dla jednej rzeczy: dnia, w którym kartę podpisano, jedynej daty, jaką ma wiele starszych kart.

## Gdzie trafiają pliki

Jeden plik Markdown na kartę, w jednym folderze, nazwany datą i tym, czym karta jest: `2026-09-17 united airlines SFO-EWR.md`, `2026-09-11 the sf database meetup.md`. Karta bez żadnej daty nosi samą nazwę (`apple store.md`). Folder prosto w katalogu domowym, jak `~/Documents`, dostaje w środku folder `wallet-export`; głębszy, jak `~/Documents/wallet`, jest używany taki, jaki jest.

## Co jest eksportowane

Każda karta zaznaczona na karcie źródła: karty pokładowe, bilety kolejowe i autobusowe, bilety na wydarzenia, karty sklepowe, kupony i karty ogólne. Pigułki tylko filtrują listę: karty (wszystkie), loty (łącznie z pociągami i autobusami), wydarzenia i karty sklepowe.

Dwie karty, które dałyby tę samą nazwę pliku, dostają krótki sufiks ze swojego id, więc żadna nie nadpisze drugiej. Odznaczenie karty usuwa jej plik przy następnej synchronizacji; ponowne zaznaczenie go przywraca.

## Format

Zawsze Markdown: front matter karty, nagłówek i jedna linia z tym, gdzie i kiedy, potem pola dokładnie tak, jak rysuje je karta, rewers pod nagłówkiem `Back` i numer kodu kreskowego.

## Plik

| klucz | zawiera |
| --- | --- |
| `title`, `id` | jak karta się nazywa i jakie id nadaje jej Portfel |
| `kind` | `flight`, `transit`, `event`, `card` albo `other` |
| `date`, `date_source` | kiedy karta obowiązuje i czy to data wystawcy, jej wygaśnięcie, czy dzień podpisania |
| `organization`, `pass_type` | wystawca i jego identyfikator typu karty |
| `expires`, `voided` | kiedy wygasa i czy Portfel oznaczył ją jako wykorzystaną |
| `coordinates` | punkt miejsca, jeśli karta go niesie |

Sekcja `Details` niesie typowane pola Apple, których karta i tak nie pokazuje: terminale, bramkę przylotu, strefy czasowe, klasę taryfową. Sekcja `Where` nazywa miejsce. Kod kreskowy, którego treść jest binarna, mówi to wprost, zamiast wpisywać do pliku znaki sterujące.

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

## Daty, nawet gdy ich nie ma

Karta trafia pod swój własny dzień, w strefie czasowej zapisanej przez wystawcę: lot wylatujący z Denver o 23:25 to ten dzień w Denver, a nie następny tam, gdzie go czytasz. Starsze bilety na wydarzenia często nie mają daty w ogóle; te trafiają pod dzień podpisania, a `date_source: signed` mówi o tym w pliku.

## Karty w innych językach

Karta może trzymać swoje słowa w pliku `pass.strings` wewnątrz paczki, a w samej karcie zostawić tylko klucze. Exporter rozwiązuje je w języku Twojego Maca, więc bilet pokazuje nazwę wydarzenia, a nie `EVENT_NAME`.

## Za darmo i po odblokowaniu

Twoje 20 najnowszych kart jest za darmo i takie zostaje. Odblokowanie Portfela eksportuje resztę ([cennik](https://exporter.dev/pricing)).

## Synchronizacja i pełna resynchronizacja

Po pierwszym „Synchronizuj teraz” Exporter zapisuje plik karty na nowo, gdy ta karta się zmieni, najwyżej raz na minutę. Bramki, miejsca i godziny wejścia zmieniają się w dniu podróży, a każda zmiana zapisuje na nowo tylko plik tej jednej karty.

„Pełna resynchronizacja” najpierw pyta, potem usuwa pliki kart zapisane przez Exportera i zapisuje na nowo każdą zaznaczoną kartę. Wszystko inne w folderze zostaje.

## Problemy i rozwiązania

- „brak kart w tym folderze (wskaż folder Passes w swojej bibliotece)”: naciśnij „podłącz” jeszcze raz i wybierz folder, w którym otwiera się panel
- brakuje karty: jest odznaczona na karcie źródła albo 20 darmowych zostało wykorzystanych. Odblokuj Portfel i naciśnij „Synchronizuj teraz”
- karta nie ma daty w nazwie: nie niesie żadnej, a bazy Portfela nie dało się odczytać. Podłącz `~/Library/Passes`, a nie `Cards`
- nie ma numerów kart płatniczych: ich nie ma na Macu. Portfel trzyma karty płatnicze w Secure Element, a Exporter nigdy ich nie widzi

## Related

- [Portfel](https://exporter.dev/pl/wallet): Każda karta jako plik Markdown
- [Pierwsze kroki](https://exporter.dev/pl/docs/getting-started): Instalacja, połączenie, pierwszy eksport
- [Serwer MCP](https://exporter.dev/pl/docs/mcp): Połącz Claude i innych agentów

---

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