NUS Downloader

From WiiBrew
Jump to: navigation, search
NUS Downloader
General
Author(s)WB3000
TypePC utility
Versionv1.9
Links
Download
Website
Discussion
Source

NUS Downloader, or NUSD, is a Windows program designed to allow easy access to the resources present on Nintendo's Update Servers. Using this tool, you can download, pack, and decrypt many system titles into WADs ready to install.

NUSD v1.9 in Windows.

Contents

WARNING!

This tool creates WAD files. If it should happen to have issues during this procedure, installing corrupt WAD files could BRICK your Wii. Don't use this program if you are not sure of what it accomplishes. No warranty provided, no responsibility on me if you brick anything!

Usage

Load the program, and enter a title ID and optionally a version number. Title IDs can be found in the Title database or IOS History.

Looking below, evaluate whether the checkboxes have the desired values.

  • Keep Encrypted Contents: Leaves the 00000000, 00000001, etc. files present. These are what make up a WAD, but are not necessary to keep if you only want a WAD.
  • Create Decrypted Contents: Uses the Wii/DSi key to create corresponding 00000000.app, 00000001.app, etc. decrypted NUS content files.
  • Pack WAD: This creates a WAD file of the desired NUS title. This is only available for Wii titles.
  • Use Local Files: This skips downloading files that appear to be present in your local title library.
  • Patch IOS: This, in conjunction with Pack WAD, patches NUS IOS titles with various exploit-enabling "features."

Press Start NUS Download, and wait for the title download to finish. When completed, you can find the downloaded/created files in \titles\titleId\version\*

System WADs can be installed using any normal homebrew installer on the Wii.

Protips

  • You cannot get free games with NUSD.
  • Title IDs are 16 characters long: no dashes/spaces/symbols.
  • Having a (Mismatch) message is OK. It relates only to the difference between TMD and actual content sizes.
  • Entering no version number will get the latest one. Remember that System Menu's have separate versions for each region, so you may not want the latest one.
  • A failure to download a TMD means either your internet is not connected or you are entering incorrect information.
  • A failure to download cetk (tickets) means that the title can still be downloaded, but not packed or decrypted.
  • This program requires the Microsoft .NET Framework 2.0 to run!

Why\What?

There are several reasons to use this program.

  • Avoid unnecessary pirating of System WADs (IOS modules, System Menus, etc.)
  • Obtain a specific version of a System Title (Menu 3.2U, etc.)
  • Simplification of download and packing process.
  • Decrypt contents straight from NUS.

What this does NOT do:

  • Package VC/WiiWare/DSiWare needing an individual ticket.
  • Decrypt WC/WiiWare/DSiWare titles (no tickets!)

Title IDs

Wiibrew has quite the collection of Title IDs for use with NUSD. For most general titles, check out the Title database. For IOS ids specifically, check out the IOS History.

New to v1.2 is a local database of title IDs in the database.xml file. To access this, simply click the database button in NUSD, and select a title based on category.

Database

The NUSD database is stored in the database.xml file, which should be placed in the same directory as the executable. It is a simple, formatted XML document. A separate page has been dedicated to the database, here you can find the latest copy as well as how to format the file.

NUS Downloader/database

A lot of information is portrayed in the database icons for each title. Here's what the color codes represent:

Green: The title has a ticket available. Orange: No ticket is available. Red: A notice/danger text is present in the database. These titles are usually crucial to the Wii.

For DSi Users: Versions 1/9 and later support a dsidatabase.xml, which can be found on DSiBrew.

Credits

NUSD was written by WB3000, but much of the code would not have been possible without the help of #WiiDev, in particular Crediar, comex, Galaxy, and SquidMan. The advice and source code provided by them made this program possible.

Releases post-v1.3 had significant contributions by lukegb.

Bugs & Suggestions

Be sure to report any bugs so I can work to fix them!

Todo:

  • Command Line (CLI) Support

Update History

v1.9 - January 19th, 2011

This build is intended to provide updated DSi features to users before the release of v2.0.

