diff --git a/README.md b/README.md index a5eef42..5efcebb 100644 --- a/README.md +++ b/README.md @@ -67,7 +67,8 @@ Great thanks to him. *** ## Tutorial -[1.Quickstart](doc/tutorial/Quickstart/quickstart.md) +[1.Quickstart](doc/tutorial/Quickstart/quickstart.md) +[2.Edit Mifare Classic data](doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data.md)(Proxmark3 hardware is not necessary) *** ## Update Log: diff --git a/doc/README/README_zh_CN.md b/doc/README/README_zh_CN.md index 8c3a2a0..575461b 100644 --- a/doc/README/README_zh_CN.md +++ b/doc/README/README_zh_CN.md @@ -65,7 +65,8 @@ release页面中有含客户端的GUI。这个GUI也可以搭配你自己的客 *** ## 教程 -[1.快速上手](../tutorial/Quickstart/quickstart_zh_CN.md) +[1.快速上手](../tutorial/Quickstart/quickstart_zh_CN.md) +[2.编辑Mifare(IC)卡数据](../tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data_zh_CN.md)（无需PM3硬件） *** ## 更新日志: diff --git a/doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data.md b/doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data.md new file mode 100644 index 0000000..94704ac --- /dev/null +++ b/doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data.md @@ -0,0 +1,50 @@ +# Edit Mifare Classic data + +[中文教程](Edit_Mifare_Classic_data_zh_CN.md) +This function is useful even if you don't use Proxmark3. + +## About card type +There are four sizes of Mifare Classic card ++ 320Byte, also known as MINI, S20 ++ 1kB, also known as S50 ++ 2kB ++ 4kB, alsow known as S70 + +Before any operation, you need to choose the right card type. +If you don't know your card type, you can try 1K first. Mifare Classic S50(1K) is the most common type. +![](cardtype.png) + +## About file format +This program supports binary data file and text data file. +Binary data files have the same size of chosen card type.(e.g, type 1K->1024KB data file). +The file extensions of them are always .dump or .bin. +You can edit them by hex editor or this program. +![](binary_file.png) +Text data files can be open by any text editors. +The file extensions of them are always .eml or .txt. +![](text_file.png) + +## Load +Go to "Mifare"->"File"->, choose "data" on the left and click "Load", then choose the file you want to load. The program will detect the file type by context. +![](load.png) +![](after_load.png) +Also, you can drag the file into data widget to load the data file. +![](drag.png) + +## Edit +Double click any data row to start edit +![](edit.png) +You don't need to fill the space between every byte. +![](edit_nospace.png) + +## Save +Go to "Mifare"->"File"->, choose "data" on the left and click "Save", then choose the path you want to save and the file format. +![](save.png) + +## File format convert +If you got a binary data file and you want to edit with notepad, here are the steps. ++ Load the orignal binary file ++ Save it as a text file ++ Edit the new file with whatever you want then save it ++ Load the edited file ++ Save it as binary file \ No newline at end of file diff --git a/doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data_zh_CN.md b/doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data_zh_CN.md new file mode 100644 index 0000000..a212eaa --- /dev/null +++ b/doc/tutorial/Edit_Mifare_Classic_data/Edit_Mifare_Classic_data_zh_CN.md @@ -0,0 +1,51 @@ +# 编辑Mifare(IC)卡数据 + +[English](Edit_Mifare_Classic_data.md) +此功能对没有PM3硬件的用户也很有用。 + +## 关于卡类型 +Mifare Classic卡有四种不同的容量 ++ 320字节，也被称作MINI卡，S20卡 ++ 1k字节，也被称为S50卡，最常见的型号 ++ 2k字节 ++ 4k字节，也被称为S70卡 + +在操作前，请先选择卡类型。 +如果自己不清楚卡类型，可尝试选择1k卡，这是最常见的型号。 +![](cardtype_zh_CN.png) + +## 关于文件格式 +此程序支持二进制文件格式和文本文件格式。 +二进制文件的大小和所选卡类型的大小完全相等，文件中的每一个字节对应卡片数据中的一个字节。 +二进制文件的后缀名一般是.dump或.bin。 +此类文件需要使用16进制编辑器或者此程序来编辑。 +![](binary_file.png) +文本文件可被任意文本编辑器打开。 +此类文件的后缀名一般是.eml或.txt。 +![](text_file.png) + +## 加载文件 +在“Mifare”选项卡->“文件”框中勾选“数据”，点击“加载”按钮载入文件。 +此程序会根据文件内容判断待加载的文件格式。 +![](load.png) +![](after_load_zh_CN.png) +程序还支持拖拽加载。你可以直接把文件拖入左边数据显示器中。 +![](drag_zh_CN.png) + +## 编辑数据 +双击数据行即可开始编辑。 +![](edit_zh_CN.png) +编辑过程中无需手动补全字节间空格。 +![](edit_nospace_zh_CN.png) + +## 保存文件 +在“Mifare”选项卡->“文件”框中勾选“数据”，点击“保存”按钮，选择保存的路径和文件格式即可保存文件。 +![](save.png) + +## 文件格式转换 +如果你想用其它文本编辑器编辑二进制文件，可以参考以下步骤 ++ 加载原始二进制文件 ++ 保存为文本文件 ++ 用自己喜欢的文本编辑器编辑后保存 ++ 加载编辑后的文件 ++ 保存为二进制文件 \ No newline at end of file diff --git a/doc/tutorial/Edit_Mifare_Classic_data/after_load.png b/doc/tutorial/Edit_Mifare_Classic_data/after_load.png new file mode 100644 index 0000000..0ab879f Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/after_load.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/after_load_zh_CN.png b/doc/tutorial/Edit_Mifare_Classic_data/after_load_zh_CN.png new file mode 100644 index 0000000..cbc55b6 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/after_load_zh_CN.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/binary_file.png b/doc/tutorial/Edit_Mifare_Classic_data/binary_file.png new file mode 100644 index 0000000..351a491 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/binary_file.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/cardtype.png b/doc/tutorial/Edit_Mifare_Classic_data/cardtype.png new file mode 100644 index 0000000..a53b313 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/cardtype.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/cardtype_zh_CN.png b/doc/tutorial/Edit_Mifare_Classic_data/cardtype_zh_CN.png new file mode 100644 index 0000000..2dcddf7 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/cardtype_zh_CN.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/drag.png b/doc/tutorial/Edit_Mifare_Classic_data/drag.png new file mode 100644 index 0000000..b2fd67d Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/drag.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/drag_zh_CN.png b/doc/tutorial/Edit_Mifare_Classic_data/drag_zh_CN.png new file mode 100644 index 0000000..2d4f180 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/drag_zh_CN.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/edit.png b/doc/tutorial/Edit_Mifare_Classic_data/edit.png new file mode 100644 index 0000000..6e492a5 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/edit.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/edit_nospace.png b/doc/tutorial/Edit_Mifare_Classic_data/edit_nospace.png new file mode 100644 index 0000000..de3544f Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/edit_nospace.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/edit_nospace_zh_CN.png b/doc/tutorial/Edit_Mifare_Classic_data/edit_nospace_zh_CN.png new file mode 100644 index 0000000..e26d6a7 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/edit_nospace_zh_CN.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/edit_zh_CN.png b/doc/tutorial/Edit_Mifare_Classic_data/edit_zh_CN.png new file mode 100644 index 0000000..e0b3025 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/edit_zh_CN.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/load.png b/doc/tutorial/Edit_Mifare_Classic_data/load.png new file mode 100644 index 0000000..3bd334d Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/load.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/save.png b/doc/tutorial/Edit_Mifare_Classic_data/save.png new file mode 100644 index 0000000..1334b53 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/save.png differ diff --git a/doc/tutorial/Edit_Mifare_Classic_data/text_file.png b/doc/tutorial/Edit_Mifare_Classic_data/text_file.png new file mode 100644 index 0000000..a903f35 Binary files /dev/null and b/doc/tutorial/Edit_Mifare_Classic_data/text_file.png differ diff --git a/doc/tutorial/Quickstart/quickstart.md b/doc/tutorial/Quickstart/quickstart.md index b9bfe0c..7e83d61 100644 --- a/doc/tutorial/Quickstart/quickstart.md +++ b/doc/tutorial/Quickstart/quickstart.md @@ -1,5 +1,6 @@ # Quickstart +[中文教程](quickstart_zh_CN.md) *** **On Windows** *** diff --git a/doc/tutorial/Quickstart/quickstart_zh_CN.md b/doc/tutorial/Quickstart/quickstart_zh_CN.md index 1907d93..c7452a0 100644 --- a/doc/tutorial/Quickstart/quickstart_zh_CN.md +++ b/doc/tutorial/Quickstart/quickstart_zh_CN.md @@ -1,5 +1,6 @@ # 快速上手 +[English](quickstart.md) *** **Windows用户** ***