README.md 2.2 KB
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