Homebrew NUSspli - Install content directly from the Nintendo Update Servers to your Wii U

[V10lator]

End of development​

Stopping Wii U development cause of way to many memory issues and no available memory debugger. It's just way to frustating when you code for more than 2+ years and then get bitten by such stuff. Codebase of NUSspli + all involved libraries is way to big to debug without tools like Valgrind but it seem we'll never have them availabe on the Wii U.

Hey GBATemp, the new NUSspli release was going to have a lot of changes, which made it suuuper fast and finally fixed the corrupted files issue, it’s a shame it would go to waste, so I decided to release it, here it is! PLEASE READ THE RELEASE TEXT, IT HAS INFO ON HOW TO MAKE IT WORK CORRECTLY https://github.com/Xpl0itU/NUSspli/releases

Original post:

NUSspli, the NUS simple package loader / installer.

Important note

If you have any issues try to load this from https://github.com/GaryOderNichts/homebrew_launcher/releases/tag/v2.1_fix
Thanks to @alexander1970, @AmandaRose and @yoyoyo69 for figuring this out.

There's some version on the web calling itself Freeshop. I'm not associated with Freeshop or that version in any way and while it seems all they did was exchanging tga files in the zip file I wouldn't recommend using it and you won't get any support from my end when using it.

Credits

Note that many of these guys did not work directly on NUSspli but I'm just using their work which they wrote before NUSspli was even an idea in my head. Do not contact any of these guys for support!

• cJSON - The config file and the online API is in JSON format.
• @E1ite007 for the artwork.
• libgui - For allowing easy UI design.
• @Pokes303 / WUPDownloader - For being the codebase of NUSspli.
• @QuarkTheAwesome / RetroArch - For Quarkys awesome ASAN.
• Simone Z. - Just for being that awesome human being she is.
• WUP Installer (mostly Mod Y but also all other versions) - For having figured out how to install content and possible hickups while doing so.

BETA testers

• Anonym
• @carcaschoi
• @GABO1423
• @huma_dawii
• @jacobsson
• @piratesephiroth
• @Vague Rant

Usage

I hope the tool is pretty self-explainatory but will slowly add more text to this section.

Bugs

See https://github.com/V10lator/NUSspli/issues

FAQ

Q: I'm using a version below 1.25 and am getting a red screen with a network error at startup. Why?
A: See this post.

Q: Why is the eShop downloading faster than this?
A: It isn't:

Q: So, uhm, why is this faster than the eShop?
A: I don't know the eShop codes but my guess is: While they do equal optimisations to the network and storage I/O NUSspli does refresh its GUI less often. To explain this a bit more: The eShop paints its GUI with 60 frames per second no matter what while NUSspli paints just one frame per second while downloading. Also there might be more background tasks running while the eShop downloads.

Q: ETA?
A: WEN.

Q: Who's Simone Z.?
A: Do you need to know everything? I don't think so...

Q: Why should I use this instead of [INSERT NAME OF OTHER NUS DOWNLOADING TOOL HERE] ?
A: It's up to you what to use but whenever you want to download/install something without knowing the key NUSspli is your only option.

Q: Are you breaking Nintendos copyright by using that font?
A: No. I'm just using normal API calls to get the font at runtime from the Wii Us operating system. NUSspli does not include a copy of that font!

Q: What's that background music?
A: It's the Dreamy Ambient Background Music Loop by Alexander Blu.

Q: Are you breaking @dimoks copyright by using the ASAN?
A: No. I'm just using codes written by @QuarkTheAwesome

Q: So you are breaking copyright of @QuarkTheAwesome !
A: That's no question. And no, I'm not. Quarky gave permission to relicense the codes.

Q: Why is this so much faster than WUPDownloader?
A: Optimisations everywhere.

Q: Does this contain a link to That Title Key Site?
A: No. In fact it doesn't use that title key site at all since version 1.9.

Q: How is this tool generating keys on its own?
A: It simply implements the informations given at https://gbatemp.net/threads/3ds-wii-u-titlekey-generation-algorithm-leaked.566318/

Q: Does this contain the Wii U common key, which might be a illegal number?
A: No. That key is stored on your console, so it grabs it at runtime.

