More actions
(Created page with "{{#seo: |title=Wii Homebrew PC Tools (PC utilities) - GameBrew |title_mode=append |image=nusdownloaderwii.jpg |image_alt=NUS Downloader }} {{Infobox Wii Homebrews |title=NUS D...") |
No edit summary |
||
(13 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{Infobox Wii Homebrews | {{Infobox Wii Homebrews | ||
|title=NUS Downloader | |title=NUS Downloader | ||
|image= | |image=nusdownloaderwii02.png | ||
|description=Downloads and packs System Titles from Nintendo | |description=Downloads and packs System Titles from Nintendo update servers. | ||
|author=WB3000 | |author=WB3000 | ||
|lastupdated=2022/03/23 | |lastupdated=2022/03/23 | ||
|type=PC utilities | |type=PC utilities | ||
|version= | |version=1.9 Mod NUS-Fix | ||
|license=Mixed | |license=Mixed | ||
|download=https://dlhb.gamebrew.org/wiihomebrews/nusdownloaderwii.7z | |download=https://dlhb.gamebrew.org/wiihomebrews/nusdownloaderwii.7z?k33p0fil35 | ||
|website= | |website=https://wiibrew.org/wiki/NUS_Downloader | ||
|source=https:// | |source=https://github.com/WiiDatabase/nusdownloader/ | ||
}} | }} | ||
https://wiibrew.org/wiki/NUS_Downloader | NUS Downloader, or NUSD, is a PC Utility designed to allow easy access to the resources present on [https://wiibrew.org/wiki/NUS Nintendo's Update Servers]. Using this tool, you can download, pack, decrypt, and manipulate many system titles into WADs ready to install. | ||
This program requires the Microsoft .NET Framework 2.0. Source is available (GPLv3) if you desire to port it away from this prerequisite. | |||
==User guide== | |||
===Important notes=== | |||
This tool creates WAD files. If it should happen to have issues during this procedure, installing corrupt WAD files could BRICK your Wii. | |||
Do not 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. | |||
=== How to use === | |||
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 Wii|WadImport]] and [[DOP-Mii Wii|DOP-Mii]]. | |||
=== 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 === | |||
For most general titles, check out the [https://wiibrew.org/wiki/Title_database WiiBrew's 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. WiiBrew has a separate page about [https://wiibrew.org/wiki/NUS_Downloader/database database format]. | |||
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]. | |||
==Screenshots== | ==Screenshots== | ||
== | https://dlhb.gamebrew.org/wiihomebrews/nusdownloaderwii3.png | ||
== Changelog == | |||
''' v1.9 Mod NUS-Fix 2022/03/23 ''' | |||
*Switch to Wii U CDN for Wii titles since NUS is down. | |||
*Modified from the decompiled EXE with dnSpy. | |||
''' v1.9-mod 2011/06/27 ''' (by Brawl345) | |||
* 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. | |||
''' v1.9 2011/01/19 ''' | |||
*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! | |||
''' v1.5a Beta (bugfix release) 2010/07/01 ''' | |||
* Fixed crash when opening Virtual Console menu. | |||
''' v1.5 Beta 2010/06/29 ''' | |||
* 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.. | |||
''' Unofficial v1.4 (still beta) 2010/04/16 ''' | |||
* 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. | |||
''' v1.3 Beta 2009/10/06 ''' | |||
* 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 2009/08/01 ''' | |||
* 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 2009/05/17 ''' | |||
* Prevented users from entering nothing... | |||
* A few little tweaks (About text, etc.) | |||
''' v1.1 2009/05/16 ''' | |||
* 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 2009/04/05 ''' | |||
* Initial release. | |||
* Supports downloading and packing to WAD. | |||
* Wii/DSi support. | |||
== 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. | |||
==External Links== | |||
* GitHub - https://github.com/WiiDatabase/nusdownloader/ | |||
* Google Code - https://code.google.com/archive/p/nusdownloader/ | |||
* WiiBrew - https://wiibrew.org/wiki/NUS_Downloader |
Latest revision as of 13:04, 6 July 2024
NUS Downloader | |
---|---|
General | |
Author | WB3000 |
Type | PC utilities |
Version | 1.9 Mod NUS-Fix |
License | Mixed |
Last Updated | 2022/03/23 |
Links | |
Download | |
Website | |
Source | |
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, decrypt, and manipulate many system titles into WADs ready to install.
This program requires the Microsoft .NET Framework 2.0. Source is available (GPLv3) if you desire to port it away from this prerequisite.
User guide
Important notes
This tool creates WAD files. If it should happen to have issues during this procedure, installing corrupt WAD files could BRICK your Wii.
Do not 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.
How to use
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
- 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
For most general titles, check out the WiiBrew's 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. WiiBrew has a separate page about database format.
For DSi Users: Versions 1/9 and later support a dsidatabase.xml, which can be found on DSiBrew.
Screenshots
Changelog
v1.9 Mod NUS-Fix 2022/03/23
- Switch to Wii U CDN for Wii titles since NUS is down.
- Modified from the decompiled EXE with dnSpy.
v1.9-mod 2011/06/27 (by Brawl345)
- 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.
v1.9 2011/01/19
- 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!
v1.5a Beta (bugfix release) 2010/07/01
- Fixed crash when opening Virtual Console menu.
v1.5 Beta 2010/06/29
- 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..
Unofficial v1.4 (still beta) 2010/04/16
- 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.
v1.3 Beta 2009/10/06
- 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 2009/08/01
- 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 2009/05/17
- Prevented users from entering nothing...
- A few little tweaks (About text, etc.)
v1.1 2009/05/16
- 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 2009/04/05
- Initial release.
- Supports downloading and packing to WAD.
- Wii/DSi support.
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.
External Links
- GitHub - https://github.com/WiiDatabase/nusdownloader/
- Google Code - https://code.google.com/archive/p/nusdownloader/
- WiiBrew - https://wiibrew.org/wiki/NUS_Downloader