Нема описа

Eric Betts ae6793b74f Merge pull request #27 from abcMarcus/main		пре 8 месеци
.catalog	37fe6d4fec Added AU and HK flag	пре 8 месеци
.github	4ece979e10 PULL_REQUEST_TEMPLATE	пре 8 месеци
images	0939786adf Save epassport logos	пре 9 месеци
lib	7238894af2 Add com reading and asn1 parsing	пре 10 месеци
reference	37b252d2a2 reference material	пре 10 месеци
scenes	a193ddf9a2 uppercase all letters in passport number	пре 8 месеци
.clang-format	9fe02b0a3e Clear history	пре 10 месеци
.gitignore	9fe02b0a3e Clear history	пре 10 месеци
CODE_OF_CONDUCT.md	16e0bfa0f8 CODE_OF_CONDUCT	пре 8 месеци
CONTRIBUTING.md	2472d5f5f4 Create CONTRIBUTING.md	пре 8 месеци
LICENSE	b8c7803b36 Create LICENSE	пре 9 месеци
README.md	37fe6d4fec Added AU and HK flag	пре 8 месеци
SECURITY.md	8c3b9715df Create SECURITY.md	пре 8 месеци
application.fam	7581bc2191 more changelog items	пре 9 месеци
bsearch.c	88e7f838eb trying to use asn1c to decode DG1	пре 10 месеци
eMRTD.asn1	7238894af2 Add com reading and asn1 parsing	пре 10 месеци
memmem.c	89e36f2e4e Look for jpeg header in first 100 bytes of DG2	пре 10 месеци
passy.c	194c9778d1 For all other DG, grab the header and show that	пре 10 месеци
passy.h	9ea747ecc9 restructure UI	пре 10 месеци
passy.png	36d65b1f64 new icon	пре 9 месеци
passy_common.c	6c42d1b981 Fix for document numbers containing Q-Z	пре 9 месеци
passy_common.h	68c87dcbe2 Fix calculation of file length	пре 10 месеци
passy_i.h	80348d61d7 Restart NFC scanner is unhandled protocol is found	пре 9 месеци
passy_reader.c	81360b90d7 Correct fallback when dg2 image header can't be found	пре 9 месеци
passy_reader.h	8611f0508c Accept 4A protocol	пре 9 месеци
secure_messaging.c	7c05345f96 DRY up key diversification	пре 10 месеци
secure_messaging.h	633e3da57d handle dynamic passport number length	пре 10 месеци

Passy: Flipper Zero Passport Reader

Passy is a tool for reading electronic passports (ePassports/eMRTDs) using the Flipper Zero device. It extracts and decodes data securely stored in modern passports, designed for hobbyists, researchers, and security professionals.

Features

Reads and decodes ePassport data from a wide range of countries
Utilizes MRZ (Machine Readable Zone) information for secure access
Extensible for new country support—contribute your flag!
Advanced menu for debugging and exploring additional data groups (DGs)

Tested with the following countries

🇺🇸 🇨🇱 🇫🇷 🇬🇧 🇵🇭 🇷🇺 🇹🇼 🇺🇦 🇦🇿 🇨🇦 🇮🇹 🇪🇸 🇪🇪 🇨🇭 🇦🇺 🇭🇰

If it works for yours, submit a PR to add your country flag!

Usage

eMRTDs are secured to prevent unauthorized reading. The key for accessing the data is derived from:

Passport number
Date of birth
Date of expiry

Use the Flipper Zero to scan your passport’s NFC chip and enter the required information.

Limitations

Advanced menu is hidden unless Debug mode is enabled
Some data groups (DGs) are not fully parsed under "advanced" menu
Country coverage is limited (see above)

Development

Prerequisites

Flipper Zero device (updated firmware recommended)
ufbt for building
asn1c ASN.1 compiler (for protocol/data parsing)

Installation

Clone this repository:

git clone https://github.com/bettse/passy.git
cd passy

Build the ASN.1 code (optional, required for development):

asn1c -D ./lib/asn1 -no-gen-example -pdu=all eMRTD.asn1

Roadmap / To Do

Support PACE protocol
Add support for more countries' passports
Improve parsing of additional DGs

Contributing

Contributions are welcome! If Passy works with a new country, feel free to:

Add your country’s flag to the list above
Submit a pull request

License

MIT License

Acknowledgments

Inspired by the global ePassport community
Powered by Flipper Zero and open-source tooling

README.md