README.md 3.1 KB

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 the Latest Release

  1. Download the .fap file from the Releases section.
  2. Drag and drop the .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:

git clone https://github.com/luu176/Metroflip.git

  1. Navigate to the Project Folder
    Run the second command:

cd Metroflip

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

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

pip install ufbt

  1. Update and Build the Project
    Run the following commands in order:

ufbt update ufbt fap_metroflip

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

  2. Launch the Build
    Run the final command:

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

  • Rav-Kav
  • Status: Partially Supported
  • Charliecard
  • Status: Fully supported.
  • Metromoney
  • Status: Fully supported.
  • Bip!
  • Status: Fully supported.
  • Navigo
  • Status: Fully supported.
  • Troika
  • Status: Fully supported.
  • Clipper
  • Status: Fully supported.
  • Myki
  • Status: Fully supported.
  • Opal
  • Status: Fully supported.
  • ITSO
  • Status: Fully supported

Credits


Special Thanks

Huge thanks to @equipter for helping out the community!