= Mac OS X =
============
-macport stuff should do ;)
+Tested on OSX 10.10 Yosemite
+
+1 - Install Xcode and Xcode Command Line Tools
+
+2 - Install Homebrew and dependencies
+ brew install readline
+ brew instal libusb
+
+3 - Download DevKitARM for OSX
+ http://sourceforge.net/projects/devkitpro/files/devkitARM/devkitARM_r44/
+ Unpack devkitARM_r44-osx.tar.bz2 to proxmark3 directory.
+
+4 - Edit proxmark3/client/Makefile adding path to readline
+
+ LDLIBS = -L/usr/local/Cellar/readline/6.3.8/lib/ -L/opt/local/lib -L/usr/local/lib ../liblua/liblua.a -lreadline -lpthread -lm
+ CFLAGS = -std=c99 -I/usr/local/Cellar/readline/6.3.8/include/ -I. -I../include -I../common -I/opt/local/include -I../liblua -Wall $(COMMON_FLAGS) -g -O4
+
+ Replace path /usr/local/Cellar/readline/6.3.8 with your actuall readline path. See homebrew manuals.
+
+5 - Set Environment
+
+ export DEVKITPRO=$HOME/proxmark3/
+ export DEVKITARM=$DEVKITPRO/devkitARM
+ export PATH=${PATH}:${DEVKITARM}/bin
+
============
= Linux =
============
+1 - Download
+
+A precompiled DevKitARM cross compiler tool chain package can be found at
+http://sourceforge.net/projects/devkitpro/files/devkitARM
+Select the one you need (32bit or 64bit) and unpack to a convinient place, eg
+$HOME/proxmark3/. It will create a devkitARM/ subdirectory.
+
+You will also need a general compiling environment on your computer for
+the client and the libusb headers. In most distributions you will get all you
+need with the lsb-package (Linux Standard Base). In debian/ubuntu you simply
+call `aptitude install lsb libusb-dev libreadline-dev libreadline6`.
+
+For the graphical plot view, you might need the qtlibs (debian/ubuntu:
+libqt4-dev), too.
+
+2 - Set Environment
+
+export DEVKITPRO=$HOME/proxmark3/
+export DEVKITARM=$DEVKITPRO/devkitARM
+export PATH=${PATH}:${DEVKITARM}/bin