Wallet

지갑 내보내기가 어떻게 작동하는지, 연결부터 문제 해결까지.

연결

Exporter 홈에서 지갑 옆의 “연결”을 누른 다음 “Passes 폴더 열기”를 누르세요. 패널은 macOS가 패스를 보관하는 폴더 ~/Library/Passes에서 열립니다. “이 폴더 선택”을 누르세요. 그다음 파일이 저장될 위치를 고르고 “이 폴더 사용”을 누르세요.

그 안의 Cards가 아니라 Passes 폴더 자체를 고르세요. 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 섹션은 장소 이름을 적습니다. 내용이 이진 데이터인 바코드는 제어 문자를 파일에 쓰는 대신 그렇다고 밝힙니다.

---
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장은 무료이고 계속 무료입니다. 지갑을 잠금 해제하면 나머지도 내보냅니다(가격).

동기화와 전체 재동기화

첫 “지금 동기화” 이후에는 해당 패스가 바뀔 때만 Exporter가 그 파일을 다시 씁니다. 최대 1분에 한 번입니다. 게이트와 좌석, 탑승 시각은 여행 당일에 바뀌며, 바뀔 때마다 다시 쓰이는 건 그 패스의 파일뿐입니다.

“전체 재동기화”는 먼저 확인한 뒤, Exporter가 쓴 패스 파일을 지우고 선택된 모든 패스를 다시 씁니다. 폴더의 다른 것은 그대로 남습니다.

문제와 해결

“그 폴더에 패스가 없습니다(라이브러리의 Passes 폴더를 선택하세요)”: “연결”을 다시 누르고 패널이 열린 폴더를 선택하세요
패스가 빠졌습니다: 카드에서 선택이 해제되었거나 무료 20장을 다 썼습니다. 지갑을 잠금 해제하고 “지금 동기화”를 누르세요
파일 이름에 날짜가 없습니다: 패스에 날짜가 없고 지갑의 데이터베이스도 읽지 못했습니다. Cards가 아니라 ~/Library/Passes 자체를 연결하세요
카드 번호가 없습니다: Mac에 아예 없습니다. 지갑은 결제 카드를 Secure Element에 보관하며 Exporter는 절대 보지 못합니다

연결