WillyJL
89a7636d4e
Merge passy from https://github.com/bettse/passy
|
vor 7 Monaten | |
|---|---|---|
| .. | ||
| .catalog | vor 7 Monaten | |
| .github | vor 7 Monaten | |
| images | vor 8 Monaten | |
| lib | vor 9 Monaten | |
| reference | vor 9 Monaten | |
| scenes | vor 7 Monaten | |
| .clang-format | vor 9 Monaten | |
| .gitignore | vor 9 Monaten | |
| .gitsubtree | vor 9 Monaten | |
| CODE_OF_CONDUCT.md | vor 7 Monaten | |
| CONTRIBUTING.md | vor 7 Monaten | |
| LICENSE | vor 8 Monaten | |
| README.md | vor 7 Monaten | |
| SECURITY.md | vor 7 Monaten | |
| application.fam | vor 8 Monaten | |
| bsearch.c | vor 9 Monaten | |
| eMRTD.asn1 | vor 9 Monaten | |
| memmem.c | vor 9 Monaten | |
| passy.c | vor 9 Monaten | |
| passy.h | vor 9 Monaten | |
| passy.png | vor 8 Monaten | |
| passy_common.c | vor 9 Monaten | |
| passy_common.h | vor 9 Monaten | |
| passy_i.h | vor 9 Monaten | |
| passy_reader.c | vor 8 Monaten | |
| passy_reader.h | vor 9 Monaten | |
| secure_messaging.c | vor 9 Monaten | |
| secure_messaging.h | vor 9 Monaten | |
README.md
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
Acknowledgments
- Inspired by the global ePassport community
- Powered by Flipper Zero and open-source tooling