Wallet
Como funciona a exportação da Carteira, de conectar até resolver problemas.
Conectar
Aperte “Conectar” ao lado da Carteira na tela Início do Exporter e depois “Abrir Pasta Passes”. O painel abre na pasta onde o macOS guarda os seus passes, ~/Library/Passes: aperte “Selecionar esta pasta”. Depois escolha para onde vão os arquivos e aperte “Usar esta pasta”.
Pegue a pasta Passes em si, não a pasta Cards dentro dela. O Exporter lê os passes de Cards, e o passes23.sqlite ao lado para uma coisa só: o dia em que um passe foi assinado, a única data que muitos passes antigos têm.
Onde os arquivos ficam
Um arquivo Markdown por passe, numa única pasta, com o nome da data e do que o passe é: 2026-09-17 united airlines SFO-EWR.md, 2026-09-11 the sf database meetup.md. Um passe sem data nenhuma leva só o nome (apple store.md). Uma pasta direto na sua pasta de usuário, como ~/Documents, ganha uma pasta wallet-export dentro; uma mais funda, como ~/Documents/wallet, é usada como está.
O que é exportado
Todo passe marcado no cartão: cartões de embarque, passagens de trem e de ônibus, ingressos, cartões de loja, cupons e passes genéricos. As pílulas só filtram a lista: passes (todos), voos (incluindo trem e ônibus), eventos e cartões.
Dois passes que dariam o mesmo nome de arquivo ganham cada um um sufixo curto do seu id, então nenhum sobrescreve o outro. Desmarcar um passe remove o arquivo dele na próxima sincronização; marcar de novo traz de volta.
Formato
Sempre Markdown: o front matter do passe, um título e uma linha com o onde e o quando, depois os campos exatamente como o cartão os mostra, o verso sob um título Back e o número do código de barras.
O arquivo
| chave | contém |
|---|---|
title, id |
como o passe se chama, e o id que a Wallet dá a ele |
kind |
flight, transit, event, card ou other |
date, date_source |
quando o passe vale, e se essa é a data do emissor, o vencimento ou o dia da assinatura |
organization, pass_type |
o emissor e o identificador de tipo do passe |
expires, voided |
quando vence, e se a Wallet marcou o passe como usado |
coordinates |
o ponto do local, quando o passe leva um |
Uma seção Details leva os campos tipados da Apple que o cartão já não mostra: terminais, o portão de chegada, fusos horários, a classe tarifária. Uma seção Where nomeia o local. Um código de barras cuja mensagem é binária diz isso, em vez de escrever caracteres de controle no arquivo.
---
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
Datas, mesmo sem data
Um passe é arquivado no dia dele, no fuso que o emissor escreveu: um voo que sai de Denver às 23:25 é aquele dia em Denver, não o seguinte onde você está lendo. Ingressos antigos muitas vezes não têm data nenhuma; esses são arquivados no dia da assinatura, e date_source: signed diz isso no arquivo.
Passes em outros idiomas
Um passe pode guardar as palavras dele num arquivo pass.strings dentro do pacote e deixar só as chaves no passe. O Exporter resolve tudo no idioma do seu Mac, então um ingresso mostra o nome do evento e não EVENT_NAME.
Grátis e desbloqueado
Os seus 20 passes mais recentes são grátis, e continuam assim. Desbloquear a Carteira exporta o resto (preços).
Sincronização e ressincronização completa
Depois do primeiro “Sincronizar agora”, o Exporter reescreve o arquivo de um passe quando aquele passe muda, no máximo uma vez por minuto. Portões, assentos e horários de embarque mudam no dia da viagem, e cada mudança reescreve só o arquivo daquele passe.
“Ressincronização completa” pergunta antes, depois remove os arquivos de passes que o Exporter escreveu e escreve de novo cada passe marcado. Todo o resto na pasta fica.
Problemas e soluções
- “nenhum passe nessa pasta (escolha a pasta Passes na sua biblioteca)”: aperte “Conectar” de novo e selecione a pasta em que o painel abre
- falta um passe: ele está desmarcado no cartão, ou os 20 grátis acabaram. Desbloqueie a Carteira e aperte “Sincronizar agora”
- um passe está sem data no nome: ele não tem nenhuma e o banco de dados da Wallet não pôde ser lido. Conecte
~/Library/Passesem vez deCards - os números dos cartões não estão lá: eles não estão no Mac. A Wallet guarda os cartões de pagamento no Secure Element, e o Exporter nunca os vê