Released Ns-Usbloader V0.5.2 And NS-USBloader Mobile

The developer developer has released a new update of NS-USBloader in stable version 0.5.2 and the first version of mobile NS-USBloader for Android devices (USB-OTG cable is required.) NS-USBloader is an installation program for NSP Adubbz / TinFoil  (version 0.2.1, USB and network) and  GoldLeaf (USB) from PC. Default:  , and  GoldTree.  Works on Windows, macOS and Linux.

System requirements

JRE / JDK 8u60 or higher.


  1. Install JRE / JDK 8u60 or higher (openJDK is good, Oracle’s is good too). JavaFX is not necessary (it is incorporated).
  2. root # java -jar /path/to/NS-USBloader.jar
Mac OS

Double-click on the downloaded .jar file. Follow the instructions. Or see the ‘Linux’ section.

Set the “Security and privacy” settings if necessary.

  • Download Zadig:
  • Open TinFoil. Set ‘Title Management’ -> ‘Usb install NSP’
  • 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)’ (the version may vary), click ‘Install WCID driver’
  • Check that in the list of devices on your system you have the ‘libusbK USB Devices’ folder and your NS in 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 jar is located and run through  java -jar thisAppName.jar)
  • Remember to have fun!

And how to use it?

The first thing you should do is install TinFoil (  Adubbz  ) or GoldLeaf (  XorTroll  ) on your NS. I recommend the use of TinFoil, but it’s up to you. Take a look at the app, find where is the option to install from USB and / or network. Perhaps  this article  will be useful.

Here is the tinfoil version that I use   ‘not perfect but anyway’ is fine. Ok, I’m pretty sure this version has bugs. I don’t remember where I downloaded it. But it works for me somehow.

We make a reformulation, if you have a working version of TinFoil  DO NOT  use it. Ok. Let’s start.

There are three tabs. The first is the main one.

First card

At the top select from the drop-down application and the protocol you intend to use. Only Gold is available for GoldLeaf. The lamp icon is the acronym for switching the themes (light or dark).

Then you can drag the folder with NSP OR files into the application or use the “Select NSP file” button. Multiple selection for available files. Click again and select the files from another folder you want, it will be added to the table.


Here you can select the checkbox for the files that will be sent to the application (TF / GL). Since GoldLeaf only allows one file transmission at a time, only one file is available for selection. Also you can use the space to select / deselect files and the ‘Delete’ button to delete them. With the right mouse button you can display the shortcut menu where you can delete one or all elements from the table.

Second card

Here you can configure the settings for transmitting network files. Usually you shouldn’t change anything. But you are a great hacker, go ahead! The most interesting option here is ‘Do not serve requests’. The architecture of the TinFoil NET part is working in an interesting way. When selected in the NSP transfer of the TF network, the application will wait at port 2000 for information on where it should retrieve files. I like ‘ file.nsp’. Usually NS-USBloader serves the requests by implementing the simplified HTTP server and bringing it up and so on. But if this option selected, 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 TinFoil “Hey,

Also here you can select ‘Auto-check for updates’ or click on the button to check whether the new version has been released or not.

Third card

That’s where all the records fell. Detailed information on the transmissions is provided here.

Why when it starts ‘NET’ it never ends?

Because there is an HTTP server within the application. It cannot determine when all transmissions end (unless they have failed). So you have to look on the NS screen and “Stop” once done.

Advice and suggestions

Linux: add the user to the ‘udev’ rules to use the non-from-root NS 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

Known bugs

  • Transmission could not be stopped when libusb waits for the read event (when the user sent the NSP list but did not select anything on NS). Sometimes this problem also occurs when the network transmission is started and nothing is received from NS.

Other notes

‘Status’ = ‘Loaded’ which appears in the table does not mean that the file has been installed. It means he was sent to NS without problems! Here’s what this app is about. Successful / failed installation management is one of the purposes of the secondary application: 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 is passed to 1.2.0 instead of 1.3.0. This should have no impact on anyone except the users of macOS High Sierra (and Sierra and El Capitan) where previous versions of NS-USBloader did not work.

The translators!

If you want to see this app translated into your language, take  this file  and translate it. Upload somewhere (pastebin? Google drive? Anything else). Create a new number  and publish a link. I’ll take it and add it.

NOTE: in reality it will not actually work, because we should stay in touch and I need you when you add something that should be translated = (

TODO (maybe):

  •  macOS QA v0.1 (Mojave)
  •  macOS QA v0.2.2 (Mojave)
  •  macOS QA v0.2.3-DEV (High Sierra)
  •  macOS QA v0.3
  •  Support for Windows
  •  refactoring code
  •  GoldLeaf support
  •  XCI support
  •  Sort the order of files (non-critical)
  •  More in-depth analysis of files before uploading.
  •  Network mode support for TinFoil
  •  ‘Check for application updates’ functionality

System requirements for Android

  • Minimum: Android 4.0 (Ice Cream Sandwich)
  • Maximum: Android 10.0 (Q)
  • USB-OTG support


  1. Open TinFoil / GoldLeaf
  2. Connect NS to your Android device using the OTG cable.
  3. Allow interaction request. The application opens.
  4. Click the “hamburger” menu button and select the application you want to use.
  5. Select NSP on your device. One at a time each time by clicking the button (I know it’s not perfect)
  6. Click on the upload button.

Note: Use a short USB cable.


If you are the owner of Samsung, it would be better not to turn the phone during the transfer. Or minimizing. Well, on my older device it causes an application error. But you can try if you’re curious and report / update a bug. Please mention the model of the device.

Other notes

‘Status’ = ‘Loaded’ which appears in the table does not mean that the file has been installed. It means he was sent to NS without problems! Here’s what this app is about. Successful / failed installation management is one of the purposes of the other side application: TinFoil / GoldLeaf. And they don’t provide any feedback interface, so I can’t detect success / failure.


Thank you

I appreciate the assistance and support of Vitaliy and Konstantin. Without you all this magic would not have happened.

Konstanin Kelemen

Vitaliy Natarov