X-Git-Url: http://cvs.zerfleddert.de/cgi-bin/gitweb.cgi/proxmark3-svn/blobdiff_plain/dc1c9ae4a99cf1bcd60be7d9e7ae9fb6a753a860..4003623bae217b7749cdf9e8dd89ab35f9333109:/README.md diff --git a/README.md b/README.md index 354504b1..57a1335c 100644 --- a/README.md +++ b/README.md @@ -1,20 +1,16 @@ The iceman fork ---------------- +=============== [![Build Status](https://travis-ci.org/iceman1001/proxmark3.svg?branch=master)](https://travis-ci.org/iceman1001/proxmark3) [![Coverity Status](https://scan.coverity.com/projects/5117/badge.svg)](https://scan.coverity.com/projects/proxmark3-iceman-fork) [![Latest release] (https://img.shields.io/github/release/iceman1001/proxmark3.svg)] (https://github.com/iceman1001/proxmark3/releases/latest) -##::THIS FORK IS HIGHLY EXPERIMENTAL:: - -##NOTICE: +##This fork is HIGHLY experimental +##Notice There is so much in this fork, with all fixes and additions its basically the most enhanced fork to this day for the Proxmark3 device. - -##OFFICAL +##Offical The official Proxmark repository is found here: https://github.com/Proxmark/proxmark3 - -## Coverity Scan Config && Run - +##Coverity Scan Config & Run Download the Coverity Scan Self-buld and install it. You will need to configure ARM-NON-EABI- Compiler for it to use: @@ -29,8 +25,7 @@ tar czvf proxmark3.tgz cov-int :: upload it to coverity.com -## Whats changed? - +##Whats changed? Whats so special with this fork? I have scraped the web for different enhancements to the PM3 source code and not all of them ever found their way to the master branch. Among the stuff is @@ -54,14 +49,13 @@ Among the stuff is * A Bruteforce for AWID 26, starting w a facilitycode then trying all 0xFFFF cardnumbers via simulation. To be used against a AWID Reader. * A Bruteforce for HID, starting w a facilitycode then trying all 0xFFFF cardnumbers via simulation. To be used against a HID Reader. * Blaposts Crapto1 v3.3 - * Icsom's legic script and legic enhancements - * Aczid's bitsliced bruteforce solver in 'hf mf hardnested' - + * Icsom's legic script and legic enhancements + * Aczid's bitsliced bruteforce solver in 'hf mf hardnested' ---- -Straight from the CHANGELOG ---- - - 'lf viking clone' - fixed a bug. (iceman) +##Straight from the CHANGELOG +============================= + - 'lf nedap' - added identification of a NEDAP tag. (iceman) + - 'lf viking clone' - fixed a bug. (iceman) - Added bitsliced bruteforce solver in 'hf mf hardnested' (aczid) - 'hf mf chk' speedup (iceman) - 'hf 14a/mf sim x" attack mode, now uses also moebius version of mfkey32 to try finding the key. (iceman) @@ -96,27 +90,20 @@ Straight from the CHANGELOG - Fixed the silent mode for 14b to be used inside 'hf search' (iceman) --- - Give me a hint, and I'll see if I can't merge in the stuff you have. I don't actually know how to make small pull-request to github :( and that is the number one reason for me not pushing a lot of things back to the PM3 master. -PM3 GUI: --------- +##PM3 GUI I do tend to rename and move stuff around, the official PM3-GUI from Gaucho will not work so well. *sorry* - - -DEVELOPMENT: ------------- +##Development This fork now compiles just fine on - windows/mingw environment with Qt5.3.1 & GCC 4.8 - Ubuntuu 1404, 1510 - Mac OS X - -SETUP AND BUILD FOR UBUNTU --------------------------- + - Windows/mingw environment with Qt5.3.1 & GCC 4.8 + - Ubuntuu 1404, 1510 + - Mac OS X (or before the hardnested BF solver at least) +##Setup and build for UBUNTU GC made updates to allow this to build easily on Ubuntu 14.04.2 LTS or 15.10 See https://github.com/Proxmark/proxmark3/wiki/Ubuntu%20Linux @@ -165,10 +152,9 @@ Change into the client folder. Run the client -> ./proxmark3 /dev/ttyACM0 -homebrew (Mac OS X) -================== +##Homebrew (Mac OS X) These instructions comes from @Chrisfu, where I got the proxmark3.rb scriptfile from. -Further questions about Mac & Homebrew, contact @Chrisfu +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/ @@ -176,25 +162,28 @@ Further questions about Mac & Homebrew, contact @Chrisfu 3. Install Proxmark3: `brew install proxmark3` for stable release or `brew install --HEAD proxmark3` for latest non-stable from GitHub. - -Enjoy -------------------- -January 2015, Sweden -iceman at host iuse.se - +##Docker container +I recently added a docker container on Docker HUB. You find it here: https://hub.docker.com/r/iceman1001/proxmark3/ +Follow those instructions to get it up and running. No need for the old proxspace-environment anymore. -BUYING A PROXMARK 3 -------------------- - +##Buying a proxmark3 The Proxmark 3 device is available for purchase (assembled and tested) from the following locations: * http://www.elechouse.com (new and revised hardware package 2015) I recommend you to buy this version. --------------------------------------------------------------------------- +##Enjoy + +January 2015, Sweden +iceman at host iuse.se + + + + +##Note from Jonathan Westhues 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-