There are two ways to install, build and use Proxmark3 on Windows:
- Using Gator96100 ProxSpace, a package to assist in your Windows installation of MinGW
- Using native WSL, if you're running a Windows 10 version recent enough (FCU 1709 or later)
Install required drivers for your Windows installation. You may need admin privileges to do this.
Step by step guides are online such as RiscCorps.
Download the Gator96100 ProxSpace package from https://github.com/Gator96100/ProxSpace/releases
If you prefer, you can clone it, provided that you installed Github for Windows https://desktop.github.com/.
Extract 'ProxSpace' to a location path without spaces.
For example D:\OneDrive\Documents\GitHub is ok whereas C:\My Documents\My Projects\proxspace is not.
If you're running Windows in a Virtualbox guest, make sure not to install ProxSpace on a vbox shared drive. (It's ok later to move the /pm3 subfolder to a shared drive and edit the *.bat)
Run runme.bat or runme64.bat depending on your Windows architecture.
You'll get a Bash prompt and your home directory should become the ProxSpace pm3 sub-directory.
Please note you will need to use / in paths as you are using Bash.
cd
git clone https://github.com/RfidResearchGroup/proxmark3.git
cd proxmark3If you're a contributing developer, you probably want to be able to use make style. If so, you've to install astyle:
pacman -S mingw-w64-x86_64-astyleTo use the compiled client, the only differences are that executables end with .exe (e.g. proxmark3.exe) and that the Proxmark3 port is one of your comX ports where "X" is the com port number assigned to proxmark3 under Windows, so commands become:
proxmark3 /dev/ttyACM0 => proxmark3.exe comXNow you're ready to follow the compilation instructions.
It requires to run a Windows 10 version 1709 or above. Previous versions didn't have support for COM ports.
Install WSL with e.g. the standard Ubuntu.
For WSL configuration, see Manage and configure Windows Subsystem for Linux.
If you want to run the graphical components of the Proxmark3 client, you need to install a X Server such as VcXsrv or Xming and launch it, e.g. by executing XLaunch.
Enter WSL prompt (wsl) and from there, follow the Linux Installation Instructions for Ubuntu, summarized here below:
sudo apt-get update
sudo apt-get install --no-install-recommends git ca-certificates build-essential pkg-config \
libreadline-dev gcc-arm-none-eabi libnewlib-dev qtbase5-devIf you don't need the graphical components of the Proxmark3 client, you can skip the installation of qtbase5-dev.
git clone https://github.com/RfidResearchGroup/proxmark3.gitTo use the compiled client, the only difference is that the Proxmark3 port is translated from your comX port where "X" is the com port number assigned to proxmark3 under Windows, to a /dev/ttySX, so commands become:
proxmark3 /dev/ttyACM0 => proxmark3 /dev/ttySXDepending on the Windows version, you might need to give permission to the current user to access /dev/ttySX: (change X to your port number)
ls -al /dev/ttySX
groups|grep dialoutIf group ownership is dialout and your user is member of dialout group, all is fine. Else you'll have to provide access to /dev/ttySX: (Unfortunately the access rights of the port won't survive and will have to be fixed again next time.)
sudo chmod 666 /dev/ttySXIf you installed a X Server and compiled the Proxmark3 with QT4 support, you've to export the DISPLAY environment variable:
export DISPLAY=:0and add it to your Bash profile for the next times:
echo "export DISPLAY=:0" >> ~/.bashrcNote that it may take a quite long time for a freshly plugged Proxmark3 to be visible on a WSL /dev/ttySX port.
Now you're ready to follow the compilation instructions.