Metroflip

Metroflip is a multi-protocol metro card reader app for the Flipper Zero, inspired by the Metrodroid project. It enables the parsing and analysis of metro cards from transit systems around the world, providing a proof-of-concept for exploring transit card data in a portable format. Please join the server here if you have any questions for me.

Author

@luu176

---

Setup Instructions

Using a pre-built release: Stable (Recommended) or Beta (Newer updates, less stable)

1. Download the appropriate metroflip.fap file from the Releases section.
2. Drag and drop the metroflip.fap file into the apps folder on your Flipper Zero's SD card.

Manual Build Instructions

To build Metroflip manually, follow these steps:

1. Install Git
   Download and install Git on your Windows computer.
   Run the first command to download the app:

Either: Stable Release (recommended): git clone https://github.com/luu176/Metroflip.git

OR: Beta (newer updates but not fully tested): git clone --single-branch --branch dev https://github.com/luu176/Metroflip.git

2. Navigate to the Project Folder
   Run the second command to enter the app folder:

cd Metroflip

3. Install Python
   Download and install Python from the official website.

4. Install UFBT
   Run the third command to install UFBT:

pip install ufbt

5. Update and Build the Project
   Run the following commands in order to build the app:

ufbt update ufbt fap_metroflip

6. Connect Your Flipper Zero
   Ensure your Flipper Zero is connected via USB and close the QFlipper application (if it’s open).

7. Launch the Build
   Run the final command to launch the app on your flipper:

ufbt launch

---

Metroflip - Card Support TODO List

This is a list of metro cards and transit systems that need support or have partial support.

✅ Supported Cards

Card / Agency	Country / City	Card Type
Bip!	🇨🇱 Santiago de Chile, Chile	Mifare Classic
Charliecard	🇺🇸 Boston, MA, USA	Mifare Classic
Clipper	🇺🇸 San Francisco, CA, USA	Mifare DESFire
ITSO	🇬🇧 United Kingdom	Mifare DESFire
Metromoney	🇬🇪 Tbilisi, Georgia	Mifare Classic
myki	🇦🇺 Melbourne (and surrounds), VIC, Australia	Mifare DESFire
Navigo	🇫🇷 Paris, France	Calypso
Opal	🇦🇺 Sydney (and surrounds), NSW, Australia	Mifare DESFire
Rav-Kav	🇮🇱 Israel	Calypso
Troika	🇷🇺 Moscow, Russia	Mifare Classic

---

Credits

• App Author: @luu176
• Charliecard Parser: @zacharyweiss
• Rav-Kav Parser: @luu176
• Navigo Parser: @luu176, @DocSystem
• Metromoney Parser: @Leptopt1los
• Bip! Parser: @rbasoalto, @gornekich
• Clipper Parser: @ke6jjj
• Troika Parser: @gornekich
• Myki Parser: @gornekich
• Opal Parser: @gornekich
• ITSO Parser: @gsp8181, @hedger, @gornekich
• Info Slaves: @equipter, TheDingo8MyBaby

---

Special Thanks

Huge thanks to @equipter for helping out the community!