Momentum-Apps/metroflip

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):

**OR**:
Beta (newer updates but not fully tested): 

git clone --single-branch --branch dev https://github.com/luu176/Metroflip.git```

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

   
   3. **Install Python**  
   Download and install Python from the [official website](https://www.python.org).  
   
   4. **Install UFBT**  
   Run the third command to install UFBT:  
   
   

   pip install ufbt```

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

   ufbt fap_metroflip```

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

4. 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
   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
   SmartRider	🇦🇺 Perth, WA, Australia	MIFARE Classic
   Suica	🇯🇵 Japan	FeliCa
   Troika	🇷🇺 Moscow, Russia	MIFARE Classic

   ---

   Credits

   • App Author: @luu176
   • Info Slaves: @equipter, TheDingo8MyBaby
   • Bip! Parser: @rbasoalto, @gornekich
   • Charliecard Parser: @zacharyweiss
   • Clipper Parser: @ke6jjj
   • 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
   • Suica Parser: @Zinong Li
   • Troika Parser: @gornekich

   ---

   Special Thanks

   Huge thanks to @equipter for helping out the community!