Flipper Zero meets M5Stack Cardputer

A port of the Flipper Zero firmware to the M5Stack Cardputer and M5Stack Cardputer ADV. This project brings the Flipper Zero UI, services, and application framework to affordable ESP32-S3 hardware.

Discord

Join the Flipper Zero meets ESP32 - Discord for support, releases, and announcements.

Supported Hardware

Feature	M5Stack Cardputer (Standard)	M5Stack Cardputer ADV
MCU	ESP32-S3 (8 MB Flash, No PSRAM)	ESP32-S3 (8 MB Flash, No PSRAM)
Display	ST7789V2 240×135 RGB565	ST7789V2 240×135 RGB565
Keyboard	56-key matrix via 74HC138	56-key matrix via TCA8418 (I2C)
Sub-GHz (CC1101)	—	Yes (SPI3 shared with SD)
NRF24 (2.4 GHz)	—	Yes (CE=4, CSN=6)
Infrared (IR)	TX (GPIO 44)	TX (GPIO 44) + RX (GPIO 1)
Audio	NS4168 I2S Speaker Amp	ES8311 I2S Codec (I2C)
IMU (Motion)	—	BMI270 (I2C)
RGB LED	—	WS2812 (GPIO 21)
SD Card Slot	Yes (SPI3)	Yes (SPI3)

⚠️ M5Stack Cardputer is available, ONLY IN BETA_FIRMWARE

---

Frequent Question

Can i run flipper zero without SD card?

• Anwser: No, SD card is required to work properly
• Set up SD Card

Where to get the files?

• Answer:

There is Custom Qflipper?

• Answer: Yes, But its just UI tweak. You can use standard Qflipper. link: QPuter Thanks to Adam for make custom Qflipper.

---

Navigation Key Mapping

The physical keyboard is fully mapped to navigate the Flipper Zero UI:

