[SWITCH] Ns-Usbloader V4.1 Released

The developer davelopersu has released a new update of ns-usbloader with the new version 4.1.NS-USBloader is an installer for Adubbz / TinFoil (v0.2.1)  ,  Huntereb / ​​Awoo-Installer  (USB and network supported) and  XorTroll / GoldLeaf  (USB) NSP installer on the PC side with GUI and cookies. It works on Windows, macOS and Linux.

System requirements

JRE / JDK 8u60 or higher.


GoldLeaf versions supported

GoldLeaf version NS-USBloader version
v0.5 v0.4 – v0.5.2, v0.8 +
v0.6 none
v0.6.1 v0.6
v0.7 – 0.7.3 v0.7 +
v0.8 v1.0 +

where ‘+’ means ‘any later version of NS-USBloader’.

Support for two installers

Awoo Installer uses the same set of commands (or “protocol”) on TinFoil. Then select “TinFoil” in case you are going to use Awoo.

Also, go to the NS-USBloader “Settings” tab after the first installation and select the “Allow selection of XCI / NSZ / XCZ files for TinFoil” option. This installer can install not only NSP but also many more formats!


  1. Install JRE / JDK 8u60 or higher (openJDK is good. Oracle’s is also good). JavaFX not necessary (it is embedded).
  2. root # java -jar /path/to/NS-USBloader.jar
  3. Optional: add the user to the ‘udev’ rules to use NS non-from-root-account
root # vim /etc/udev/rules.d/99-NS.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="3000", GROUP="plugdev"
root # udevadm control --reload-rules && udevadm trigger
  1. For the RCM part
root # vim /etc/udev/rules.d/99-NS-RCM.rules
SUBSYSTEM=="usb", ATTRS{idVendor}=="0955", ATTRS{idProduct}=="7321", GROUP="plugdev"
root # udevadm control --reload-rules && udevadm trigger

Note: it may be necessary to change the ‘plugdev’ group from the above example to the different one. It depends on your Linux distribution.

Mac OS

Double-click on the downloaded .jar file. Follow the instructions. Or see the “Linux” section.

If necessary, configure the “Security and privacy” settings.

  • Download Zadig:  https://zadig.akeo.ie/
  • Open TinFoil. Set ‘Title Management’ -> ‘NSP install USB’
  • Connect NS to PC
  • Open Zadig
  • Click on “Options” and select “List all devices”
  • Select NS in the drop-down menu, select “libusbK (v3.0.7.0)” (version may vary), click “Install WCID driver”
  • Check that in the list of devices on your system there is the folder ‘libusbK USB Devices’ and your NS inside it
  • Download and install Java JRE  (8u60 or later)
  • Get this application (JAR file) double click on it (alternatively ‘open’ cmd ‘, go to the place where the vase is located and run away  java -jar thisAppName.jar)
  • Remember to have fun!

And how do you use it?

The first thing to do is to install TinFoil (  Adubbz  ), GoldLeaf (  XorTroll  ) or Awoo (  Huntereb  ) on your NS.

Take a look at the app, find where you can install from USB and / or network. Maybe  this article (on TinFoil)  will be useful.

In details

There are three tabs. The first is main.

First card.

At the top of you by selecting from the drop-down application and the protocol you intend to use. For GoldLeaf only USB is available. The lamp icon indicates the change of themes (light or dark).

Then you can drag the files (split folders or folders) into the application or use the “Select NSP file” button. Multiple selection for available files. Click on it again and select files from another desired folder, which will be added to the table.


There you can select the checkbox for the files that will be sent to the application (TF / GL). Since GoldLeaf allows you to transmit only one file at a time, only one file is available for selection.

Also you can use the space to select / deselect files and the ‘Delete’ button for deletion. With the right mouse button you can display the context menu where you can delete one or all elements from the table.

For GoldLeaf v0.6.1 and NS-USBloader v0.6 (and later) you will need to use “Content Explorer” -> “Remote PC (via USB)” Two HOME units will be displayed: / and VIRT: /. The first drive points to your home directory. The second is a reflection of what you added to the table (first application tab). VIRT: / drive also has limited functionality compared to HOME: /. For example, files cannot be written to this drive because it is not a drive. But don’t worry, if you don’t try it it won’t have any impact on GoldLeaf or your NS.

In addition, for GoldLeaf to write files (from NS to PC): before accessing the files transferred from GL, it is necessary to “Stop execution” correctly. Usually you have to wait 5 seconds or less. It will ensure that your files are written correctly on your PC.

Second card.

Here you can configure the settings for the transmission of network files. Usually you shouldn’t change anything. But you’re a great hacker, keep going! The most interesting option here is ‘Do not serve requests’. The architecture of the NET part of TinFoil works interestingly. When selecting in the TF network NSP transfer, the application will wait at port 2000 for information on where it should take the files. Like “ file.nsp”. Usually NS-USBloader fulfills the requests by implementing a simplified HTTP server and opening it and so on. But if this option is checked, you can define the path to the remote location of the files. For example, if you set in the settings ‘’ and add the table file ‘my file.nsp’, NS-USBloader will simply say to TinFoil “Hey,

Here too you can:

  • Set “Check for updates automatically” to check for updates when the application starts or click the button to check if the new version was released immediately.
  • Set ‘Show only * .nsp in GoldLeaf’ to filter all the files displayed on HOME: / drive. Then only the NSP files will appear.
Third tab.

That’s where all the logs have fallen. Detailed information about the broadcasts comes here.

Known bugs

  • ‘NET’ once started never ends:

It happens because there is an HTTP server inside the application. It cannot determine when all transmissions end (unless they fail). So you have to look at the NS screen and “Stop” once done.

  • Unable to stop transmission when network transmission started and nothing was received from NS.

Other notes

Alternative build for Windows 10 is recommended for all users of Windows 10. It works well on Linux and any other Windows PC and even on macOS Mojave, but it does not work on all previous versions of macOS.

‘Status’ = ‘Uploaded’ appearing in the table does not mean that the file has been installed. It means it was sent to NS without problems! Here’s what this app is about. Managing successful / unsuccessful installation is one purpose of the application of the other party: TinFoil or GoldLeaf. And they don’t provide any feedback interface, so I can’t detect success / failure.

usb4java since NS-USBloader-v0.2.3 has changed to 1.2.0 instead of 1.3.0. This should not be of interest to anyone, except users of macOS High Sierra (and Sierra and El Capitan) where previous versions of NS-USBloader didn’t work.


  • Added support for the RCM payload tool for Raspberry Pi. Built and tested on “Raspberry Pi 3 Model B”.

Note: To use this application in the GUI you need to install the ‘openjfx’ package. To use it in CLI mode the only requirement is ‘default-jdk’. (The package names listed here and in the readme file are valid for ‘Raspberry Pi OS’.) And thanks to  @dreamfalcon  😉