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

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,

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
• @huma_dawii
• @jacobsson

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: 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

1.0:

• Initial release.

1.1:

• Show more installation errors on screen.
• Use I/O queue for title.tik and title.cert creation.
• Create title.cert after title.tik.
• Remove unused variables.
• Fix libCURL header callback.
• Fix bug #4.

1.2:

• Try to fix installer.

1.3:

• Try to fix installer².
• Ask for new URL if the server returns no JSON data.
• Fix slight mistake on the home menu.

1.4:

• Revert "Try to fix installer²".
• Add better error messages to the installation.
• Fix file skipping.

1.5:

• Change colors and logos. Credits to @E1ite007
• Better error message for 0xfffbfc17.
• Revert "Try to fix installer".

1.6:

• Fix typo.
• Add keygen.
• Clear screen on exit.
• Revert ""First work towards channel."

1.7:

• Add goodbye screen.
• Fix bug #6 and #5.
• Change some colors.
• Fix getting filesize of large files.

1.8:

• Add Channel version!
• Add option to cancel downloads (press home while downloading). This fixes bug #9.

1.9:

• Get rid of that title key site dependency.
• Read TID from folder dir.
• Don't overwrite title.tik if it already exists.
• Change PATH character filtering from whitelist to blacklist.
• Fix USB on Mocha.
• Add better handling of storage medium errors.

1.10:

• Fix .h3 downloads. This fixes downloading Zelda BotW DLC.

1.11:

• Fix custom folder names.
• Update cJSON to newest nightly.
• Cleanup ARM hack.

1.12:

• Simplify ARM hack even more.
• Add experimental self updater (as requested by @Sonic Angel Knight).
• Update to WUT 1.0.0-beta10.
• Fix title parser.

1.13:

• Add support for more controllers (fixexs bug #7 and #8).
• Better error handling in case the download dir can't be created.

1.14:

• Try to get ARM hack more stable.
• Detect and handle download stalls (bug reported by @Luxrayss).
• Fix pressing HOME while downloading (also reported by @Luxrayss).
• Resume partial files if NUS allows it.
• Disable shutdown while updating.
• Rumble after HBL version update.
• Various changes under the hood.

1.15:

• Try to fix FPS.
• Fix filebrowser.
• Change some icons.
• Various optimizations.

1.16:

• Show speed in B/s, too.
• Various changes and fixes under the hood.
• Add @GABO1423 to the BETA testers.

1.17:

• Prepair for auto-resume of failed downloads.
• Fix bug reported by @Chuardo
• Fix main menu.

1.18:

• Introduce title browser!
• Make filebrowser/titlebrowser fast-scrollable with left/right key.
• Implement #14.
• Update cJSON.
• Include title database for the case the user doesn't want or can't connect to the server.
• Massive DL speed improvement!
• Fix bug #17.
• Fix bug #21.
• More bugfixes.

1.19:

• Hotfix release.

1.20:

• Bugfix release.

1.21:

• Better warnings.
• Add region icons by @E1ite007 and me.
• Change arrow to one made by @E1ite007.
• Add uninstaller.
• Bugfixes.

1.22:

• Uninstaller: Show progress.
• Changes under the hood.
• Fix updater once and forever (except when updating from Aroma version to Aroma version).
• Allow more characters in filenames (we stay to ASCII. While the Wii U allows more characters the FTPiiU Aroma plugin does not but we want our paths/files to be accessible by it).
• Add auto-resume of failed downloads.
• Bugfixes.

1.23:

• Unlimit SD write speed.
• Bugfixes.

1.24:

• Changes under the hood.
• Show complete download size.

1.25:

• Better title search.
• Introduce tabs (closes #29).
• Big OSD keyboard oberhault.
• Changes under the hood.
• Bugfixes.

1.26:

• Fix search with special chars.

1.27:

• Changes under the hood.
• Minor bugfix.

1.28:

• Better error message in case of no space left on the storage medium.
• Disable standby while downloading.
• Save download to SD or USB setting.
• Make it possible to scroll through tabs with +/-, too (for wii motes).
• Bugfixes.

1.29:

• Changes under the hood.
• Bugfixes.

1.30:

• Minor bugfixes.

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

 

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.

 

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):

Code:

/*
 * 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.

 

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

//EDIT:

Yes.

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

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

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

 

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.

 

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.