diff --git a/README.md b/README.md index 7edf9b7..d62b9ae 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # Proxmark3GUI A GUI for [Proxmark3](https://github.com/Proxmark/proxmark3) client -[中文](README/README.zh_CN.md) +[中文](README/doc/README_zh_CN.md) *** @@ -11,29 +11,55 @@ A GUI for [Proxmark3](https://github.com/Proxmark/proxmark3) client + Support raw commands of Proxmark3 client(Official/Iceman) + Have a friendly UI to test Mifare cards + Support different card size(MINI, 1K, 2K, 4K) - + Easy to edit Mifare data files + + Easy to edit Mifare block data + Easy to read all/selected blocks with well-designed read logic + + Easy to write all/selected blocks + Support binary(.bin .dump) files and text(.eml) files + Analyze Access Bits + Support Chinese Magic Card -+ Customize UI -+ ... ++ Customize UI ++ ... *** -## Previews -![nested_attack](README/mf_nested_attack.gif) +## Preview +![preview](README/img/preview.png) -![mf_load_file](README/mf_load_file.gif) +more previews [here](README/doc/previews.md) -![mf_edit_file](README/mf_edit_file.gif) +*** + +## About Iceman fork/repo + +The [Iceman fork/repo](https://github.com/RfidResearchGroup/proxmark3) has more powerful functions like offline sniff. These guys even developed a new hardware called Proxmark3 RDV4 with smart card support. But the official repo and the Iceman repo is not fully compatible. +This GUI was designed for only official repo at first, but I'm trying to make it compatible with Iceman repo. -![raw_command](README/raw_command.gif) +Supported functions when using Iceman client: + +[supported functions](README/doc/supported_Iceman.md) + +*** + +## About Compiled Windows clients + +A cool guy [Gator96100](https://github.com/Gator96100) creates [ProxSpace](https://github.com/Gator96100/ProxSpace) and makes it possible to compile both the firmware and client on Windows. +Also, he makes the [pre-compiled Windows client](http://www.proxmark.org/forum/viewtopic.php?id=3975) so you can download it and run your PM3 client on Windows instantly. +I included his compiled client in my releases so you can use the GUI on the fly, and you can also use the GUI with your prefered client. +Great thanks to him. *** ## Update Log: +### V0.1.2 ++ Optimize read logic ++ Make UI Customizable ++ Save client path automatically ++ Add Trailer Decoder ++ Support read/write selected blocks ++ Support a few Iceman functions ++ Fix some bugs + ### V0.1.1 + Complete Mifare module(support simulate and sniff) diff --git a/README/README.zh_CN.md b/README/README.zh_CN.md deleted file mode 100644 index fdb8734..0000000 --- a/README/README.zh_CN.md +++ /dev/null @@ -1,38 +0,0 @@ -# Proxmark3GUI -一个自制的[Proxmark3](https://github.com/Proxmark/proxmark3) GUI - -[English](../README.md) - -*** - -## 特色功能 - -+ 支持直接输入PM3命令 -+ 有针对于Mifare卡(IC卡)的图形界面 -+ 支持编辑Mifare扇区数据文件 -+ 可以打开二进制/文本格式的扇区数据文件 -+ ... - -*** - -## 预览图 -![nested_attack](mf_nested_attack.gif) - -![mf_load_file](mf_load_file.gif) - -![mf_edit_file](mf_edit_file.gif) - -![raw_command](raw_command.gif) - -*** - -## 更新日志: - -### V0.1.1 -+ 完成整个Mifare模块(支持模拟卡和嗅探功能) - -### V0.1 -+ 支持处理Mifare卡片及相关数据文件 - -### V0.0.1 -+ 一个带串口选择框的实验版本 \ No newline at end of file diff --git a/README/doc/README_zh_CN.md b/README/doc/README_zh_CN.md new file mode 100644 index 0000000..b76c129 --- /dev/null +++ b/README/doc/README_zh_CN.md @@ -0,0 +1,66 @@ +# Proxmark3GUI +一个自制的[Proxmark3](https://github.com/Proxmark/proxmark3) GUI + +[English](../../README.md) + +*** + +## 功能 + ++ 快速查找可用端口并连接 ++ 支持直接输入PM3命令(官方版/冰人版) ++ 有针对于Mifare卡(IC卡)的图形界面 + + 支持不同大小的卡片(MINI, 1K, 2K, 4K) + + 支持编辑Mifare扇区数据 + + 支持读取全卡/选中扇区,读卡逻辑更加智能 + + 支持写入全卡/选中扇区 + + 可以打开二进制/文本格式的扇区数据文件 + + 分析访问控制位(Access Bits) + + 支持UID卡操作(UID快速读写,UFUID锁卡) ++ 自定义UI界面 ++ ... + +*** + +## 预览图 +![preview](../img/preview_zh_CN.png) + + [更多预览](../doc/previews.md) + +*** + + ## 关于冰人版 + 这个GUI一开始是针对官方版本做的,现在正在尽力让它兼容冰人版的功能 + (没钱买RDV4也没钱买两台PM3,测一次冰人就要烧一次固件 qwq) + + [已支持功能](../doc/supported_Iceman.md) +*** + +## 关于预编译Windows客户端 + +一个国外大佬 [Gator96100](https://github.com/Gator96100) 做了个 [ProxSpace](https://github.com/Gator96100/ProxSpace) 以便在Windows平台上编译PM3固件和客户端,他还把自己编译好的客户端放到了[论坛](http://www.proxmark.org/forum/viewtopic.php?id=3975)里面 +文件都是放到Google Drive上面的,国内网络无法访问,所以我在release版本里面放了个带预编译客户端版本的GUI。这个GUI也可以搭配你自己的客户端使用 +(本来打算在CSDN下载里面放几个最新版客户端的,结果不能把下载币改为0) +感谢大佬 + +*** + +## 更新日志: + +### V0.1.2 ++ 优化读卡逻辑 ++ UI自定义 ++ 自动保存客户端路径 ++ 添加访问控制位解码器(也可用于自己构造访问控制位) ++ 支持仅读写选中块 ++ 支持部分冰人功能 ++ 修复部分bug + +### V0.1.1 ++ 完成整个Mifare模块(支持模拟卡和嗅探功能) + +### V0.1 ++ 支持处理Mifare卡片及相关数据文件 + +### V0.0.1 ++ 一个带串口选择框的实验版本 \ No newline at end of file diff --git a/README/doc/previews.md b/README/doc/previews.md new file mode 100644 index 0000000..b9ae1cb --- /dev/null +++ b/README/doc/previews.md @@ -0,0 +1,16 @@ +## Previews + +Raw Command: +![raw_command](../img/raw_command.gif) + +Mifare Nested Attack: +![nested_attack](../img/mf_nested_attack.gif) + +Mifare Load File: +![mf_loadfile](../img/mf_loadfile.gif) + +Mifare Edit File: +![mf_editfile](../img/mf_editfile.gif) + +Mifare Trailer Decoder: +![mf_trailer](../img/mf_trailer.gif) \ No newline at end of file diff --git a/README/doc/supported_Iceman.md b/README/doc/supported_Iceman.md new file mode 100644 index 0000000..70dbef0 --- /dev/null +++ b/README/doc/supported_Iceman.md @@ -0,0 +1,9 @@ +## About Iceman fork/repo + +The [Iceman fork/repo](https://github.com/RfidResearchGroup/proxmark3) has more powerful functions like offline sniff. These guys even developed a new hardware called Proxmark3 RDV4 with smart card support. But the official repo and the Iceman repo is not fully compatible. This GUI was designed for only official repo at first, but I'm trying to make it compatible with Iceman repo. +Supported functions when using Iceman client: ++ Command Line ++ Mifare Card info ++ Mifare Check default keys ++ Mifare Nested Attack ++ Mifare Read/Write \ No newline at end of file diff --git a/README/img/mf_editfile.gif b/README/img/mf_editfile.gif new file mode 100644 index 0000000..69580a2 Binary files /dev/null and b/README/img/mf_editfile.gif differ diff --git a/README/img/mf_loadfile.gif b/README/img/mf_loadfile.gif new file mode 100644 index 0000000..d98e55f Binary files /dev/null and b/README/img/mf_loadfile.gif differ diff --git a/README/img/mf_nested_attack.gif b/README/img/mf_nested_attack.gif new file mode 100644 index 0000000..18f5363 Binary files /dev/null and b/README/img/mf_nested_attack.gif differ diff --git a/README/img/mf_trailer.gif b/README/img/mf_trailer.gif new file mode 100644 index 0000000..64497de Binary files /dev/null and b/README/img/mf_trailer.gif differ diff --git a/README/img/preview.png b/README/img/preview.png new file mode 100644 index 0000000..0c26557 Binary files /dev/null and b/README/img/preview.png differ diff --git a/README/img/preview_zh_CN.png b/README/img/preview_zh_CN.png new file mode 100644 index 0000000..119f702 Binary files /dev/null and b/README/img/preview_zh_CN.png differ diff --git a/README/img/raw_command.gif b/README/img/raw_command.gif new file mode 100644 index 0000000..4262519 Binary files /dev/null and b/README/img/raw_command.gif differ diff --git a/README/mf_edit_file.gif b/README/mf_edit_file.gif deleted file mode 100644 index 25c5de3..0000000 Binary files a/README/mf_edit_file.gif and /dev/null differ diff --git a/README/mf_load_file.gif b/README/mf_load_file.gif deleted file mode 100644 index f8dc95e..0000000 Binary files a/README/mf_load_file.gif and /dev/null differ diff --git a/README/mf_nested_attack.gif b/README/mf_nested_attack.gif deleted file mode 100644 index 0ac5bc4..0000000 Binary files a/README/mf_nested_attack.gif and /dev/null differ diff --git a/README/raw_command.gif b/README/raw_command.gif deleted file mode 100644 index 0a8c67b..0000000 Binary files a/README/raw_command.gif and /dev/null differ