Flipper Key	Cardputer Key
Up	↑ (Fn + ; keycap)
Down	↓ (Fn + . keycap)
Left	← (Fn + , keycap)
Right	→ (Fn + / keycap)
OK	Enter
Back	Backspace or Esc (``` keycap)

Full keyboard typing (printable ASCII characters) is supported in text fields.

---

Apps

📡 Wireless / RF

Sub-GHz

External CC1101 receiver/transmitter for 433–868 MHz signals.

• Receive & decode
• Read RAW: capture unknown waveforms to .sub files for later analysis
• Frequency analyzer with sweep & live RSSI
• Hopper: scan all preset bands during receive
• Transmit saved files; manual signal creation (frequency, modulation, protocol, key/serial/counter)
• Brute force / sub-brute attack with manufacturer dictionary
• Playlist for sequential transmit
• TPMS decoding — tire-pressure sensors: Schrader GG4, Citroën, Ford, Renault, Toyota (PMV107J) and a generic decoder; dedicated info view with editable sensor data
• Limitation: AES-encrypted manufacturer keystores (keeloq_mfcodes, nice_flor_s, alutech_at_4n) are not decryptable on this port — only the plain-text keeloq_mfcodes_user works for Keeloq decoding.

Sub-GHz Remote

Multi-button remote layouts that batch saved .sub files. Map Up/Down/Left/Right/OK to individual transmit signals; switch between persistent remote profiles.

WiFi

Full WiFi pentest toolkit.

• Scanner — SSID, BSSID, channel, RSSI, auth mode
• Connect — auto-detect WPA/WPA2/WPA3, password input or saved password lookup (/ext/wifi/<ssid>.txt)
• Deauther — SSID-mode (single AP) or Channel-mode (all on channel)
• Sniffer — capture packets to PCAP
• Handshake capture — record EAPOL 4-way handshakes, optionally with deauth trigger
• AirSnitch — auto-bruteforce target with password list
• Beacon Spam — Funny SSIDs / Rickroll / Random / Custom
• Network Scan / Port Scan — host discovery + 19 common-port probe on the connected network
• Web Crawler — domain-based web crawler
• Evil Portal — captive portal with credential harvesting
  • Built-in templates: Google login, Router firmware update
  • Custom templates from /ext/wifi/evil_portal/login_template/*.html and /ext/wifi/evil_portal/router_template/*.html (filename = template name in dropdown)
  • Marker substitution: %ERROR%, %SSID_OPTIONS% (live AP scan)
  • Router-style verify flow: dropdown of real SSIDs, live WLAN re-auth check, captured-credentials screen on success, retry with error banner on fail
  • Pause/Resume of the AP from the run screen
  • Captured creds saved to /ext/wifi/evil_portal/<ssid>_creds.csv
  • Internet bridge (new) — optional STA uplink with NAPT + DNS forwarding so victims get real internet behind the portal; iOS captive-portal "Success" handling; uplink SSID/password configured in-app

Mesh / Buddy (ESP-NOW)

Pair cheap headless ESP32 boards (buddies) to the T-Embed (master) over ESP-NOW to offload WiFi capture and run remote actions.

• Buddy discovery, pair/remove and live status from the lock menu → Mesh Clients
• Device Identify — make a paired buddy blink to locate it
• WiFi handshake capture — buddy passively captures EAPOL handshakes on a chosen channel (1–13)
• Store-and-forward — the buddy holds each complete handshake (M1–M4 + beacon) durably (RAM + NVS) per BSSID and delivers it as one acknowledged unit, surviving master absence and buddy reboots
• One .pcap per network written to /ext/wifi/buddy_<name>_<ssid>.pcap; "Handshake received" overlay on all mesh views
• Buddy firmware ships in this repo under buddy_firmware/ (standalone headless ESP-IDF project)

Bluetooth

• BLE Spam — Apple Continuity (Pair/Action/NotYourDevice), Google FastPair (455+ models), Microsoft SwiftPair, Samsung Buds & Watch, Xiaomi QuickConnect
• BLE Walk — passive scanner with GATT service/characteristic inspection
• BLE Clone (dev) — replicate active BLE advertisements
• FindMy — emulate Apple AirTag, Samsung SmartTag, Tile beacons (clone or generate keypairs)
• HID (see below) — keyboard/mouse/media remote over BLE
• Bad USB — via USB or BLE

NRF24 (2.4 GHz, external nRF24L01)

• Spectrum analyzer — live 2.4 GHz channel activity
• Jammer (rewritten) — one engine with switchable channel sources (Protocol / Manual / WiFi / Activity scan), strategies (CW / Flood / Turbo) and presets; configuration persists per source
• MouseJacker — inject keystrokes into vulnerable wireless mice/keyboards
• Also available as a FAP (nRF24_jammer)

Infrared

RMT-based TX + RX.

• Learn signals (auto-decoded or raw)
• Browse, edit, and send saved remotes
• Universal remotes: TV, AC, audio, projectors, fans, LED controllers (databases on SD)
• Brute force category-based databases
• Configurable IR pin and 5 V GPIO power
• Protocols: NEC, NEC42, Samsung32, RC5/RC5X, RC6, SIRC 12/15/20, Kaseikyo, RCA, Pioneer

🪪 NFC

NFC (PN532 over I2C)

• Read, save, emulate, write NFC cards/tags
• Manual card generation (custom UID/ATQA/SAK)
• Mifare Classic dictionary attack (system + user dictionaries)
• Mifare Ultralight-C dictionary unlock
• ISO15693 SLIX unlock with manual or stored DEF key
• FeliCa system info, MIFARE DESFire app inspection, EMV transaction history
• 14 supported protocols: ISO14443-3A/3B/4A/4B, ISO15693-3, FeliCa, MIFARE Classic/Ultralight/Plus/DESFire, SLIX, ST25TB, NTAG4xx, Type-4
• 30+ supported card auto-parsers (Charlie Card, Clipper, EMV, Gallagher, HID, Opal, Skylanders, Troika, …)

⌨️ HID / USB

Bad USB

HID payload runner for Ducky-script (.txt) files from /ext/badusb/.

• 16+ Ducky commands (DELAY, STRING, REPEAT, HOLD/RELEASE, MEDIA keys, mouse, ALT-CHAR/ALT-STRING, SYSRQ)
• Layouts under /ext/badusb/assets/layouts/*.kl (~30 included)
• Configurable USB VID/PID + device name
• BLE bonding with custom MAC and PIN-verify pairing
• Mouse movement, scroll, button emulation; per-character typing delay
• Transport: USB OTG (TinyUSB) on T-Embed, BLE on Waveshare

🛠 System / Tools

Lock Menu / System Toggles

The desktop lock menu doubles as the central system control panel (board-dependent, scrollable):

• qFlipper — enable the qFlipper desktop bridge (VID/PID spoof + CDC RPC) so the official qFlipper app can connect (USB-OTG boards)
• USB Storage — expose the SD card as a USB mass-storage device (USB-OTG boards)
• Bluetooth — toggle BLE on/off
• Mesh Clients — buddy discovery & control (see Mesh / Buddy above)
• BIG FAP Mode — Forces disable Bluetooth and Wifi to give enough Sram to run FAP

Archive

SD-card file browser with tabs per media type: Favorites, Sub-GHz, NFC, LF-RFID, Infrared, iButton, Bad USB, U2F, Apps, Internal, Browser. Pin/unpin favorites; copy, paste, rename, delete, create folder.

⚙ Settings & General

Bluetooth, backlight, clock, dolphin/passport, expansion port, input, notification, power, storage, system info, factory reset. Animated dolphin desktop on idle. File-pack manifest at /ext/Manifest (qFlipper-style asset list — its presence suppresses the "No DB" boot animation).

---

How to Flash

Method 1: Web Flasher (Easiest)

Connect your Cardputer over USB and use the online flasher in a Chrome/Edge browser:

(Coming soon)

👉 [Flash via Browser]

Method 2: Flash the Merged Binary Directly

After building, a single merged binary is automatically generated in the project root:

# Flash the merged binary (using esptool)
esptool.py --chip esp32s3 -b 460800 write_flash 0x0 Flipper-cardputer_adv-merged.bin

---

Setup SD Card

Most applications require database and asset files on an SD card.

1. Format a MicroSD card to FAT32.
2. Download the SD card files from the releases section or use the starter files: sdcard.zip
3. Extract the contents directly to the root of the MicroSD card OR sdcard folder in root and place inside of sdcard folder [Must put folder name sdcard] and insert it into your Cardputer.

Building from Source

Prerequisites

1. Install ESP-IDF v5.4.1.
2. Source the ESP-IDF export script:
   • Linux/macOS: source ~/esp/esp-idf/export.sh
   • Windows (Standard CMD): C:\Espressif\frameworks\esp-idf-v5.4.1\export.bat

Building on Windows (Recommended Wrapper)

We provide a custom script build_adv.bat in the root folder that configures your ESP-IDF python environments and triggers the build:

# Run the bat script directly
.\build_adv.bat

Or you can use winbuild.py manually:

# Build Cardputer ADV (Default)
python winbuild.py build --board cardputer_adv

# Build Standard Cardputer
python winbuild.py build --board cardputer

Building on Linux / macOS

# Build Cardputer ADV
./build.sh --board cardputer_adv --build-only

# Build Standard Cardputer
./build.sh --board cardputer --build-only

---

How to Install (Step-by-Step)

Step 1: Flash the Firmware

You can flash the pre-compiled merged binary directly to your Cardputer:

1. Connect your M5Stack Cardputer to your PC using a USB-C cable.
2. Download the latest Flipper-cardputer_adv-merged.bin (or build it yourself).
3. Use esptool.py to write the image directly to the flash offset 0x0:

   esptool.py --chip esp32s3 -b 460800 write_flash 0x0 Flipper-cardputer_adv-merged.bin

   (Alternatively, you can use the Espressif GUI Flash Download Tool or any web flasher).

Step 2: Prepare the MicroSD Card

The firmware requires specific asset files to run Flipper Zero apps:

1. Format a MicroSD card to FAT32.
2. Download the sdcard.zip starter pack.
3. Extract the ZIP contents directly to the root directory of your MicroSD card.
4. Insert the card into your Cardputer's SD slot.

Step 3: Boot Up

1. Toggle the power switch on the Cardputer to turn it on.
2. The Flipper home screen will load, showing your digital pet on the desktop!

---

Credits

• Sor3nt for the original Flipper Zero port for ESP32.
• 0xhalloween for adding the M5Stack Cardputer support.
• Flipper Devices Inc. for the original firmware and application framework.