Unpin Nutika from v2.3.11, since the 2.4.1 hotfix fixed sys.argv

New command uses its own subcommands. Currently only offers "title", which supports downloading a WAD using --wad or downloading to a folder using --output. More subcommands will be added.
Verbose output is also the default now and --verbose has been removed.

.github/workflows/python-build.yaml

@@ -31,7 +31,7 @@ jobs:
         pip install -r requirements.txt
     - name: Build Application
       run: |
-        nuitka3 --show-progress --assume-yes-for-downloads --onefile wiipy.py
+        python -m nuitka --show-progress --assume-yes-for-downloads --onefile wiipy.py
     - name: Prepare Package for Upload
       run: |
         mv wiipy.bin ~/wiipy
@@ -59,7 +59,7 @@ jobs:
           pip install -r requirements.txt
       - name: Build Application
         run: |
-          nuitka3 --show-progress --assume-yes-for-downloads --onefile wiipy.py
+          python -m nuitka --show-progress --assume-yes-for-downloads --onefile wiipy.py
       - name: Prepare Package for Upload
         run: |
           mv wiipy.bin ~/wiipy
@@ -89,7 +89,7 @@ jobs:
         pip install -r requirements.txt
     - name: Build Application
       run: |
-        nuitka --show-progress --assume-yes-for-downloads --onefile wiipy.py
+        python -m nuitka --show-progress --assume-yes-for-downloads --onefile wiipy.py
     - name: Upload Application
       uses: actions/upload-artifact@v4.3.0
       with:

modules/nus.py

@@ -1,22 +1,23 @@
 # "nus.py" from WiiPy by NinjaCheetah
 # https://github.com/NinjaCheetah/WiiPy
 
+import os
+import hashlib
 import pathlib
+import binascii
 import libWiiPy
 
 
-def handle_nus(args):
+def handle_nus_title(args):
     title_version = None
-    file_path = None
+    wad_file = None
+    output_dir = None
+    can_decrypt = False
     tid = args.tid
     if args.wii:
-        use_wiiu_servers = False
+        wiiu_nus_enabled = False
     else:
-        use_wiiu_servers = True
+        wiiu_nus_enabled = True
-    if args.verbose:
-        verbose = True
-    else:
-        verbose = False
 
     # Check if --version was passed, because it'll be None if it wasn't.
     if args.version is not None:
@@ -26,70 +27,199 @@ def handle_nus(args):
             print("Enter a valid integer for the Title Version.")
             return
 
-    # If --output was passed, then save the file to the specified path (as long as it's valid).
+    # If --wad was passed, check to make sure the path is okay.
+    if args.wad is not None:
+        wad_file = pathlib.Path(args.wad)
+        if wad_file.suffix != ".wad":
+            wad_file = wad_file.with_suffix(".wad")
+
+    # If --output was passed, make sure the directory either doesn't exist or is empty.
     if args.output is not None:
-        file_path = pathlib.Path(args.output)
+        output_dir = pathlib.Path(args.output)
-        if not file_path.parent.exists() or not file_path.parent.is_dir():
+        if output_dir.exists():
-            print("The specified output path does not exist!")
+            if output_dir.is_dir() and next(os.scandir(output_dir), None):
-            return
+                raise ValueError("Output folder is not empty!")
-        if file_path.suffix != ".wad":
+            elif output_dir.is_file():
-            file_path = file_path.with_suffix(".wad")
+                raise ValueError("A file already exists with the provided directory name!")
+        else:
+            os.mkdir(output_dir)
 
     # Download the title from the NUS. This is done "manually" (as opposed to using download_title()) so that we can
-    # provide verbose output if desired.
+    # provide verbose output.
     title = libWiiPy.title.Title()
 
     # Announce the title being downloaded, and the version if applicable.
-    if verbose:
     if title_version is not None:
         print("Downloading title " + tid + " v" + str(title_version) + ", please wait...")
     else:
         print("Downloading title " + tid + " vLatest, please wait...")
-
-    # Download a specific TMD version if a version was specified, otherwise just download the latest TMD.
-    if verbose:
     print(" - Downloading and parsing TMD...")
+    # Download a specific TMD version if a version was specified, otherwise just download the latest TMD.
     if title_version is not None:
-        title.load_tmd(libWiiPy.title.download_tmd(tid, title_version, wiiu_endpoint=use_wiiu_servers))
+        title.load_tmd(libWiiPy.title.download_tmd(tid, title_version, wiiu_endpoint=wiiu_nus_enabled))
     else:
