Pobierz Exporter
Dokumentacja Portfel

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.

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

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

Exporter

Wersja 5.2 (App Store)

macOS 15 lub nowszy

exporter@tinysend.com

© system operator