proxmark3

Proxmark3 (Iceman Fork) is a firmware and software suite for the Proxmark3, a hardware device used to read, analyze, clone, and interact with RFID cards and tags. RFID is the technology behind contactless key cards, transit passes, and many access control badges. The Proxmark3 hardware connects to a computer via USB and can communicate with these cards at close range.

The Iceman fork is the most widely used community version of the Proxmark3 software. It extends the original firmware with a large command set accessible through a command-line client, plus Lua scripting support for automating tasks such as chip identification and security testing. Supported protocols include MIFARE, HID iClass, Hitag2, and the broader ISO14443 contactless standard, covering a wide range of card types in active use.

The repository includes detailed documentation organized into separate files, covering installation on Linux, macOS, Windows, Android via Termux, and iOS. Each platform has its own build guide. There is also a cheat sheet of common commands, a guide to standalone mode where the device runs scripts without a connected computer, and technical notes on specific protocols and file formats.

Hardware support focuses on the RDV4 model but also covers many earlier and third-party Proxmark3 variants. Some devices are listed as unsupported due to unknown hardware configurations, and a few are flagged as experimental with known compatibility issues. The code is written in C and covers both the ARM firmware that runs on the device and the desktop client used to control it.

The project was originally created by Jonathan Westhues. The Iceman fork is maintained by the RFID Research Group and accepts community contributions.