-        title.load_tmd(libWiiPy.title.download_tmd(tid, wiiu_endpoint=use_wiiu_servers))
+        title.load_tmd(libWiiPy.title.download_tmd(tid, wiiu_endpoint=wiiu_nus_enabled))
+        title_version = title.tmd.title_version
+    # Write out the TMD to a file.
+    if output_dir is not None:
+        tmd_out = open(output_dir.joinpath("tmd." + str(title_version)), "wb")
+        tmd_out.write(title.tmd.dump())
+        tmd_out.close()
 
-    # Download and parse the Ticket.
+    # Download the ticket, if we can.
-    if verbose:
     print(" - Downloading and parsing Ticket...")
     try:
-        title.load_ticket(libWiiPy.title.download_ticket(tid, wiiu_endpoint=use_wiiu_servers))
+        title.load_ticket(libWiiPy.title.download_ticket(tid, wiiu_endpoint=wiiu_nus_enabled))
+        can_decrypt = True
+        if output_dir is not None:
+            ticket_out = open(output_dir.joinpath("tik"), "wb")
+            ticket_out.write(title.ticket.dump())
+            ticket_out.close()
     except ValueError:
-        # If libWiiPy returns an error, then no ticket is available, so we can't continue.
+        # If libWiiPy returns an error, then no ticket is available. Log this, and disable options requiring a
-        print("No Ticket is available for this title! Exiting...")
+        # ticket so that they aren't attempted later.
+        print("  - No Ticket is available!")
+        if wad_file is not None and output_dir is None:
+            print("--wad was passed, but this title cannot be packed into a WAD!")
             return
 
     # Load the content records from the TMD, and begin iterating over the records.
     title.load_content_records()
     content_list = []
     for content in range(len(title.tmd.content_records)):
-        if verbose:
+        # Generate the content file name by converting the Content ID to hex and then removing the 0x.
+        content_file_name = hex(title.tmd.content_records[content].content_id)[2:]
+        while len(content_file_name) < 8:
+            content_file_name = "0" + content_file_name
         print(" - Downloading content " + str(content + 1) + " of " +
               str(len(title.tmd.content_records)) + " (Content ID: " +
               str(title.tmd.content_records[content].content_id) + ", Size: " +
               str(title.tmd.content_records[content].content_size) + " bytes)...")
         content_list.append(libWiiPy.title.download_content(tid, title.tmd.content_records[content].content_id,
-                                                            wiiu_endpoint=use_wiiu_servers))
+                                                            wiiu_endpoint=wiiu_nus_enabled))
-        if verbose:
         print("   - Done!")
+        # If we're supposed to be outputting to a folder, then write these files out.
+        if output_dir is not None:
+            enc_content_out = open(output_dir.joinpath(content_file_name), "wb")
+            enc_content_out.write(content_list[content])
+            enc_content_out.close()
     title.content.content_list = content_list
 
+    # Try to decrypt the contents for this title if a ticket was available.
+    if output_dir is not None:
+        if can_decrypt is True:
+            for content in range(len(title.tmd.content_records)):
+                print(" - Decrypting content " + str(content + 1) + " of " + str(len(title.tmd.content_records)) +
+                      " (Content ID: " + str(title.tmd.content_records[content].content_id) + ")...")
+                dec_content = title.get_content_by_index(content)
+                content_file_name = hex(title.tmd.content_records[content].content_id)[2:]
+                while len(content_file_name) < 8:
+                    content_file_name = "0" + content_file_name
+                content_file_name = content_file_name + ".app"
+                dec_content_out = open(output_dir.joinpath(content_file_name), "wb")
+                dec_content_out.write(dec_content)
+                dec_content_out.close()
+        else:
+            print("Title has no Ticket, so content will not be decrypted!")
+
+    # If --wad was passed, pack a WAD and output that.
+    if wad_file is not None:
         # Get the WAD certificate chain.
-    if verbose:
         print(" - Building certificate...")
-    title.wad.set_cert_data(libWiiPy.title.download_cert(wiiu_endpoint=use_wiiu_servers))
+        title.wad.set_cert_data(libWiiPy.title.download_cert(wiiu_endpoint=wiiu_nus_enabled))
-
+        # Ensure that the path ends in .wad, and add that if it doesn't.
-    # If we haven't gotten a name yet, make one from the TID and version.
+        print("Packing WAD...")
-    if file_path is None:
+        if wad_file.suffix != ".wad":
-        file_path = pathlib.Path(args.tid + "-v" + str(title.tmd.title_version) + ".wad")
+            wad_file = wad_file.with_suffix(".wad")
-
+        # Have libWiiPy dump the WAD, and write that data out.
-    wad_file = open(file_path, "wb")
+        file = open(wad_file, "wb")
-    wad_file.write(title.dump_wad())
+        file.write(title.dump_wad())
-    wad_file.close()
+        file.close()
 
     print("Downloaded title with Title ID \"" + args.tid + "\"!")
