ProxLab

A Windows desktop app for scanning, decoding, and cloning RFID/NFC cards using a Proxmark3 device. Wraps the Proxmark3 Iceman CLI with a clean, guided UI aimed at users who don't want to memorise pm3 commands.

Features

• Scan — auto-detects HF cards (hf search), decodes and displays fields in plain English
• Library — save scanned cards with nicknames and notes, browse and search them
• Write — clone a saved card to a blank, or build a card from scratch (NTAG, EM4100, etc.)
• Setup wizard — guides first-time users through installing the pm3 client and Zadig USB driver
• Sector map — visual block grid showing which MIFARE sectors were read, partial, or locked

Requirements

• Windows x64
• Proxmark3 Iceman client (pm3.exe) — download the latest proxmark3-*-win64.zip
• Zadig for the WinUSB driver (one-time setup)
• A Proxmark3 device (Easy or RDV4)

Getting Started

npm install
npm run dev

On first launch the setup wizard will ask you to locate pm3.exe and confirm the USB driver.

Build

npm run dist

Produces a Windows NSIS installer in out/.

Tech Stack

App shell	Electron 30
UI	React 18 + TypeScript + Tailwind CSS
PM3 comms	child_process.spawn → pm3.exe CLI
Database	SQLite via better-sqlite3
State	Zustand
Build	electron-vite + electron-builder

Supported Card Types

• MIFARE Classic 1K / 4K
• MIFARE Ultralight
• NTAG213 / NTAG215 / NTAG216
• Generic HF fallback (UID + type)

Project Structure

proxlab/src/
├── main/           # Electron main process (pm3Bridge, cardStore, IPC)
├── preload/        # Context bridge
└── renderer/
    ├── pages/      # Setup, Scan, Library, CardDetail, Write
    ├── components/ # CardBadge, SectorMap, ScanAnimation, etc.
    └── lib/
        └── parsers/ # Per-card-type output parsers