WillyJL
89a7636d4e
Merge passy from https://github.com/bettse/passy
|
před 7 měsíci | |
|---|---|---|
| .. | ||
| .catalog | před 7 měsíci | |
| .github | před 7 měsíci | |
| images | před 8 měsíci | |
| lib | před 9 měsíci | |
| reference | před 9 měsíci | |
| scenes | před 7 měsíci | |
| .clang-format | před 9 měsíci | |
| .gitignore | před 9 měsíci | |
| .gitsubtree | před 9 měsíci | |
| CODE_OF_CONDUCT.md | před 7 měsíci | |
| CONTRIBUTING.md | před 7 měsíci | |
| LICENSE | před 8 měsíci | |
| README.md | před 7 měsíci | |
| SECURITY.md | před 7 měsíci | |
| application.fam | před 8 měsíci | |
| bsearch.c | před 9 měsíci | |
| eMRTD.asn1 | před 9 měsíci | |
| memmem.c | před 9 měsíci | |
| passy.c | před 9 měsíci | |
| passy.h | před 9 měsíci | |
| passy.png | před 8 měsíci | |
| passy_common.c | před 9 měsíci | |
| passy_common.h | před 9 měsíci | |
| passy_i.h | před 9 měsíci | |
| passy_reader.c | před 8 měsíci | |
| passy_reader.h | před 9 měsíci | |
| secure_messaging.c | před 9 měsíci | |
| secure_messaging.h | před 9 měsíci | |
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