JWUDTool Wii U

From GameBrew
Revision as of 01:54, 4 May 2024 by HydeWing (talk | contribs) (Created page with "{{Infobox WiiU Homebrews |title=JWUDTool |image=jwudtoolwiiu.png |description=WiiU disc image tool that converts or extracts WUD and WUX content. |author=Maschell |lastupdated=2020/12/20 |format=jar |type=Utilities |version=0.4 |license=Mixed |download=https://dlhb.gamebrew.org/wiiuhomebrews/jwudtoolwiiu.7z |website=https://gbatemp.net/threads/453078/ |source=https://github.com/Maschell/JWUDTool |donation= }} <!--bin: github--> <!--date: g...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
JWUDTool
File:Jwudtoolwiiu.png
General
AuthorMaschell
TypeUtilities
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

Retrieved from ‘https://www.gamebrew.org/index.php?title=JWUDTool_Wii_U&oldid=148993’

Advertising: