You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+32-8Lines changed: 32 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ If you have an Xbox One development kit or GamingServices framework (Windows10-e
15
15
Also included is a tool for extracting files from the XBFS (Xbox Boot File System) inside the Xbox One NAND, based on tuxuser's original [NANDOne](https://github.com/tuxuser/NANDOne) work with a few small additions.
16
16
Thanks Kebob for providing [OpenXvd](https://github.com/Kebob/OpenXvd).
17
17
18
-
###Usage
18
+
## Usage
19
19
```
20
20
Usage : xvdtool.exe [parameters] [filename]
21
21
@@ -74,7 +74,7 @@ Decrypting XVC packages is a different matter, XVC packages use a **Content Inst
74
74
75
75
Devkit/test-signed XVC packages use a static CIK which is also "widely known" (Hash provided below).
76
76
77
-
###Required Files
77
+
## Required Files
78
78
To make full use of this tool you'll need the following files, which **are not included**. The tool will work fine without them, but some functions might not work.
79
79
80
80
You can use the included tool "DurangoKeyExtractor" to extract these keys from the Microsoft.GamingServices framework available on Windows 10.
@@ -108,12 +108,12 @@ To chose a specific key use the following cmdline switches:
108
108
-cik (-cikguid) <GUID> - Guid of Content Instance key to use
109
109
```
110
110
111
-
####Mounting XVDs
111
+
### Mounting XVDs
112
112
113
113
For mounting of XVD/XVC files, you require DLLs from [GamingServices](https://www.microsoft.com/en-us/p/gaming-services/9mwpm2cqnlhn?activetab=pivot:overviewtab) component.
114
114
Download & install it via the Microsoft Store and you should be good to go.
115
115
116
-
###Possible locations to store keys
116
+
## Possible locations to store keys
117
117
XVDTool will create configuration/keys folders on first start - Global and local to the app.
118
118
119
119
Global configuration folder:
@@ -131,23 +131,47 @@ Inside these folders you can can store your keys to be autoloaded.
131
131
132
132
Additionally, you can provide keys from arbitrary filesystem locations via the respective cmdline switches: `-signfile, -odkfile, -cikfile`
133
133
134
-
####Naming the keys
134
+
### Naming the keys
135
135
For CIK it is not important how the keys are named if they have the binary structure of `[16 byte encryption key GUID][32 byte CIK]`.
136
136
XVD signing keys should have a distinct identifier so you can refer to them via the `-sk (-signkey)` cmdline switch.
137
137
ODK needs to be named either by OdkIndex (`<index>.odk`) or by its identifier: `RedOdk.odk, StandardOdk.odk etc.`
138
138
For detailed up-to-date info refer to: `LibXboxOne/Keys/`
139
139
140
-
###What are XVDs?
140
+
## What are XVDs?
141
141
XVD packages are a secured file format used by the Xbox One to store data, an analogue to the Xbox 360's STFS packages. XVD files are usually used to store system images/data while XVCs (a slightly modified variant of XVDs) are used to store game data.
142
142
143
143
For a more detailed explanation of XVD files see xvd_info.md
-[.NET 7.0 SDK](https://dotnet.microsoft.com/en-us/download/dotnet/7.0) - Choose Installer x64 for ease of use
155
+
156
+
### Building
157
+
158
+
- After installing the SDK, open up a new powershell window
159
+
- Clone the repository
160
+
```
161
+
git clone https://github.com/emoose/xvdtool
162
+
```
163
+
- Navigate into the directory
164
+
```
165
+
cd xvdtool
166
+
```
167
+
- Build
168
+
```
169
+
dotnet build -c Release
170
+
```
171
+
172
+
NOTE: If you want to build as DEBUG, either omit `-c Release` or supply `-c Debug` instead.
173
+
174
+
## Help / Support
151
175
xvdtool has been tested on Windows and MacOS but it should work on all systems supported by .NET Core.
152
176
153
177
There's no help given for this tool besides this readme, it's also currently **very** experimental and **very** likely to blow up in your face. If you do encounter any bugs please submit a description of what happened to the issue tracker.
0 commit comments