User:CM360/sandbox/Wii U Creating homebrew channels: Difference between revisions

Latest revision as of 18:17, 15 October 2022

What You Need

The latest release of phacoxcll's CDecrypt fork (the CDecrypt.zip file)
- Only a Windows build is provided, Mac and Linux users may need to manually compile the source code.
The latest release of NUSPacker (direct download)
- NUSPacker requires that you have Java installed on your system to work.
An image editor that supports the .tga image format
- These instructions will use paint.net.
The MetaVerify.py script (click "Download ZIP" on the GitHub page to download)
- This script requires that you have Python 3.7.4+ installed on your system to work.
The Homebrew Launcher Channel v2.1 (direct download)
The .rpx file of whichever homebrew program you are making a channel for
The Wii U Common Key
- This is in the otp.bin file from your console's NAND dump. Extract it using this Common Key Extractor. Copy the key and save it in a text file somewhere; it will be needed later.
- If you cannot get the extractor to work, the key can also be obtained by opening otp.bin in a hex editor, and is located at offsets 0x000000E0 to 0x000000EF. If extracted correctly, it should be a 32-character long hexadecimal number starting with D7B0.

Section I - CDecrypt

Unzip the Homebrew Launcher Channel (will be referred to as the HBLC from here)
- You can rename the containing folder for organizational purposes. For these instructions, we will rename it from homebrew_launcher_channel.v2.1 to my-cool-app
Unzip CDecrypt
Create a file named keys.txt in the same directory as the CDecrypt executable, and paste the Wii U Common Key on the first line
Open a terminal and navigate to the location of the CDecrypt executable
Use CDecrypt to decrypt the contents of the HBLC
- For example, if you have the contents of the HBLC in a folder named my-cool-app, the command would be something like: CDecrypt "/path/to/my-cool-app/" "/path/to/my-cool-app/"
- The folder with the HBLC's contents should now contain three new folders: code, content, and meta. Delete everything in this directory except these three folders
- PLACEHOLDER FOR WHAT TO DO IF COMMON KEY IS WRONG

Section II - Editing code files

Section III - Editing meta files

Section IV - NUSPacker

Open a terminal and navigate to the location of NUSPacker.jar
Use NUSPacker to rebuild
- For example, if the directory of your edited HBLC is my-cool-app, the command would be something like: java -jar NUSPacker.jar -in "/path/to/my-cool-app/" -out "/path/to/my-cool-app/" -encryptKeyWith XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX (replace the XXXX... with the Wii U Common Key)

@@ Line 16: / Line 16: @@
 == Section I - CDecrypt ==
 # Unzip the Homebrew Launcher Channel (will be referred to as the HBLC from here)
+#* You can rename the containing folder for organizational purposes. For these instructions, we will rename it from <code>homebrew_launcher_channel.v2.1</code> to <code>my-cool-app</code>
 # Unzip CDecrypt
 # Create a file named <code>keys.txt</code> in the same directory as the CDecrypt executable, and paste the Wii U Common Key on the first line
 # Open a terminal and navigate to the location of the CDecrypt executable
 # Use CDecrypt to decrypt the contents of the HBLC
-#* For example, if you unzipped the HBLC to a folder named <code>homebrew_launcher_channel.v2.1</code>, the command would be something like: <code>CDecrypt "/path/to/homebrew_launcher_channel.v2.1" "/path/to/homebrew_launcher_channel.v2.1"</code>
+#* For example, if you have the contents of the HBLC in a folder named <code>my-cool-app</code>, the command would be something like: <code>CDecrypt "/path/to/my-cool-app/" "/path/to/my-cool-app/"</code>
-#* The folder you unzipped the HBLC into originally should now contain three new folders: <code>code</code>, <code>content</code>, and <code>meta</code>. Delete everything in the HBLC's directory <strong>except</strong> these three folders
+#* The folder with the HBLC's contents should now contain three new folders: <code>code</code>, <code>content</code>, and <code>meta</code>. Delete everything in this directory <strong>except</strong> these three folders
+#* PLACEHOLDER FOR WHAT TO DO IF COMMON KEY IS WRONG
 == Section II - Editing code files ==
@@ Line 28: / Line 30: @@
 == Section IV - NUSPacker ==
+# Open a terminal and navigate to the location of <code>NUSPacker.jar</code>
+# Use NUSPacker to rebuild
+#* For example, if the directory of your edited HBLC is <code>my-cool-app</code>, the command would be something like: <code>java -jar NUSPacker.jar -in "/path/to/my-cool-app/" -out "/path/to/my-cool-app/" -encryptKeyWith XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX</code> (replace the XXXX... with the Wii U Common Key)