ns-usbloader/README.md

3.8 KiB

NS-USBloader

NS-USBloader is a PC-side TinFoil and GoldLeaf NSP USB uploader. Replacement for default usb_install_pc.py and GoldTree.

With GUI and cookies.

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

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

Let's rephrase, if you have working version of TinFoil DO NOT use this one.

Screenshot

License

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

Used libraries

Requirements

JRE 8u60 or higher. See below.

Usage

Linux:

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

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

macOS

Double-click on downloaded .jar file. Follow instructions. Or see 'Linux' section.

Set 'Security & Privacy' settings if needed.

If you use different MacOS (not Mojave) - check release section for another JAR file.

Windows:

  • Download Zadig: https://zadig.akeo.ie/
  • Open tinfoil. Set 'Title Management' -> 'Usb install NSP'
  • Connect NS to PC
  • Open Zadig
  • Click 'Options' and select 'List All Devices'
  • 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

Linux: Add user to udev rules to use NS not-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

Known bugs

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

NOTES

Table 'Status' = 'Uploaded' does not means that file installed. It means that it has been sent to NS without any issues! That's what this app about. Handling successful/failed installation is a purpose of the other side application (TinFoil/GoldLeaf). (And they don't provide any feedback interfaces so I can't detect success/failure.)

Translators! Traducteurs! Traductores! Übersetzer! Թարգմանիչներ!

If you want to see this app translated to your language, go grab this file and translate it. Upload somewhere (pastebin? google drive? whatever else). Create new issue and post a link. I'll grab it and add.

Thanks for great work done by to our translaters team!

Français by Stephane Meden (JackFromNice)

TODO:

  • macOS QA v0.1 (Mojave)
  • macOS QA v0.2.2 (Mojave)
  • Windows support
  • code refactoring
  • GoldLeaf support
  • XCI support
  • File order sort (non-critical)
  • More deep file analyze before uploading.

Thanks

Appreciate assistance and support of both Vitaliy and Konstantin. Without you all this magic would not have happened.

Konstanin Kelemen

Vitaliy Natarov