NS-USBloader

NS-USBloader is a PC-side tinfoil NSP USB uploader. Replacement for default usb_install_pc.py

With GUI and cookies.

Read more: https://developersu.blogspot.com/2019/02/ns-usbloader-en.html

Here is the version of 'not perfect byt anyway' tinfoil I use.

License

Source code spreads under the GNU General Public License v.3. You can find it in LICENSE file.

Requirements

JRE 8 or higher. See below.

Used libraries

• OpenJFX
• usb4java
• Few icons taken from: materialdesignicons

Usage

Linux:

Install JRE/JDK 8 or higher (openJDK is good. Oracle's one is also good). JavaFX not needed, if you're interested (it's embedded).

root # java -jar /path/to/NS-USBloader.jar

macOS

See 'Linux' section.

Set 'Security & Privacy' if needed.

Windows:

• Download Zadig: https://zadig.akeo.ie/
• Open tinfoil. Set 'Title Managment' -> 'Usb install NSP'
• Connect NS to pc
• Open Zadig, select NS in dropdown, select 'libusbK (v3.0.7.0)' (version may vary), click 'Install WCID Driver'
• Check that in device list of you system you have 'libusbK USB Devices' folder and your NS inside of it
• Download and install Java JRE (8+)
• Get this application (JAR file) double-click on on it (alternatively open 'cmd', go to place where jar located and execute via 'java -jar thisAppName.jar')
• Remember to have fun!

Tips&tricks

Add user to udev rules to use NS non-root (Linux):

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

• Unable to interrupt transmission when libusb awaiting for read event (when user sent NSP list but didn't selected anything on NS).

TODO:

• macOS QA by Konstanin Kelemen. Appreciate assistance of Vitaliy Natarov.
• Windows support
• code refactoring