+
+
+def handle_nus_content(args):
+    tid = args.tid
+    cid = args.cid
+    version = args.version
+    out = args.output
+    if args.decrypt:
+        decrypt_content = True
+    else:
+        decrypt_content = False
+
+    # Only accepting the 000000xx format because it's the one that would be most commonly known, rather than using the
+    # actual integer that the hex Content ID translates to.
+    try:
+        content_id = int.from_bytes(binascii.unhexlify(cid))
+    except binascii.Error:
+        print("Invalid Content ID! Content ID must be in format \"000000xx\"!")
+        return
+
+    # Use the supplied output path if one was specified, otherwise generate one using the Content ID.
+    if out is None:
+        content_file_name = hex(content_id)[2:]
+        while len(content_file_name) < 8:
+            content_file_name = "0" + content_file_name
+        output_path = pathlib.Path(content_file_name)
+    else:
+        output_path = pathlib.Path(out)
+
+    # Try to download the content, and catch the ValueError libWiiPy will throw if it can't be found.
+    print("Downloading content with Content ID " + cid + "...")
+    try:
+        content_data = libWiiPy.title.download_content(tid, content_id)
+    except ValueError:
+        print("The Title ID or Content ID you specified could not be found!")
+        return
+
+    if decrypt_content is True:
+        # Ensure that a version was supplied, because we need the matching TMD for decryption to work.
+        if version is None:
+            print("You must specify the version that the requested content belongs to for decryption!")
+            return
+
+        output_path = output_path.with_suffix(".app")
+        tmd = libWiiPy.title.TMD()
+        tmd.load(libWiiPy.title.download_tmd(tid, version))
+        # Try to get a Ticket for the title, if a common one is available.
+        try:
+            ticket = libWiiPy.title.Ticket()
+            ticket.load(libWiiPy.title.download_ticket(tid, wiiu_endpoint=True))
+        except ValueError:
+            print("No Ticket is available! Content cannot be decrypted!")
+            return
+
+        content_hash = 'gggggggggggggggggggggggggggggggggggggggg'
+        content_size = 0
+        content_index = 0
+        for record in tmd.content_records:
+            if record.content_id == content_id:
+                content_hash = record.content_hash.decode()
+                content_size = record.content_size
+                content_index = record.index
+
+        # If the default hash never changed, then a content record matching the downloaded content couldn't be found,
+        # which most likely means that the wrong version was specified.
+        if content_hash == 'gggggggggggggggggggggggggggggggggggggggg':
+            print("Content was not found in the TMD from the specified version! Content cannot be decrypted!")
+            return
+
+        # Manually decrypt the content and verify its hash, which is what libWiiPy's get_content() methods do. We just
+        # can't really use that here because that require setting up a lot more of the title than is necessary.
+        content_dec = libWiiPy.title.decrypt_content(content_data, ticket.get_title_key(), content_index, content_size)
+        content_dec_hash = hashlib.sha1(content_dec).hexdigest()
+        if content_hash != content_dec_hash:
+            raise ValueError("The decrypted content provided does not match the record at the provided index. \n"
+                             "Expected hash is: {}\n".format(content_hash) +
+                             "Actual hash is: {}".format(content_dec_hash))
+        file = open(output_path, "wb")
+        file.write(content_dec)
+        file.close()
+    else:
+        file = open(output_path, "wb")
+        file.write(content_data)
+        file.close()
+
+    print("Downloaded content with Content ID \"" + cid + "\"!")

modules/wad.py

@@ -3,6 +3,7 @@
 
 import os
 import pathlib
+import hashlib
 import binascii
 import libWiiPy
 
@@ -70,10 +71,9 @@ def handle_wad(args):
             # Method to ensure that the title's content records match between the TMD() and ContentRegion() objects.
             title.load_content_records()
 
-            # Nullify TMD/Ticket signatures here if the argument was passed.
+            # Fakesign the TMD and Ticket using the trucha bug, if enabled. This is built-in in libWiiPy v0.4.1+.
-            if args.null_sigs:
+            if args.fakesign:
-                title.tmd.signature = b'\x00' * 256
+                title.fakesign()
-                title.ticket.signature = b'\x00' * 256
 
             # Iterate over every file in the content_files list, and attempt to load it into the Title().
             for index in range(len(title.content.content_records)):
