# Wallet

ウォレットの書き出しの仕組み。接続から問題の対処まで。

## 接続する

Exporter のホームでウォレットの横にある「接続」を押し、続いて「Passes フォルダを開く」を押します。パネルは macOS がパスを置くフォルダ `~/Library/Passes` で開きます。「このフォルダを選択」を押してください。続けてファイルの保存先を選び、「このフォルダを使う」を押します。

選ぶのは Passes フォルダ自体で、その中の `Cards` ではありません。Exporter はパスを `Cards` から読み、隣の `passes23.sqlite` はただ 1 つのために読みます。パスが署名された日、つまり古いパスの多くが持つ唯一の日付です。

## ファイルの置き場所

パス 1 枚につき Markdown ファイル 1 つ。1 つのフォルダに入り、日付と中身で名前が付きます。`2026-09-17 united airlines SFO-EWR.md`、`2026-09-11 the sf database meetup.md` のように。日付がまったくないパスは、その名前だけになります（`apple store.md`）。ホームフォルダ直下のフォルダ（たとえば `~/Documents`）には中に `wallet-export` フォルダができ、もっと深いフォルダ（たとえば `~/Documents/wallet`）はそのまま使われます。

## 書き出されるもの

カードでチェックしたすべてのパス。搭乗券、鉄道とバスのチケット、イベントのチケット、ショップカード、クーポン、汎用パス。ピルは一覧を絞るだけです。パス（すべて）、フライト（鉄道とバスも含む）、イベント、カード。

同じファイル名になる 2 枚のパスには、それぞれ ID から取った短い接尾辞が付くので、一方が他方を上書きすることはありません。チェックを外すと次の同期でそのファイルが消え、もう一度チェックすると戻ります。

## 形式

常に Markdown。パスの front matter、見出し、どこでいつかを示す 1 行、続いてカードに表示されるとおりの項目、カード裏面が `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 がファイルを書き直します。頻度は最大でも 1 分に 1 回です。ゲート、座席、搭乗時刻は移動当日に変わりますが、変更のたびに書き直されるのはそのパスのファイルだけです。

「完全再同期」はまず確認し、そのうえで Exporter が書いたパスのファイルを削除して、チェックされたすべてのパスを書き直します。フォルダ内のそれ以外はそのまま残ります。

## 問題と対処法

- 「そのフォルダにパスがありません（ライブラリの Passes フォルダを選んでください）」：もう一度「接続」を押し、パネルが開いたフォルダを選びます
- パスが足りない：カードでチェックが外れているか、無料の 20 枚を使い切っています。ウォレットのロックを解除して「今すぐ同期」を押してください
- ファイル名に日付がない：パスが日付を持たず、ウォレットのデータベースも読めませんでした。`Cards` ではなく `~/Library/Passes` 自体を接続してください
- カード番号がない：Mac には存在しません。ウォレットは決済用カードを Secure Element に置いており、Exporter が見ることはありません

## Related

- [ウォレット](https://exporter.dev/ja/wallet): パス 1 枚が Markdown ファイル 1 つ
- [はじめに](https://exporter.dev/ja/docs/getting-started): インストール、接続、最初の書き出し
- [MCP サーバー](https://exporter.dev/ja/docs/mcp): Claude やほかのエージェントを接続

---

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