Gamecard Installer NX Switch

A way to install your gamecards directly to your Switch.

Note: The project is no longer updated.

Features

Install gamecards to the nand/SD card.
Support for gamecards with multiple games inside.
Full touchscreen support.
Background music support. Drop any .mp3 files into ‘/switch/gamecard_installer/’ and it will play the songs at random.
Display useful gamecard information such as: app_id, key_gen and size.
Display the available space on SD card and system NAND from within the app. Automatically updated after installing the game.
Clean up all placeholders on startup. This means if you used an app that failed to install a game and it didn't delete the placeholder after, this app does it for you.
Display error codes to the user should anything go wrong (hopefully you wouldn’t see any).

Download the latest release and unzip the contents to the root of the SD card.

This should result in a folder struct like this /switch/gamecard_installer/gamecard_installer.nro.

Some gamecards have multiple games inside. An example of this is the Child of Light & Valiant Hearts gamecard.

These can still be installed. Pressing L or R will allow you to cycle through the games on the gamecard.

Lowering the keygen (to zero) can allow for games to be launched on all firmware version. This does not guarantee that the game will work however.

This option will also convert any titlekey encrypted nca's to standard crypto (ticketless).

An example of a working game is Pokemon Sword, this game requires firmware 7 usually, however it can work on firmware 6.

To use this option, you must have a keys file named either prod.keys or keys.txt in either /switch or /switch/gamecard_installer/.

To dump your own keys please use Lockpick RCM.

This app can play music.

Simply drop any .mp3 files into /switch/gamecard_installer/.

You can have the .mp3 in folders if you prefer, the app will scan recursively. E.g. /switch/gamecard_installer/music/song.mp3.

v2.0.1 2020/04/13

Fixed the option to enter the game-info menu whilst a gamecard ins't inserted. Thanks #18.
Fixed an non-free error in which exiting the game-info menu would cause the textures to not be freed.
Fixed an edge-case crash for if a user mounted a xci which didn't contain a base entry. This will also fix a crash if the gamecard has no base, upp, dlc entries at all (no one would ever experience this anyway).

v2.0.0 2020/04/05

What's new?

Settings menu.
Game-info menu.
Option to lower keygen (also ticketless install).
Option to choose to install base, update or dlc.
Show the total base, update and dlc per game.
Textures are now entierly cached, slight performance increase whilst installing (~40MiB/s to nand).
Enable / disable music and sound.

What's fixed?

Only the base game was installed previously, this was a huge oversight on my behalf. Closes #13.
Text is now clipped so that it no longer renders off-screen. Closes #11.

Credits:

Huge thank you to @DarkMatterCore for teaching me a lot about how HOS works and for motivating me to continue with this project.
Thank you to @NicholeMattera for being the best tester anyone could ask for.
And thank you to @TechGeekGamer for helping test and cosmetic ideas.

v1.0.1 2020/01/20

What's fixed?

Incorrectly returned the sys version number (fw 8.1.0 would be returned as 8.0.1).
Bug that would cause the installed game to sometimes appear as a gamecard, even with the gamecard removed.
Fixed bug that would make it so that it would sometimes not push the correct application record which caused game updates that was previously installed to say that it was not.

What's next?

Option to lower key gen of games.
Option to disable music / sound effects in-app.
Option overlay that shows these options.
Improve gfx efficiency (cache everything as textures as much as possible to reduce constantly creating a surface and then converting it to a texture every frame, this is pretty much done anyway, but in a few cases it is not).

Special thanks: