Skip to content
Proxmark3 Amiibo simulator as shown at Recon Montreal 2018
C Stata C++ Lua Verilog Makefile Other
Branch: master
Clone or download

Latest commit

Latest commit 042e0f1 Aug 23, 2018


Type Name Latest commit message Commit time
Failed to load latest commit information.
armsrc Better signature handling Jun 23, 2018
bootrom Fixed all "misleading-indentation" warnings (fixes #187). Sep 26, 2016
client Better signature handling Jun 23, 2018
common fix bug in st detect + Apr 4, 2017
doc Adding STL files for 3D printed coil forms Jul 26, 2015
driver On another note; a nice udev-rule to have pm3 appear as /dev/pm3-1 (o… Jan 21, 2015
fpga - Correct little distraction on fpga/Makefile Nov 2, 2015
include Remove local armsrc/stdint.h and fix some other #includes Mar 6, 2017
liblua Better Linux compilation compability Sep 12, 2016
pcb corrected Eagle files Nov 13, 2015
recovery fpga_compress: interleave (combine) fpga_lf.bit and fpga_hf.bit befor… May 26, 2015
tools Merge pull request #250 from pwpiwi/fix_mfkey Mar 26, 2017
traces Revert "Revert "Traces"" Jan 27, 2015
zlib also delete *.bin and fpga_compressor when "make clean". May 26, 2015
.gitattributes git housekeeping: Jun 27, 2014
.gitignore Deduplicate mfkey32 and mfkey64 Mar 23, 2017 fix command help Apr 4, 2017
COMPILING.txt Adding homebrew tap method for macOS Mar 8, 2017
HACKING.txt Ooops, we forgot a few details Feb 21, 2010
LICENSE-amiitool.txt add amiitool license Jun 21, 2018
LICENSE.txt setting svn:eol-style=native on files, part 1 Feb 22, 2010
Makefile Update/cleanup Makefiles (#265) Mar 31, 2017 Update Aug 24, 2018

Amiibo simulator instructions

A copy of the amiitool Lua wrapper is included at client/, but if you want to build it yourself, follow these instructions:

  1. Get the lua-lib branch of amiitool at
  2. In CMakeLists.txt set PROXMARK_LIBLUA to the path to your proxmark3/liblua directory.
  3. In the amiitool directory run ./ and copy build/ to the proxmark3/client directory.

To build the main proxmark code, go to the proxmark3 directory and run make. Then flash the proxmark3 by:

  1. Unplugging the proxmark if it is plugged in
  2. Plug the proxmark in while holding down its button
  3. While continuing to hold the button, run make flash-all

Go to the client directory and run ./proxmark3 /dev/ttyACM0 (or other device path) and script run amiibo help to list available commands.

Commands that perform cryptographic operations, such as read, require a keyfile for amiitool at amiitool_keys.bin in the proxmark3/client directory.

Original README

NOTICE: (2014-03-26) This is now the official Proxmark repository!


The proxmark3 is a powerful general purpose RFID tool, the size of a deck of cards, designed to snoop, listen and emulate everything from Low Frequency (125kHz) to High Frequency (13.56MHz) tags.

This repository contains enough software, logic (for the FPGA), and design documentation for the hardware that you could, at least in theory, do something useful with a proxmark3.



The tools required to build or run the project will vary depending on your operating system. Please refer to the Wiki for details.


The Proxmark 3 is available for purchase (assembled and tested) from the following locations:

Most of the ultra-low-volume contract assemblers could put something like this together with a reasonable yield. A run of around a dozen units is probably cost-effective. The BOM includes (possibly- outdated) component pricing, and everything is available from Digikey and the usual distributors.

If you've never assembled a modern circuit board by hand, then this is not a good place to start. Some of the components (e.g. the crystals) must not be assembled with a soldering iron, and require hot air.

The schematics are included; the component values given are not necessarily correct for all situations, but it should be possible to do nearly anything you would want with appropriate population options.

The printed circuit board artwork is also available, as Gerbers and an Excellon drill file.


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

Jonathan Westhues user jwesthues, at host

May 2007, Cambridge MA

You can’t perform that action at this time.