/homebrew-proxmark3

Homebrew tap containing proxmark3 software/firmware

Primary LanguageRubyMIT LicenseMIT

Homebrew tap for RRG/Iceman Proxmark3 repo

Homebrew - is a open-source package manager for Apple macOS.

This repository contains homebrew formulas for RRG/Iceman Proxmark3 project with it dependencies.

[note] The old HID-flasher doesn't compile on this version. You'll need to manually fix/compile it on MacOS but this old flasher software is used if you have firmware from 2012 installed on your device.

Install

  • Install homebrew if you haven't yet already done so: http://brew.sh/

  • Tap this repo: brew tap rfidresearchgroup/proxmark3

  • Install Proxmark3:

    • brew install proxmark3 for stable release
    • brew install --HEAD proxmark3 for latest non-stable from GitHub (use this if previous command fails)
    • brew install --with-blueshark proxmark3 for blueshark support, stable release
    • brew install --HEAD --with-blueshark proxmark3 for blueshark support, latest non-stable from GitHub (use this if previous command fails)

Build options

Use brew info proxmark3 to see all available options.

Platform selection

Firmware is built for the Proxmark3 RDV4 device by default. Use the following options to select other platforms:

  • --with-generic: build for generic (non-RDV4) devices, see platform.
  • --with-small: enable build-time size limit for devices with 256kB flash, see 256kb versions.

Removing features

It's possible to remove features to reduce firmware size for 256kB devices using options such as --without-lf, --without-hitag, etc.

--without-foo corresponds to the SKIP_FOO compile options listed here.

Standalone mode

Firmware is built with the LF_SAMYRUN standalone mode by default. Use the --with-lf-foo or --with-hf-foo options to select a different standalone mode, or --without-standalone to disable standalone mode altogether.

--with-lf-foo corresponds to the STANDALONE=LF_FOO compile options listed here.

Errors while running

  • If you see this message To reinstall HEAD, run brew reinstall proxmark3
  • do this 
    brew remove proxmark3
brew reinstall proxmark3

Force HomeBrew to pull the latest source from github

brew upgrade --fetch-HEAD proxmark3

Usage

Proxmark3 client will be installed in /usr/local/bin/proxmark3

Firmware will be located in /usr/local/share/firmware/

The paths mentioned above are symlinks created by Homebrew (brew install implies brew link) to your Cellar.

See instructions on the RRG repo