@@ -100,7 +100,7 @@ def handle_wad(args):
             if output_path.is_dir() and next(os.scandir(output_path), None):
                 raise ValueError("Output folder is not empty!")
             elif output_path.is_file():
-                raise ValueError("A file already exists with the provided name!")
+                raise ValueError("A file already exists with the provided directory name!")
         else:
             os.mkdir(output_path)
 

wiipy.py

@@ -14,7 +14,7 @@ if __name__ == "__main__":
     parser = argparse.ArgumentParser(
         description="WiiPy is a simple command line tool to manage file formats used by the Wii.")
     parser.add_argument("--version", action="version",
-                        version=f"WiiPy v1.1.0, based on libWiiPy v{version('libWiiPy')} (from branch \'main\')")
+                        version=f"WiiPy v1.2.1, based on libWiiPy v{version('libWiiPy')} (from branch \'main\')")
     subparsers = parser.add_subparsers(dest="subcommand", required=True)
 
     # Argument parser for the WAD subcommand.
@@ -26,21 +26,40 @@ if __name__ == "__main__":
     wad_group.add_argument("-u", "--unpack", help="unpack a WAD file to a directory", action="store_true")
     wad_parser.add_argument("input", metavar="IN", type=str, help="input file")
     wad_parser.add_argument("output", metavar="OUT", type=str, help="output file")
-    wad_parser.add_argument("--null-sigs", help="nullify signatures in the TMD and Ticket (packing only)",
+    wad_parser.add_argument("--fakesign", help="fakesign the TMD and Ticket (trucha bug)",
                             action="store_true")
 
     # Argument parser for the NUS subcommand.
-    nus_parser = subparsers.add_parser("nus", help="download a title from the NUS",
+    nus_parser = subparsers.add_parser("nus", help="download data from the NUS",
+                                       description="download from the NUS")
+    nus_subparsers = nus_parser.add_subparsers(dest="subcommand", required=True)
+    # Title NUS subcommand.
+    nus_title_parser = nus_subparsers.add_parser("title", help="download a title from the NUS",
                                                  description="download a title from the NUS")
-    nus_parser.set_defaults(func=handle_nus)
+    nus_title_parser.set_defaults(func=handle_nus_title)
-    nus_parser.add_argument("tid", metavar="TID", type=str, help="Title ID to download")
+    nus_title_parser.add_argument("tid", metavar="TID", type=str, help="Title ID to download")
-    nus_parser.add_argument("-v", "--version", metavar="VERSION", type=int,
+    nus_title_parser.add_argument("-v", "--version", metavar="VERSION", type=int,
                                   help="version to download (optional)")
-    nus_parser.add_argument("-o", "--output", metavar="OUT", type=str, help="output file (optional)")
+    nus_title_out_group_label = nus_title_parser.add_argument_group(title="output types (required)")
-    nus_parser.add_argument("--verbose", help="output more information about the current download",
+    nus_title_out_group = nus_title_out_group_label.add_mutually_exclusive_group(required=True)
-                            action="store_true")
+    nus_title_out_group.add_argument("-o", "--output", metavar="OUT", type=str,
-    nus_parser.add_argument("-w", "--wii", help="use original Wii NUS instead of the Wii U servers",
+                                     help="download the title to a folder")
+    nus_title_out_group.add_argument("-w", "--wad", metavar="WAD", type=str,
+                                     help="pack a wad with the provided name")
+    nus_title_parser.add_argument("--wii", help="use original Wii NUS instead of the Wii U servers",
                                   action="store_true")
+    # Content NUS subcommand.
+    nus_content_parser = nus_subparsers.add_parser("content", help="download a specific content from the NUS",
+                                                   description="download a specific content from the NUS")
+    nus_content_parser.set_defaults(func=handle_nus_content)
+    nus_content_parser.add_argument("tid", metavar="TID", type=str, help="Title ID the content belongs to")
+    nus_content_parser.add_argument("cid", metavar="CID", type=str,
+                                    help="Content ID to download (in \"000000xx\" format)")
+    nus_content_parser.add_argument("-v", "--version", metavar="VERSION", type=int,
+                                    help="version this content belongs to (required for decryption)")
+    nus_content_parser.add_argument("-o", "--output", metavar="OUT", type=str,
+                                    help="path to download the content to (optional)")
+    nus_content_parser.add_argument("-d", "--decrypt", action="store_true", help="decrypt this content")
 
     # Argument parser for the U8 subcommand.
     u8_parser = subparsers.add_parser("u8", help="pack/unpack a U8 archive",