AndProx

Version: 2.0.5

Prototype / work-in-progress native Android client for Proxmark 3, which doesn't require root, permission changes or other messing about with kernel modules.

This is intended to become a replacement for Proxdroid and other "root required" Android forks. It uses the Android USB Host API and mik3y's USB Serial for Android driver to access the Proxmark's USB ACM interface from user-space Java code.

Opt-in to the beta on Google Play | Direct APK download also available

Documentation

• Compatibility (hardware, firmware, Android)
• Connecting the PM3, troubleshooting information
• Building and hacking on the code
• Common build issues -- do not download ZIP files from GitHub, it will not work!

NOTE: AndProx presumes existing familiarity with Proxmark3's CLI.

Functionality / Known Issues

• Cross compiles to armeabi, armeabi-v7a, arm64-v8a, x86 and x86_64. Only really tested on ARM.

• Many LF commands appear to work. Some devices need a Y cable and external power source for HF commands.

• LF graphs are not available yet. (Issue #1, Issue #2)

• Scripting doesn't work properly, but most of the ground work is there. (Issue #3)

• hf mf hardnested commands use a lot of memory. In the event of running out of memory, it will close the application without warning.

• Flasher has not been implemented.

• Probably doesn't exit or sleep cleanly, causing high battery use. Swipe the app away from the App Switcher when done, and unplug the PM3.

Getting started

1. Install the APK, or side-load the APK from GitHub.

2. Plug your Proxmark3 into your Android device.

3. Run AndProx, and accept the permissions bump.

4. Press "Connect"

5. Try hw version, hw status and hw tune to test out the device!

AndProx will write files to Internal Storage, in the proxmark3 directory.

Licensing

Copyright 2016-2018 Michael Farrell.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Under section 7 of the GNU General Public License v3, the following additional terms apply to this program:

• (b) You must preserve reasonable legal notices and author attributions in the program.

• (c) You must not misrepresent the origin of this program, and need to mark modified versions in reasonable ways as different from the original version (such as changing the name and logos).

• (d) You may not use the names of licensors or authors for publicity purposes, without explicit written permission.

AndProx includes several third-party components under other licenses. More detail of these components is shown in third_party/README.md.