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.

Author

@luu176

Discord Community Server

Please join the server https://discord.gg/NR5hhbAXqS if you have any questions for me.

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 | City / Country | Card Type | |--------------------|----------------------------------------------|-------------------| | Bip! | 🇨🇱 Santiago de Chile, Chile | MIFARE Classic | | Charliecard | 🇺🇸 Boston, MA, USA | MIFARE Classic | | Clipper | 🇺🇸 San Francisco, CA, USA | MIFARE DESFire | | Intertic | 🇫🇷 France, About 21 Cities / Companies | ST25TB | | 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 | | Opus | 🇨🇦 Montreal, QC, Canada | Calypso | | Rav-Kav | 🇮🇱 Israel | Calypso | | RENFE | 🇪🇸 Spain | MIFARE Classic | | SmartRider | 🇦🇺 Perth, WA, Australia | MIFARE Classic | | Suica | 🇯🇵 Japan | FeliCa | | Troika | 🇷🇺 Moscow, Russia | MIFARE Classic | | Trt | 🇨🇳 Tianjin, China | MIFARE Ultralight | | Octopus | 🇭🇰 Hong Kong | FeliCa | | nol | 🇦🇪 Dubai, UAE | MIFARE DESFire |

---

Credits

• App Author: @luu176
• Info Slaves: @equipter, @TheDingo8MyBaby, @ry4000, @WillyJL,
• Bip! Parser: @rbasoalto, @gornekich
• Charliecard Parser: @zacharyweiss
• Clipper Parser: @ke6jjj
• Intertic Parser (21 Cities): @luu176, @gentilkiwi
• ITSO Parser: @gsp8181, @hedger, @gornekich
• Metromoney Parser: @Leptopt1los
• myki Parser: @gornekich
• Navigo Parser: @luu176, @DocSystem
• Opal Parser: @gornekich
• Opus Parser: @DocSystem
• Rav-Kav Parser: @luu176
• RENFE Parser: @BocamoCM
• Suica Parser: @zinongli
• Troika Parser: @gornekich
• TRT Parser: @luu176, @zinongli
• Octopus Parser: @zinongli
• nol Parser: @zinongli

---

Special Thanks

Huge thanks to @equipter & @ry4000 for helping out the Discord community!