proxmark3/doc/md/Installation_Instructions/Mac-OS-X-Homebrew-Installation-Instructions.md
Uli Heilmeier 345f936054 Doc: Update macOS install instruction
Reviewed install instructions for macOS and updated where necessary.
2019-05-10 22:39:54 +02:00

2 KiB

Homebrew (Mac OS X)

These instructions comes from @Chrisfu, where we got the proxmark3.rb scriptfile from. For further questions about Mac & Homebrew, contact @Chrisfu (https://github.com/chrisfu/)

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

  2. Tap this repo: brew tap RfidResearchGroup/proxmark3

  3. Install Proxmark3: brew install proxmark3 for stable release or brew install --HEAD proxmark3 for latest non-stable from GitHub.

Upgrading HomeBrew tap formula

This method is useful for those looking to run bleeding-edge versions of RRG/iceman's client. Keep this in mind when attempting to update your HomeBrew tap formula as this procedure could easily cause a build to break if an update is unstable on macOS.

Tested on macOS Mojave 10.14.4

Note: This assumes you have already installed RRG/iceman's fork from HomeBrew as mentioned above

Force HomeBrew to pull the latest source from github

brew upgrade --fetch-HEAD proxmark3

Flash the BOOTROM & FULLIMAGE

With your Proxmark3 unplugged from your machine, press and hold the button on your Proxmark3 as you plug it into a USB port. Continue to hold the button until after this step is complete and the proxmark3-flasher command outputs "Have a nice day!"

sudo proxmark3-flasher /dev/tty.usbmodemiceman1 -b /usr/local/Cellar/proxmark3/HEAD-<Commit-ID>/share/firmware/bootrom.elf /usr/local/Cellar/proxmark3/HEAD-<Commit-ID>/share/firmware/fullimage.elf

Replace <Commit-ID> with the HEAD-XXXX ID displayed by brew.
Depending on the firmware version your Proxmark3 can also appear as /dev/tty.usbmodem881

Run the client

sudo proxmark3 /dev/tty.usbmodemiceman1

Next steps

For the next steps, please read the following pages: