Install NSPs over USB (NS-USBLoader)¶
This guide will teach you how to setup the unofficial NS-USBLoader USB installer for Goldleaf. This guide requires Java, but the end result is much better than standard Goldtree. NS-USBLoader will work on Windows, OSX and Linux.
If something goes wrong or you need help, check troubleshooting.
After completing steps 0 and 1 once, you can skip to Step 2 to install more NSP files.
Step 0: What You Will Need¶
A USB-C cable which can connect your Switch to your PC.
The latest version of Goldleaf by XorTroll, either as an NRO or installed NSP. Available from Github or SDSetup.
- Goldleaf is included by default in Kosmos.
The latest version of NS-USBLoader by developersu extracted somewhere to your PC. Available from Github or SDSetup.
The latest version of Java
For Windows Users Only: The latest version of Zadig. Available from zadig.akeo.ie.
Step 1 (Windows Only): Installing libusbk Driver¶
OSX and Linux do not need this driver. If you are not using Windows, skip to Step 2.
Make sure Goldleaf is available on your Switch.
Plug your Switch into your PC.
Run Goldleaf on your Switch.
Choose USB installation and choose Start.
On your PC, open the Zadig application and complete the installation if prompted.
In the dropdown box, look for either ‘libnx usb comms’ or ‘Nintendo Switch’ and select it.
- If you cannot see either one, enable ‘List All Devices’ under the options menu item.
Set driver to ‘libusbK (v22.214.171.124)’
- Choose ‘Install Driver’ or ‘Replace Driver’ or ‘Reinstall Driver’ (the big button). Wait for this process to finish.
- Close Zadig.
- Disconnect and reconnect your Switch
- Goldleaf should now say ‘USB connection detected’. If it doesn’t, close Goldleaf and try again.
Step 2: Install NSP with NS-USBLoader¶
Disconnect your Switch from your PC if it is connected.
Open the NS-USBLoader JAR file downloaded earlier on your PC.
- Double click the file in Explorer on Windows and Mac
- On Linux, or if the above does not work, run java -jar /path/to/NS-USBloader.jar in your command terminal
Make sure ‘Goldleaf’ is selected in the dropdown menu in the top left corner of the application.
Click ‘Select .NSP files and pick which NSP(s) you want to install
- You can select as many NSP files as you wish.
Choose ‘Upload to NS’
Connect your Switch to your PC.
In Goldleaf, choose ‘USB Installations’
Pick where you want to install the NSP (Note: SD Card is always recommended to prevent issues with corruption)
If the NSP you are installing usually requires a firmware version higher than yours, choose ‘Yes’ to ignore required firmware version. Otherwise, choose ‘No’
Wait for the installation process to complete
Repeat steps 3.8 through 3.11 for each NSP being installed.
Your NSP(s) should now be installed on your Switch!