Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.
JWUDTool
General
AuthorMaschell
TypeFile Operation
Version0.4
LicenseMixed
Last Updated2020/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 -dev flag.
  • It's now possible to convert a .wux back to .wud (-decompress).
  • Using the latest JNUSLib - this fixes serveral bugs.

Credits

Maschell.

Thanks to:

External links

Advertising: