75
edits
Changes
→v1.9-mod - June 27th, 2011: Correct wrong date, add author and fix changelog
Line 3:
Line 3:
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.+
−
+== 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.
−
−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.
−
−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.
+
+
+
+
+
+
+
+
+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)+-v XXXX+(Start the download on program launch)+(Close the GUI when download is complete)+-close+(Decrypt the contents)+-d
−-ticket+(Keep local files if present)+-local
−(Pack WAD)+-p WADFILENAME.WAD
−-dsi+</source>+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.+Be sure to report any bugs so I can work to fix them!+Additions planned for v1.3:+
−Farther out...
−* Finished trucha toolset.
−* Patching system.
−
−== Update History ==
| 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.3 Beta
+| version = v1.9
−| download = http://www.mediafire.com/?nqjdzmzzjmk
+| 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 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.
+'''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:nusdv12.png|thumbnail|frame|right|NUSD v1.2 in Windows.]]
+[[File:NUSDownloaderv19Img.png|thumbnail|frame|right|NUSD v1.9 in Windows.]]
== WARNING! ==
== 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!
+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 ==
== 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]].
−System WADs can be installed using any normal installer.
== Protips ==
== Protips ==
* You '''cannot''' get free games with NUSD.
* 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.
−* Trucha features are very buggy, and should be used with caution.
+* This program requires the Microsoft .NET Framework 2.0 to run!
== Why\What? ==
== Why\What? ==
Line 48:
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 ==
== Title IDs ==
Line 66:
Line 62:
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]].
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
+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 ==
== Database ==
Line 76:
Line 72:
A lot of information is portrayed in the database icons for each title. Here's what the color codes represent:
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 />
+Green: The title has a ticket available.
−Orange: No ticket is available.<br />
+Orange: No ticket is available.
Red: A notice/danger text is present in the database. These titles are usually crucial to the Wii.
Red: A notice/danger text is present in the database. These titles are usually crucial to the Wii.
−== CLI Usage ==
+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 ==
+=== 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]
−=== v1.9-mod - June 27th, 2011 ===
−Mod by hamachi-mp.
−-t XXXXXXXXXXXXXXXX
−* 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]
−-s
−=== 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.
−(Ignore ticket)
+*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]
−(Switch to DSi Mode)
+=== 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]
−== Credits ==
+=== 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]
−== Bugs & Suggestions ==
+=== 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]
−=== v1.3 Beta - October 6, 2009 ===
* Database updates via the GUI.
* Database updates via the GUI.
* Simulated Wii Updates for each region.
* Simulated Wii Updates for each region.
−* Optimized WAD Packing code (OOP friendly)
+* Optimized WAD Packing code.
* WAD File may be saved to a user-specified location.
* WAD File may be saved to a user-specified location.
* You can chose to delete the contents after WAD packaging.
* You can chose to delete the contents after WAD packaging.
* Support for NUS scripts (used by Wiimpersonator, etc.)
* Support for NUS scripts (used by Wiimpersonator, etc.)
* Proxy configuration and authentication (Tested by Napo7)
* Proxy configuration and authentication (Tested by Napo7)
−* Certs collected on the fly.
+* Certs collected on the fly (No more cert.sys)
−* Windows 7 taskbar support (progressbar).
+* Windows 7 taskbar support.
−* WAD naming scheme updates (Suggested by [[User:Attila|Attila]])
+* WAD naming scheme updates (Suggested by Attila)
−=== v1.2 - August 1, 2009 ===
=== v1.2 - August 1, 2009 ===
Line 174:
Line 197:
* 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.