Files

150 lines
9.2 KiB
Markdown
Raw Permalink Normal View History

2019-09-13 09:38:09 +02:00
# RRG / Iceman repo - Proxmark3
2019-05-05 17:19:53 +02:00
2019-12-02 20:28:29 +01:00
2020-05-20 10:24:20 +02:00
2020-09-17 14:22:07 +02:00
| Releases | Linux & OSX CI | Windows CI | Coverity | Contributors |
| ------------------- |:-------------------:| -------------------:| -------------------:| -------------------:|
2020-09-26 15:52:04 +02:00
| [![Latest release](https://img.shields.io/github/v/release/rfidresearchgroup/proxmark3)](https://github.com/RfidResearchGroup/proxmark3/releases/latest) | [![Build status](https://api.travis-ci.com/RfidResearchGroup/proxmark3.svg?branch=master)](https://travis-ci.com/RfidResearchGroup/proxmark3) | [![Build status](https://ci.appveyor.com/api/projects/status/b4gwrhq3nc876cuu/branch/master?svg=true)](https://ci.appveyor.com/project/RfidResearchGroup/proxmark3/branch/master) | [![Coverity Status](https://scan.coverity.com/projects/19334/badge.svg)](https://scan.coverity.com/projects/proxmark3-rrg-iceman-repo)| ![GitHub contributors](https://img.shields.io/github/contributors/rfidresearchgroup/proxmark3) |
2019-12-02 20:28:29 +01:00
2019-01-27 20:42:50 +01:00
2019-04-07 23:38:00 +01:00
# PROXMARK INSTALLATION AND OVERVIEW
2017-06-09 14:58:11 +02:00
2019-04-07 23:38:00 +01:00
| FAQ's & Updates | Installation | Use of the Proxmark |
| ------------------- |:-------------------:| -------------------:|
2020-03-05 09:24:11 +05:30
|[What has changed?](#what-has-changed) | **[Setup and build for Linux](/doc/md/Installation_Instructions/Linux-Installation-Instructions.md)** | [Compilation Instructions](/doc/md/Use_of_Proxmark/0_Compilation-Instructions.md)|
|[Development](#development) | **[Important notes on ModemManager for Linux users](/doc/md/Installation_Instructions/ModemManager-Must-Be-Discarded.md)** | [Validating proxmark client functionality](/doc/md/Use_of_Proxmark/1_Validation.md) |
|[Why didn't you base it on official Proxmark3 Master?](#why-didnt-you-base-it-on-official-proxmark3-master)| **[Homebrew (Mac OS X) & Upgrading HomeBrew Tap Formula](/doc/md/Installation_Instructions/Mac-OS-X-Homebrew-Installation-Instructions.md)** | [First Use and Verification](/doc/md/Use_of_Proxmark/2_Configuration-and-Verification.md)|
|[Proxmark3 GUI](#proxmark3-gui)|**[Setup and build for Windows](/doc/md/Installation_Instructions/Windows-Installation-Instructions.md)**|[Commands & Features](/doc/md/Use_of_Proxmark/3_Commands-and-Features.md)|
2020-04-24 07:58:46 +02:00
|[Issues](#issues)|[Blue shark manual](/doc/bt_manual_v10.md) ||
2020-05-19 09:46:18 +02:00
|[Donations](#Donations)|[Maintainers](/doc/md/Development/Maintainers.md)|[Command Cheat sheet](/doc/cheatsheet.md)|
2020-05-19 09:40:25 +02:00
||[Advanced compilation parameters](/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md)|[More cheat sheets](https://github.com/RfidResearchGroup/proxmark3/wiki/More-cheat-sheets)|
||**[Troubleshooting](/doc/md/Installation_Instructions/Troubleshooting.md)**|[Complete client command set](/doc/commands.md)|
2020-11-24 09:16:57 +01:00
||**[JTAG](/doc/jtag_notes.md)**|[T55xx Guide](/doc/T5577_Guide.md)|
2019-04-07 23:38:00 +01:00
2019-12-02 20:28:29 +01:00
2020-05-19 09:42:54 +02:00
## Notes / helpful documents
2020-05-20 10:24:20 +02:00
2020-05-19 09:42:54 +02:00
| Notes |||
2020-05-19 09:40:25 +02:00
| ------------------- |:-------------------:| -------------------:|
|[Notes on UART](/doc/uart_notes.md)|[Notes on Termux / Android](/doc/termux_notes.md)|[Notes on paths](/doc/path_notes.md)|
2020-05-19 10:14:39 +02:00
|[Notes on frame format](/doc/new_frame_format.md)|[Notes on tracelog / wireshark](/doc/trace_notes.md)|[Notes on EMV](/doc/emv_notes.md)|
2020-10-06 20:16:23 +02:00
|[Notes on external flash](/doc/ext_flash_notes.md)|[Notes on loclass](/doc/loclass_notes.md)|[Notes on Coverity Scan Config & Run](/doc/md/Development/Coverity-Scan-Config-and-Run.md)|
2020-06-02 18:51:57 +02:00
|[Notes on file formats used with Proxmark3](/doc/extensions_notes.md)|[Notes on MFU binary format](/doc/mfu_binary_format_notes.md)|[Notes on FPGA & ARM](/doc/fpga_arm_notes.md)|
2020-09-10 00:37:48 +02:00
|[Developing standalone mode](/armsrc/Standalone/readme.md)|[Wiki about standalone mode](https://github.com/RfidResearchGroup/proxmark3/wiki/Standalone-mode)|[Notes on Magic cards](/doc/magic_cards_notes.md)|
2020-09-15 04:30:30 +02:00
|[Notes on Color usage](/doc/colors_notes.md)|[Makefile vs CMake](/doc/md/Development/Makefile-vs-CMake.md)|[Notes on Cloner guns](/doc/cloner_notes.md)|
2020-11-10 21:54:33 +01:00
|[Notes on cliparser usage](/doc/cliparser.md)|[Notes on clocks](/doc/clocks.md)||
2020-05-20 10:24:20 +02:00
2019-12-02 20:28:29 +01:00
## Build for non-RDV4 Proxmark3 platforms
2019-09-03 13:11:49 +02:00
2019-08-26 09:12:26 +02:00
In order to build this repo for other Proxmark3 platforms we urge you to read [Advanced compilation parameters](/doc/md/Use_of_Proxmark/4_Advanced-compilation-parameters.md)
2019-12-02 20:28:29 +01:00
2019-05-05 00:24:29 +02:00
## What has changed?
2019-05-05 00:18:18 +02:00
On the hardware side:
* added flash memory 256kb.
* added smart card module
* added FPC connector
On the software side: quite a lot, see the [Changelog file](CHANGELOG.md).
2017-04-26 15:40:13 +02:00
## Development
2019-09-03 13:11:49 +02:00
2019-10-11 09:36:09 +02:00
> âš  **Note**: This is a bleeding edge repository. The maintainers actively is working out of this repository and will be periodically re-structuring the code to make it easier to comprehend, navigate, build, test, and contribute to, so **DO expect significant changes to code layout on a regular basis**.
2019-10-11 09:32:51 +02:00
This repo compiles nicely on
2020-03-25 17:27:19 +01:00
- Proxspace v3.x
2020-11-23 00:43:11 +01:00
- [latest release v3.7.1](https://github.com/Gator96100/ProxSpace/releases)
2020-05-20 10:24:20 +02:00
- Windows/mingw environment with Qt5.6.1 & GCC 4.9
2020-09-17 13:57:40 +02:00
- Ubuntu 16.04 -> 20.04
2020-05-19 09:49:53 +02:00
- ParrotOS, Gentoo, Pentoo, Kali, Nethunter, Archlinux, Fedora, Debian
2020-05-20 11:19:50 +02:00
- Rasbian
2020-05-19 09:49:53 +02:00
- Android / Termux
2017-03-07 14:39:30 +01:00
- Mac OS X / Homebrew
2020-09-17 13:57:40 +02:00
- WSL1 (Windows subsystem linux) on Windows 10
2017-03-07 14:39:30 +01:00
- Docker container
2020-05-20 10:24:20 +02:00
- [ RRG / Iceman repo based ubuntu 18.04 container ](https://hub.docker.com/r/secopsconsult/proxmark3)
- [ Iceman fork based container v1.7 ](https://hub.docker.com/r/iceman1001/proxmark3/)
Hardware to run client on
- PC
2020-05-20 11:19:50 +02:00
- Android
- Raspberry Pi & Raspberry Pi Zero
2020-09-17 13:57:40 +02:00
- Nvidia Jetson Nano
2019-05-05 00:41:20 +02:00
2020-06-04 09:22:17 +02:00
## Precompiled binaries
We don't maintain any precompiled binaries in this repo. There is community effort over at the Proxmark3 forum where @gator96100 has set up a google drive with many mingw binaries which is up-to-date. We link to these files here as to make it easier for users.
2020-06-04 09:24:17 +02:00
If you are having troubles with these files, contact the package maintainer @gator96100 and read the [sticky thread at forum](http://www.proxmark.org/forum/viewtopic.php?pid=24763#p24763) where known issues has been documented.
Ref:
2020-09-17 13:57:40 +02:00
For Proxmark3 RDV4
2020-06-04 09:22:17 +02:00
- [Precompiled builds for RDV40 dedicated x86](https://drive.google.com/open?id=13zUs-aiQkYaSl5KWrBtuW5IWCoHJPsue)
- [Precompiled builds for RDV40 dedicated x64](https://drive.google.com/open?id=1SyPB8t5Vo8O0Lh7PjNm3Kv-mO4BNbxjX)
2020-09-17 13:57:40 +02:00
For Proxmark3 RDV4 with blueshark addon
2020-06-04 09:22:17 +02:00
- [Precompiled builds for RDV40 dedicated with Bluetooth addon x86](https://drive.google.com/open?id=1TqWYctkRvkLshQ1ZRBHPLDzYHR-asuMO)
- [Precompiled builds for RDV40 dedicated with Bluetooth addon x64](https://drive.google.com/open?id=17ful7u2QyYmMQzQzc5fAf8nJvyoDJfSL)
2020-09-17 13:57:40 +02:00
Generice Proxmark3 devices (non RDV4), for Proxmark3 Easy, RDV1, RDV2, RDV3, etc etc
2020-06-04 09:22:17 +02:00
- [Precompiled builds for RRG / Iceman repository x86](https://drive.google.com/open?id=1PI3Xr1mussPBPnYGu4ZjWzGPARK4N7JR)
- [Precompiled builds for RRG / Iceman repository x64](https://drive.google.com/open?id=1uX9RtYGinuFrpHybu4xq_BE3HrobI20e)
2020-05-20 10:25:00 +02:00
## Roadmap
2019-10-16 10:05:21 +02:00
The [public roadmap](https://github.com/RfidResearchGroup/proxmark3/wiki/Public-Roadmap) is an excellent start to read if you are interesting in contributing.
2019-10-11 09:36:09 +02:00
> 👉 **Remember!** If you intend to contribute to the code, please read the [coding style notes](HACKING.md) first.
2019-10-11 09:34:55 +02:00
We usually merge your contributions fast since we do like the idea of getting a functionality in the Proxmark3 and weed out the bugs afterwards.
2019-05-05 00:42:07 +02:00
2020-05-19 09:40:25 +02:00
2020-05-20 10:24:20 +02:00
## Issues & Troubleshooting
2020-09-17 13:57:40 +02:00
Please search the [issues](https://github.com/rfidresearchgroup/proxmark3/issues) page here and see if your issue is listed in the first instance.
2020-05-20 10:24:20 +02:00
Read the [Troubleshooting](/doc/md/Installation_Instructions/Troubleshooting.md) guide to weed out most known problems.
2020-09-17 13:57:40 +02:00
Next place to visit is the [Proxmark Forum](http://www.proxmark.org/forum/index.php). Learn to search it well and finally Google / duckduckgo is your friend :) You will find many blogposts, youtube videos, tweets, reddit
### Offical channels
2020-05-20 10:24:20 +02:00
- [Proxmark3 IRC channel](http://webchat.freenode.net/?channels=#proxmark3)
- [Proxmark3 sub reddit](https://www.reddit.com/r/proxmark3/)
- [Twitter](https://twitter.com/proxmark3/)
2020-07-30 11:20:48 +02:00
- [Proxmark3 community discord server](https://discord.gg/zjxc8ZB)
_no slack channel_
2020-05-20 10:24:20 +02:00
Iceman has quite a few videos on his [youtube channel](https://www.youtube.com/c/ChrisHerrmann1001)
2019-08-15 21:32:00 +02:00
## Cheat sheet
2019-09-03 13:11:49 +02:00
2019-08-15 21:32:00 +02:00
Thanks to Alex Dibs, you can enjoy a [command cheat sheet](/doc/cheatsheet.md)
2019-05-05 20:05:02 +02:00
2019-08-31 10:58:42 +02:00
## Maintainers ( package, distro )
2019-09-03 13:11:49 +02:00
2019-08-31 10:58:42 +02:00
To all distro, package maintainers, we tried to make your life easier. `make install` is now available and if you want to know more.
- [Maintainers](/doc/md/Development/Maintainers.md)
2019-06-17 09:49:10 +02:00
## Why didn't you base it on official Proxmark3 Master?
2019-06-17 09:49:10 +02:00
The separation from official Proxmark3 repo gives us a lot of freedom to create a firmware/client that suits the RDV40 features. We don't want to mess up the official Proxmark3 repo with RDV40 specific code.
2019-06-17 09:49:10 +02:00
## Proxmark3 GUI
2019-09-03 13:11:49 +02:00
2019-04-07 23:38:00 +01:00
The official PM3-GUI from Gaucho will not work.
2020-09-17 13:57:40 +02:00
The new [Proxmark3 Universal GUI](https://github.com/burma69/PM3UniversalGUI) will work more or less. Change is needed in order to show helptext when client isn't connected to a device. We don't know how active the maintainers.
2019-04-07 23:38:00 +01:00
## The end
2019-10-08 14:37:00 +02:00
- July 2018 [@herrmann1001](https://mobile.twitter.com/herrmann1001)
2019-05-05 17:19:53 +02:00
- updated Feb 2019 [@5w0rdfish](https://mobile.twitter.com/5w0rdFish)
2019-10-08 14:37:00 +02:00
- updated 2019 [@doegox](https://mobile.twitter.com/doegox)
2019-04-07 23:38:00 +01:00
# Donations
2019-09-03 13:11:49 +02:00
2019-06-17 09:49:10 +02:00
Nothing says thank you as much as a donation. So if you feel the love, do feel free to become a iceman patron. For some tiers it comes with rewards.
https://www.patreon.com/iceman1001