More actions
| JWUDTool | |
|---|---|
 | |
| General | |
| Author | Maschell |
| Type | Utilities |
| Version | 0.4 |
| License | Mixed |
| Last Updated | 2020/12/20 |
| Links | |
| Download | |
| Website | |
| Source | |
A simple WiiU disc image tool that converts or extracts WUD and WUX content.
Developed using the JNUSLib (Java NUS Library).
Features
- Compressing .wud and splitted wud files into .wux.
- Decompressing a .wux back to .wud.
- Extracting titles from the GI or GM partition.
- Extracting .app/-h3/.tmd/.cert/.tik files from a .wud/.wux or splitted .wud.
- Extracting just the contents/hashes/ticket.
- Decrypting the full partitions from a .wud/.wux or splitted .wud.
- Decrypting specific files any partition from a .wud/.wux or splitted .wud0.
- Verify a image / Compare two images (for example a .wud with .wux to make sure its legit).
User guide
How to use
Requirement: Java 8.
Optional:
- Copy the common.key into the folder next to the .jar or provide the key via the command line.
- Copy the game.key into the folder next to the wud image or provide the key via the command line.
usage:
-commonkey <WiiU common key> Optional. HexString. Will be used if no "common.key" in the
folder of this .jar is found
-dev Required when using discs without a titlekey.
-compress Compresses the input to a .wux file.
-decompress Decompresses the input to a .wud file.
-decrypt Decrypts full the game partition of the given wud.
-decryptFile <regular expression> Decrypts files of the game partition that match the regular
expression of the given wud.
-extract <all|content|ticket|hashes> Extracts files from the game partition of the given wud
(Arguments optional)
-help shows this text
-in <input file> Input file. Can be a .wux, .wud or a game_part1.wud
-noVerify Disables verification after (de)compressing
-out <output path> The path where the result will be saved
-overwrite Optional. Overwrites existing files
-titleKey <WUD title key> Optional. HexString. Will be used if no "game.key" in the
folder of the wud image is found
-verify <wudimage1|wudimage2> Compares two WUD images to find differences
Examples
Getting .app files from an Wii U Image
Extract .app etc. from a WUD:
Get .app files from "game.wud" to the folder "extracted" with game.key in the same folder
java -jar JWUDTool.jar -in "game.wud" -out "extracted" -extract all
Extract .app etc. from a WUX (compressed WUD):
Get .app files from "game.wux" to the folder "extracted" with game.key in the same folder
java -jar JWUDTool.jar -in "game.wux" -out "extracted" -extract all
Extract .app etc. from a splitted WUD (dump with wudump):
Get .app files from "game_part1.wud" to the folder "extracted" with game.key in the same folder
java -jar JWUDTool.jar -in "game_part1.wud" -out "extracted" -extract all
Compressing into .wux
Compress a .wud to .wux:
Compress a "game.wud" to "game.wux"
java -jar JWUDTool.jar -in "game.wud" -compress
Compress a splitted game_part1.wud to .wux:
Compress a "game_part1.wud" from a wudump dump to "game.wux"
java -jar JWUDTool.jar -in "game_part1.wud" -compress
Decryption game files
Decrypt a WUD image to game files:
Input can be a .wud, game_part1.wud or a .wux. This decrypted the full game partition. Given a game.key and common.key in the same folder.
java -jar JWUDTool.jar -in "game.wud" -decrypt //WUD java -jar JWUDTool.jar -in "game.wux" -decrypt //WUX java -jar JWUDTool.jar -in "game_part1.wud" -decrypt //game_part1
Decrypt a single file from an WUD:
Input can be a .wud, game_part1.wud or a .wux. This decrypted the full game partition. Given a game.key and common.key in the same folder.
Extracting the code/app.xml file:
java -jar JWUDTool.jar -in "game.wud" -decryptFile /code/app.xml java -jar JWUDTool.jar -in "game.wux" -decryptFile /code/app.xml java -jar JWUDTool.jar -in "game_part1.wud" -decryptFile /code/app.xml
Extracting all .bfstm files:
java -jar JWUDTool.jar -in "game.wud" -decryptFile /.*.bfstm java -jar JWUDTool.jar -in "game.wux" -decryptFile /.*.bfstm java -jar JWUDTool.jar -in "game_part1.wud" -decryptFile /.*.bfstm
Extracting the folder /content/Sound:
java -jar JWUDTool.jar -in "game.wud" -decryptFile /content/Sound/.* java -jar JWUDTool.jar -in "game.wux" -decryptFile /content/Sound/.* java -jar JWUDTool.jar -in "game_part1.wud" -decryptFile /content/Sound/.*
Media
[Wii U] Dumping, Extracting & Repacking Wii U Disc Games [wudump, JWUDTool & NUSPacker Tutorial] (BullyWiiPlaza)
Changelog
v0.4 2020/12/20
- Update to use the latest JNUSLIB version.
v0.3 2019/04/27
Update to use the latest JNUSLIB version.
- Fix FST parsing on some titles.
- Add support for decrypting all partitions.
v0.2a 2019/02/12
Update to use the latest JNUSLIB version.
- Fixes for filepath on wud parsing for unix system.
- Add warnings when files couldn't be found.
- Ignore cases in filenames.
v0.2 2018/12/07
- Added support for multiple GM partitions.
- Added support to handle titles from the GI partition (For games that ships with an game update or DLC).
- Added support for handling kiosk discs. Bring you right common key and use the
-devflag. - It's now possible to convert a .wux back to .wud (
-decompress). - Using the latest JNUSLib - this fixes serveral bugs.
Credits
Maschell.
Thanks to:
- Crediar for CDecrypt (https://github.com/crediar/cdecrypt).
- All people who have contributed to vgmtoolbox (https://sourceforge.net/projects/vgmtoolbox/).
- Exzap for the .wux file format (https://gbatemp.net/threads/wii-u-image-wud-compression-tool.397901/).
- FIX94 for wudump (https://gbatemp.net/threads/wudump-dump-raw-images-from-a-wiiu-game-disc.451736/).
- The creators of lombok for lombok https://projectlombok.org/index.html.