75
edits
Changes
→v1.9-mod - June 27th, 2011: Correct wrong date, add author and fix changelog
Line 3:
Line 3:
'''NUS Downloader''', or '''NUSD''', is a PC Utility 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.+[[Image:nusdv12.png|thumbnail|frame|right|NUSD v1.2 in Windows.]]+==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==+This program requires the Microsoft .NET Framework 2.0. Source is included if you desire to port it away from this prerequisite.+Load the program, and enter a title ID and optionally a specific version number. Title IDs can be found in the [[Title database]] or [[IOS History]].+Check whether you wish to Pack the title into a WAD, and whether the title is for the Wii or DSi. Note that DSi titles cannot be packed into WADs (They ''could'' but it would be useless).+Check whether you wish to Decrypt the contents. This will create separate ".app" files in the same directory as the encrypted ones.+Run the download, and you should be presented with the downloaded files and optionally a packed WAD in a folder named after the title ID you chose. All folders/files are saved in the directory that the main program is in.+
−System WADs can be installed using any normal installer.
−
−
+
+
+
+==Size Differences==+After the initial release, there were concerns rising about differences in file sizes between official WADs and NUSD ones. A first, obvious difference is in that official ones have a footer, and NUSD packed ones do not. This adds a few bytes onto the official ones which will not be present.+==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 catagory+==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.<br>+Orange: No ticket is available.<br>
−Red: A notice/danger text is present in the database. These titles are usually crucial to the Wii.
−Command line arguments have been added to the program. They're not completely CLI, it's more of a GUI override. You can take (mostly) complete control over the GUI with a few command line arguments:+<source lang="text">+(Specify a Title ID to download)
−(Specify a Version to download)+(Start the download on program launch)+-s+(Close the GUI when download is complete)+(Decrypt the contents)+-d+(Ignore ticket)+-ticket
−-local+(Pack WAD)+-p WADFILENAME.WAD
−(Switch to DSi Mode)+-dsi
−</source>+==Credits==+NUSD was written entirely 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.+==Bugs & Suggestions==+Be sure to report any bugs so I can work to fix them!+Additions planned for v1.3:+* Finished trucha toolset.
−* Patching system.
−
| type = pc utility
| type = pc utility
| author = [[User:WB3000|WB3000]]
| author = [[User:WB3000|WB3000]]
−| maintainer = [[User:WB3000|WB3000]]
+| maintainer = [[User:WB3000|WB3000]] (and [[User:Lukegb|lukegb]])
−| version = v1.2
+| version = v1.9
−| download = Media:NUSDv12.zip
+| download = https://github.com/WiiDatabase/nusdownloader/releases/latest
−| website = http://wb3000.co.nr
+| website (archived) = https://web.archive.org/web/20171209155009/http://wb3000.co.nr/
| discussion = Talk:NUS_Downloader
| discussion = Talk:NUS_Downloader
−| source = http://code.google.com/p/nusdownloader/
+| source = https://code.google.com/archive/p/nusdownloader/
}}
}}
+'''NUS Downloader''', or '''NUSD''', is a Windows program designed to allow easy access to the resources present on [[NUS]]. Using this tool, you can download, pack, and decrypt many system titles into WADs ready to install.
−[[File:NUSDownloaderv19Img.png|thumbnail|frame|right|NUSD v1.9 in Windows.]]
−== 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. This program comes without warranty, and the makers of the program (and of this guide) are not responsible for any damage caused by installing a corrupt WAD or installing it incorrectly.
−== 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 [[WadImport]] and [[DOP-Mii]].
−== Protips ==
−==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.
* 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.
* 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 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.
* 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?==
+== Why\What? ==
There are several reasons to use this program.
There are several reasons to use this program.
Line 47:
Line 51:
* Obtain a specific version of a System Title (Menu 3.2U, etc.)
* Obtain a specific version of a System Title (Menu 3.2U, etc.)
* Simplification of download and packing process.
* Simplification of download and packing process.
−* Decrypt contents straight from NUS. (key.bin) needed!
+* Decrypt contents straight from NUS.
What this does NOT do:
What this does NOT do:
−* Package VC/WiiWare/Anything needing an individual ticket.
+* 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 second difference may be noticed in the Certificate Chain added to the WAD. While it may appear entirely different, it is simply ordered in a different way, and the Wii sees nothing different. V1.1 of NUSD will order the certs in the most common way, so that difference is covered.
+A lot of information is portrayed in the database icons for each title. Here's what the color codes represent:
−The only real difference is in some tickets. NUS has a variation on the ticket for a title, as do the WADs that come in discs. While they are different, the only changed values are small (ticket_id and DLC purchases). The big things like Title Key remain intact. There has been no issues using these tickets, which is understandable as many are probably on your Wii right now.
+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 [http://www.dsibrew.org/wiki/NUS_Downloader/database found on DSiBrew].
−== Credits ==
−NUSD was written by [[User:WB3000|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 [[User:Lukegb|lukegb]].
−== Bugs & Suggestions ==
−Be sure to report any bugs so I can work to fix them!
−Todo:
+* Command Line (CLI) Support
−== Update History ==
−==CLI Usage==
+=== v1.9 Mod NUS-Fix - March 23rd, 2022 ===
+Switch to Wii U CDN for Wii titles since NUS is down
−Modified from the decompiled EXE with dnSpy
−[https://github.com/WiiDatabase/nusdownloader/releases/download/v1.9-mod-nusfix/NUSD-Mod-NUS-Fix.zip Download v1.9 Mod NUS-Fix]
−-t XXXXXXXXXXXXXXXX
−=== v1.9-mod - June 27th, 2011 ===
−-v XXXX
+Mod by hamachi-mp.
−* Based on NUS r122
−* Checkbox to use the folder structure of NUSD v1.5
+* Fixed script creation on "Emulate Update"
+* Needs .NET Framework 3.5.
−[https://github.com/WiiDatabase/nusdownloader/releases/download/v1.9-mod/NUSD_mod.rar Download v1.9-mod]
−-close
−=== 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.
−(Keep local files if present)
+*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!
−[http://nusdownloader.googlecode.com/files/NUSDownloader_v19.zip Download v1.9]
−=== v1.5a Beta (bugfix release) - July 1st, 2010 ===
+* Fixed crash when opening Virtual Console menu
−[http://nusdownloader.googlecode.com/files/NUSD_v15aBeta.zip 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.
−[http://nusdownloader.googlecode.com/files/NUSD_v15Beta.zip 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.
−[http://nusdownloader.googlecode.com/files/NUSD_v14Beta.zip Download]
−==Update History==
+=== 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===
+=== v1.2 - August 1, 2009 ===
* Access a '''local database''' (database.xml) of title IDs, along with versions/regions/etc.
* 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)
* With database selection, IOS WADs are given Nintendo naming convention (ex: IOS60-64-vXXX.wad)
Line 143:
Line 179:
** Contents editor (Add/Remove Contents, Set shared status, Set boot content, Add trucha bug to content [only decrypted contents have support so far!!])
** 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===
+=== v1.1a - May 17, 2009 ===
* Prevented users from entering nothing...
* Prevented users from entering nothing...
* A few little tweaks (About text, etc.)
* A few little tweaks (About text, etc.)
−===v1.1 - May 16, 2009===
+=== v1.1 - May 16, 2009 ===
* Directories are created with the version number when known (''ex'': 0000000100000002v289)
* 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.
* 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.
Line 156:
Line 192:
* '''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)
* '''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===
+=== v1 - April 5, 2009 ===
* Initial release
* Initial release
* Supports downloading and packing to WAD
* Supports downloading and packing to WAD
* Wii/DSi support
* Wii/DSi support
−[[Category:Software]]
+== Uber-betas ==
+The latest compiled version of the software can be found on the project Subversion repository at Google Code [http://nusdownloader.googlecode.com/svn/trunk/NUS%20Downloader/Latest/NUS%20Downloader.exe 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.