Skip to content

Commit 65c8ef6

Browse files
authored
Update README.md
1 parent 053e6c7 commit 65c8ef6

1 file changed

Lines changed: 119 additions & 1 deletion

File tree

README.md

Lines changed: 119 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,119 @@
1-
# VolumeAssignController
1+
# VolumeAssignController
2+
3+
This is a simple program that allows you to assign or unassign a volume in a simple click. It is based on `diskpart.exe`.
4+
5+
*Since MucheXD is a native Chinese speaker. In case of conflict, please refer to the instructions [in Chinese](README_ZH.md).*
6+
7+
## How To Use
8+
9+
### Configurations
10+
11+
There will be a file `config.mtd` in the program's running dir, you can open it in any text editor (json editor recommended). The config file follows json grammar. You should edit it like the example below:
12+
13+
```json
14+
15+
{
16+
17+
"configs": [
18+
19+
{
20+
21+
"name": "default",
22+
23+
"disk": 0,
24+
25+
"volume": 0,
26+
27+
"char": "Z"
28+
29+
}
30+
31+
],
32+
33+
"default": 0
34+
35+
}
36+
37+
```
38+
39+
`configs` is an array that contains all sub-configs, which you can choose in a combobox later. Every object includes `name`, `disk`, `volume` and `char` four keys, their function listed below:
40+
41+
| key | value | description |
42+
43+
| --- | --- | --- |
44+
45+
| name | string | the sub-config's name, used in UI |
46+
47+
| disk | int | the disk index [How can I find it](#About disk & volume index) |
48+
49+
| volume | int | the volume index[How can I find it](#About disk & volume index) |
50+
51+
| char | string | the target disk letter to be assigned. You can omit this, in that case, the program will choose the smallest character available. |
52+
53+
`default` defines the default sub-config using the sub-config's index.
54+
55+
`disableWarning` is a boolen to disable warning which occur when you try to unassign disk "C" if set to `true` (not recommend).
56+
57+
### Assign & Unassign
58+
59+
Just simply click the button `Assign` or `Unassign`! The current volume state will show on top of the button.
60+
61+
### Choose sub-config
62+
63+
By choose in combox, you can switch sub-config. The current config information will show under it.
64+
65+
## Others
66+
67+
### Statement
68+
69+
Assign & Unassign sometimes cases problems if there is program using it. Be careful youself! Never unassign the system volum! **MucheXD is not responsible for any failures of your computer or the file lost.**
70+
71+
### About disk & volume index
72+
73+
Get the indexs yourself! Here are the introductions:
74+
75+
1. Run `cmd.exe` in administrator mode
76+
77+
78+
79+
2. Run commend `diskpart`
80+
81+
82+
83+
3. Run commend `list disk` and get the indexs below
84+
85+
86+
87+
4. Run commend `select disk [DISK-INDEX]` to select the disk in diskpart
88+
89+
90+
91+
5. Run commend `list volume` and get the indexs below
92+
93+
94+
95+
### Recommend Environment
96+
97+
- Windows 10 (x64) / Windows 11 (x64)
98+
99+
100+
101+
- Microsoft Visual C++ 2015-2022 Redistributable x64
102+
103+
104+
105+
### Copyright and License
106+
107+
This program uses the following compilers or support libraries
108+
109+
- Visual Studio 2022
110+
111+
112+
113+
- QT 6.5
114+
115+
116+
117+
This program is under the LGPL license.
118+
119+
For detailed license content, please refer to its corresponding official website.

0 commit comments

Comments
 (0)