Changelog

See GitHub (Source code).

Planned features

Note that this list is not setted in stone:

• Even faster downloads.
• Download to NAND.
• Install from NAND.
• A full fledged GX2 GUI.

Disclaimer

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Download

• Latest
• All

Source code

https://github.com/V10lator/NUSspli

 

[AmandaRose]

So is this is like USB download helper exept everything is done on the WiiIU??

 

[Deleted member 323844]

So, it is like pkgj (PS3/PSV) for WiiU, right?

 

[V10lator]

So is this is like USB download helper exept everything is done on the WiiIU??

This. Oh and it will install the content after downloading (but there's an option to download only, too, as well as another option to install content already on the SD or USB drive (like WUP Installer)).

//EDIT:

So, it is like pkgj (PS3/PSV) for WiiU, right?

I don't know pkgj, sry. But most likely it is what you think it is.

 

[AmandaRose]

This. Oh and it will install the content after downloading (but there's an option to download only, too, as well as another option to install content already on the SD or USB drive (like WUP Installer)).

//EDIT:

I don't know pkgj, sry. But most likely it is what you think it is.

Ah so this is pretty awesome then.

 

[depaul]

That's a great release does the tool generate a fake ticket on its own? Or from that Wii U title key site..

 

[V10lator]

That's a great release does the tool generate a fake ticket on its own? Or from that Wii U title key site..

It gets the json file containing the keys from that title key site and creates its own tickets with it. They contain a human (hex editor) and machinereadable header but I'm not at home right now, so more on this later.

//EDIT @depaul This is directly from the codes. Note that the desription is not 100% correct, for example the strings are IIRC always 64 bit, ending with \0 and padded. Also the first string is the name of the tool (in case other tools want to copy that header format):

/*
 * The header is meaned to be human (hex editor) and machine readable. The format is:
 *  - Magic 32 bit value (defined by Nintendo)
 *  - 0x00010203040506070809 As a magic value / metadata detection
 *  - 2 bit spacing
 *  - 64 bit "NUSspli\0" string
 *  - 64 bit padding
 *  - 64 bit version string ending with 0x00
 *  - 64 bit padding
 *  - Max 64 bit file type string ending with 0x00
 *  - Padding till 0x000000EE / area reserved for future use
 *  - uint8_t storing the meta version number (currently 1, so 00000001 or 0x01)
 *  - 128 + 32 random bits marking the end of the header usable area
 *  - 256 + 128 + 64 + 32 bit padding (defined by Nintendo / end of header)
 */
void writeHeader(FILE *fp, FileType type)
{
    writeCustomBytes(fp, "0x00010004000102030405060708090000"); // Magic 32 bit value + our magic value + padding
    writeCustomBytes(fp, "0x4E555373706C69"); // "NUSspli"
    writeVoidBytes(fp, 0x9);
    int vl = strlen(NUSSPLI_VERSION);
    fwrite(NUSSPLI_VERSION, vl, 1, fp);
 
    writeVoidBytes(fp, 0x10 - vl);
    char *cb;
    int v;
    switch(type)
    {
        case FILE_TYPE_TIK:
            cb = "0x5469636B6574"; // Ticket
            v = 0xB9;
            break;
        case FILE_TYPE_CERT:
            cb = "0x4365727469666963617465"; // "Certificate"
            v = 0xB4;
            break;
        default:
            cb = "00";
            v = 0xBE;
    }
 
    writeCustomBytes(fp, cb);
    writeVoidBytes(fp, v);
    writeCustomBytes(fp, "0x01"); // TODO: Don't hardcode in here
    writeRandomBytes(fp, 0x14);
    writeVoidBytes(fp, 0x3C);
}

This ticket was created by a older version, so not sure if has all the things defined above but it's prpbably close enough:

//EDIT²: You're also able to enter keys manually.

 

[depaul]

Good work I've put both title ID and title key and it worked for me. Thanks God Wii U scene is advancing again

 

[Souperman9]

So just to be clear, you could download a game onto an SD with this, and replace the fake ticket with one from that ticket site, then install it with WUP Installer?

 

[OrGoN3]

Does this stream install or download and then install? And if the latter, any plans on making it a stream install?

 

[AmandaRose]

So had a chance finally to try this out and downloaded a few games. None of them would install using the apps built in installer. I had to install them with wup installer gx2.

So can only assume there is some kinda issue going on with the apps built in installer sadly.

 

[Alexander1970]

Hello.

I think the Wii U USBHelper is much better......







THANK YOU for this awesome Tool !!!!
And of course your Work,I appreciate your Time for developing and testing,to "serve" us a near perfect and easy to use Homebrew Tool for the Wii U.

Where are now these "loud" Voices - "Wii U and their Homebrew Scene is dead....".

Thank you very much,my Friend.

 

[V10lator]

So can only assume there is some kinda issue going on with the apps built in installer sadly.

Sad to hear this. Could you tell me some of the title IDs you're trying to install, please?

//EDIT:

So just to be clear, you could download a game onto an SD with this, and replace the fake ticket with one from that ticket site

Yes.

then install it with WUP Installer?

No need for WUP Installer. Well, except for that bug @AmandaRose experiences.

Does this stream install or download and then install? And if the latter, any plans on making it a stream install?

The latter. Currenty streamed installations aren't planned, sorry.

//EDIT²: @AmandaRose Also what's the error message you're getting?

 

[AmandaRose]

Sad to hear this. Could you tell me some of the title IDs you're trying to install, please?

@AmandaRose Also what's the error message you're getting?

The wierd thing is I dont get a error message. I click install and then the title I want to install then the app just goes back to the main screen with nothing installed. Does this with everything I have downloaded so far. Here are just a few of the title IDs I have tried.

Mario 64 00050000-10199500
Super Mario Bros 0005000010106e00
Excitebike 0005000010108200

 

[V10lator]

The wierd thing is I dont get a error message. I click install and then the title I want to install then the app just goes back to the main screen with nothing installed.

That's really weird and I can't recreate it with the title IDs you provided. Are you maybe downloading only by accident (there's an option for that: Pressing Y after entering the title ID) ? Also what happens when you try to install an already downloaded game (second option on the main menu) ?

If you're not downloading only by accident and if downloading an already installeg game also doesn't show any error: Could you try running https://github.com/dimok789/loadiine_gx2/blob/master/udp_debug_reader/UdpDebugReader.exe on your PC, press F to create a log file, then run the debug build of NUSspli, recreate the error while this setup is running (really no need to configure anything, both tools just need to be in the same network) and handle the logfile over to me after it skipped the installation? Hopefully that will reveal what's going on here.

 

[DragonBoy]

Thank you so much for sharing this awesome tool! Will try it at the weekend when I'm back home!

 

[AmandaRose]

That's really weird and I can't recreate it with the title IDs you provided. Are you maybe downloading only by accident (there's an option for that: Pressing Y after entering the title ID) ? Also what happens when you try to install an already downloaded game (second option on the main menu) ?

If you're not downloading only by accident and if downloading an already installeg game also doesn't show any error: Could you try running https://github.com/dimok789/loadiine_gx2/blob/master/udp_debug_reader/UdpDebugReader.exe on your PC, press F to create a log file, then run the debug build of NUSspli, recreate the error while this setup is running (really no need to configure anything, both tools just need to be in the same network) and handle the logfile over to me after it skipped the installation? Hopefully that will reveal what's going on here.

No its doing it if I select download and install and its doing it if I only select download then select the install option afterwards. I will run the debug program later as I am busy sunbathing in my garden right now lol.

 

[wurstpistole]

That is one hell of a way to find a name that exactly matches the abbreviation you want

 

[kfrfansub]

Thank you for this amazing homebrew !!!!!

May I now what is the download speed (min/max/average) for the wii u games ?

 

[V10lator]

May I now what is the download speed (min/max/average) for the wii u games ?

This hardly depends on your connection. With a LAN adapter the values are roughly:

min: 3.5 Mbit/s
max: 4.9 Mbit/s
avg: 4 Mbit/s

Note that these values may change in the future as more multitasking work is planned.