The DSi Common Key is NOT embedded into this release. Once it inevitably spreads and becomes common place, I could embed the key. Many sites do not want any trace of it, so this build respects this request.

  • Multiple GUI changes
  • DSi Decryption support fix
  • DSi Database support (dsidatabase.xml)
  • Supported by libWiiSharp framework
  • Improved local scripts support
  • New directory structure (\titles\titleid\version\*)
  • Script loading from database.xml
  • IOS Patching
  • Reads key.bin, kkey.bin, and dsikey.bin
  • WAD file SaveAs support
  • Whatever else happened in the months between...

CLI Mode did not officially make it to this build. Sorry!

Download v1.9

v1.5a Beta (bugfix release) - July 1st, 2010

  • Fixed crash when opening Virtual Console menu

Download v1.5a

v1.5 Beta - June 29th, 2010

  • Moved update database option to Extras menu, added ability to download database if none exists
  • Added ability to download common key (via HackMii blog) if does not exist
  • Added ability to accept hex STRING versions of the common key
  • Made the database reading multi-threaded, so as not to delay GUI loading.

Download v1.5

Unofficial v1.4 (still beta) - April 16, 2010

  • Some bugfixes (Linux-oriented) - lukegb (probably the only changes I'll be committing)
  • Fixes/GUI changes - WB3000

Note: this version is highly untested, and I pushed it out mostly because I wanted the Linux-related path fixes to go out.

Download

v1.3 Beta - October 6, 2009

  • Database updates via the GUI.
  • Simulated Wii Updates for each region.
  • Optimized WAD Packing code.
  • WAD File may be saved to a user-specified location.
  • You can chose to delete the contents after WAD packaging.
  • Support for NUS scripts (used by Wiimpersonator, etc.)
  • Proxy configuration and authentication (Tested by Napo7)
  • Certs collected on the fly (No more cert.sys)
  • Windows 7 taskbar support.
  • WAD naming scheme updates (Suggested by Attila)

v1.2 - August 1, 2009

  • Access a local database (database.xml) of title IDs, along with versions/regions/etc.
  • With database selection, IOS WADs are given Nintendo naming convention (ex: IOS60-64-vXXX.wad)
  • Mismatches are identified as Safe or BAD.
  • Command line arguments can be passed to the GUI.
  • Korean key (kkey.bin) support. Useless as far as I know, nothing on NUS uses the key...
  • Downloading failures are now described in more detail (401 vs 404, etc.)
  • Status Box has a clear button; it is auto-cleared when starting a new download.
  • UserAgent changed (again) to the Wii updating one.
  • A title's required IOS is shown in the download log.
  • Trucha signing titles (Still in Beta/Alpha stages! By default it is disabled, to display the feature, click the progress bar on the main form)
  • Trucha signing features the following:
    • TMD editor (Change IOS needed, title version, title ID)
    • Ticket editor (Change DLC Amount, Common Key needed, Time limit)
    • Contents editor (Add/Remove Contents, Set shared status, Set boot content, Add trucha bug to content [only decrypted contents have support so far!!])

v1.1a - May 17, 2009

  • Prevented users from entering nothing...
  • A few little tweaks (About text, etc.)

v1.1 - May 16, 2009

  • Directories are created with the version number when known (ex: 0000000100000002v289)
  • Certificates (cert.sys) no longer hard coded. You will be asked to generated the file on first boot of v1.1. This is done right from NUS.
  • Ability to alter the name of the packed WAD from the GUI.
  • Loading a TMD for info displays more information, such as what IOS a title requires.
  • Textbox output is a bit cleaner.
  • You can now choose to continue the download if a ticket (cetk) 404s. This will allow you to download the content of the titles, however you will not be able to pack them.
  • Decryption of contents now included. Needs common key (key.bin) to work! (Pro Note: DSi decryption will work with a (dskey.bin), however that doesn't exist now)

v1 - April 5, 2009

  • Initial release
  • Supports downloading and packing to WAD
  • Wii/DSi support

Uber-betas

The latest compiled version of the software can be found on the project Subversion repository at Google Code in trunk/NUS Downloader/Latest/NUS Downloader.exe - note: no support will be provided for these releases, any bugs filed should be CLEARLY tagged and many features can and will be broken.

Personal tools
Resources
Community