Edit Infobox Switch Homebrews: NS-USBloader Switch

Free text:

NS-USBloader is a PC-side installer for Huntereb/Awoo-Installer / other compatible installers (USB and Network supported) and XorTroll/Goldleaf (USB) NSP installer. Alternative to default usb_install_pc.py, remote_install_pc.py, GoldTree/Quark. This application also could be used as RCM payload on Windows, MacOS and Linux. ==Features== *PC-side installer for Adubbz/TinFoil (v0.2.1), [[Awoo Installer Switch|Huntereb/Awoo-Installer]] (USB and Network supported) and [[Goldleaf Switch|XorTroll/GoldLeaf]] (USB) NSP installer. *RCM payload tool that works on Windows, macOS (Intel and Apple Silicon) and Linux (x86, amd64 and Raspberry Pi ARM). *Multiple file selection. *Can create split files. *Can merge split-files into one. *With GUI and cookies. Works on Windows, macOS and Linux. *[[NS-USBloader Mobile Switch|Click here for Android version]]. ==Installation== ===Requirements=== * Java JRE/JDK 11+ or higher for mac and linux. * libusb, if you have a Mac with Apple Silicon (install via <code>brew install libusb</code>) ===How to setup=== '''Linux:''' * Install JRE/JDK 8u60 or higher (openJDK is good. Oracle's one is also good). JavaFX not needed (it's embedded). * <code>root # java -jar /path/to/NS-USBloader.jar</code> * Optional: add user to 'udev' rules to use NS not-from-root-account **<code>root # vim /etc/udev/rules.d/99-NS.rules</code> **<code>SUBSYSTEM=="usb", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="3000", MODE="0666"</code> **<code>root # udevadm control --reload-rules && udevadm trigger</code> * For RCM part **<code>root # vim /etc/udev/rules.d/99-NS-RCM.rules</code> **<code>SUBSYSTEM=="usb", ATTRS{idVendor}=="0955", ATTRS{idProduct}=="7321", MODE="0666"</code> **<code>root # udevadm control --reload-rules && udevadm trigger</code> * For HiDPI use scaling like <code>java -Dglass.gtk.uiScale=150% -jar application.jar</code> '''Raspberry Pi:''' * Install JDK: <code>sudo apt install default-jdk</code> * For UI install JavaFX: <code>sudo apt install openjfx</code> * See "Linux" section to update "udev" and the RCM part. '''macOS:''' *Double-click on downloaded .jar file. Follow instructions. Or see "Linux" section. *Set "Security & Privacy" settings if needed. *Please note: JDK 19 is recommended for using on macOS. There are issues already reported from users on Mac with JDK 14. '''macOS on Apple Silicon (ARM):''' *Download application with <code>-m1.jar</code> postfix. '''Windows:''' *Once application opens click on "Gear" icon. *Click "Download and install drivers". Install drivers. ==User guide== ===Supported installers=== *Awoo installer. *GoldLeaf v0.10 (NS-USBloader v6.0+). *GoldLeaf v0.8 - 0.9 (since NS-USBloader v1.0+). *GoldLeaf v0.7 - v0.7.3 (since NS-USBloader v0.7+). *GoldLeaf v0.6.1 (NS-USBloader v0.6). *GoldLeaf v0.5 (NS-USBloader v0.4 - v0.5.2, v0.8+). *TinFoil - both USB and Net methods (developed by Adubbz, 0.2.1). ===How to use=== The first thing you should do it install Awoo ([https://github.com/Huntereb/Awoo-Installer Huntereb]) or Goldleaf ([https://github.com/XorTroll/Goldleaf XorTroll]) on your NS. Take a look on app, find where is the option to install from USB and/or Network. Maybe (very old) [https://developersu.blogspot.com/2019/02/ns-usbloader-en.html this article (about TinFoil)] will be helpful. '''Gamepad Tab:''' At the top, you can select the application and protocol from the drop-down menu that you want to use. For Goldleaf, only USB is available. The lamp icon allows you to switch between light and dark themes. You can drag and drop files or use the 'Select NSP files' button to add files to the table. Multiple selections are possible. The table allows you to select files for transmission to the application (AW/GL). Goldleaf v0.5 allows only one file transmission at a time. In the table, you can use checkboxes to select files, the spacebar to toggle selection, and the 'delete' button to remove files. Right-clicking provides a context menu for deleting one or all items from the table. For Goldleaf v0.6.1 and NS-USBloader v0.6 (and higher), use 'Explore content' -&gt; 'Remote PC (via USB)'. Two drives, HOME:/ and VIRT:/, are displayed. The first points to your home directory, and the second reflects what you've added to the table. VIRT:/ has limited functionality compared to HOME:/. You can't write files to this drive, but it won't impact Goldleaf or your Nintendo Switch if you try. For writing files from NS to PC in Goldleaf, you have to 'Stop execution' properly before accessing files transferred from GL. Usually, you have to wait 5 seconds or less to ensure that your files are properly written to PC. '''RCM Tab:''' On this tab, you can select a payload like Hekate or LockPick_RCM and send it to the Nintendo Switch. Drag and drop is supported, and there are in-app validations for payloads. '''Folder with Arrows and Zeroes Tab:''' On this tab, you can split and merge files. Select 'Split' or 'Merge', and drag and drop is supported. '''Gears Tab:''' Here you can configure settings for network file transmission. Usually, you shouldn't change anything. However, if you're advanced, you can explore options. The 'Don't serve requests' option allows you to define a path to a remote location of files, making this feature interesting for advanced users. Also here you can: * Set &quot;Auto-check for updates&quot; for checking for updates when application starts, or click button to verify if new version released immediately. * Set &quot;Show only *.nsp in Goldleaf&quot; to filter all files displayed at HOME:/ drive. So only NSP files will appear. '''Dialog with Three Dots Tab:''' This is where all logs are stored. Verbose information about transmissions is logged here. ===CLI (command line interface)=== To get help run <code>$ java -jar ns-usbloader-4.0.jar --help</code> <pre> -c,--clean Remove/reset settings and exit -g,--Goldleaf <...> Install via Goldleaf mode. Check '-g help' for information. -h,--help Show this help -m,--merge <...> Merge files. Check '-m help' for information. -n,--tfn <...> Install via Awoo Network mode. Check '-n help' for information. -r,--rcm <[PATH/]payload.bin> Send payload -s,--split <...> Split files. Check '-s help' for information. -t,--tinfoil <FILE...> Install via Awoo USB mode. -v,--version Show application version </pre> For more complex commands help use help argument after the fists key. For example: <pre> $ java -jar ns-usbloader-4.0.jar -n help Usage: ns-usbloader -n nsip=<arg1> [hostip=<arg2>] FILE1 ... ns-usbloader --tfn nsip=<arg1> [hostip=<arg2>] FILE1 ... Options: nsip=<ip> Define NS IP address (mandatory) hostip=<ip[:port]> Define this host IP address. Will be obtained automatically if not set. </pre> Usage examples: <pre> Send RCM payload: $ java -jar ns-usbloader-4.0.jar -r C:\Users\Superhero\hekate.bin Send files to Awoo Installer via Net-install: $ java -jar ns-usbloader-4.0.jar -n nsip=192.168.0.1 ./file.nsz ./file.nsp ~/*.xci Send files to Goldleaf v0.8: $ java -jar ns-usbloader-4.0.jar -g ver=v0.8 ./* Split files: $ java -jar ns-usbloader-4.0.jar -s /tmp/ ~/*.nsp Merge files: $ java -jar ns-usbloader-4.0.jar -m /tmp/ ~/*.nsp </pre> ===Notes=== "Status" = "Uploaded" that appears in the table does not mean that file has been 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: Awoo/Awoo-like or Goldleaf. And they don't provide any feedback interfaces so I can't detect success/failure. What is this "-legacy" jar: *JAR with NO postfixes recommended for Windows users, Linux users and macOS users who're using Mojave or later versions. *JAR with "-legacy" postfix is for macOS users who're still using OS X releases before (!) Mojave. (It also works for Linux and for Windows, but sometimes it doesn't work for Windows). *We have this situation because of weird behaviour inside usb4java library used in this application for USB interactions. In "-legacy" it's v1.2.0 and in 'normal' it's v1.3.0. ==Screenshots== https://dlhb.gamebrew.org/switchhomebrews/nsusbloadernx2.png https://dlhb.gamebrew.org/switchhomebrews/nsusbloadernx3.png https://dlhb.gamebrew.org/switchhomebrews/nsusbloadernx4.png https://dlhb.gamebrew.org/switchhomebrews/nsusbloadernx5.png https://dlhb.gamebrew.org/switchhomebrews/nsusbloadernx6.png ==Known issues== In some moments you can't interrupt file(s) transmission from application side if using Tinfoil/Net-install. ==Changelog== '''v7.2 2024/10/31''' * Turkish language added by [https://github.com/Erimsaholut @Erimsaholut]. Thank you! * Traditional Chinese translation updated by [https://github.com/exiori @exiori]. Thank you! * Korean translation updated by [https://github.com/DDinghoya @DDinghoya]. Thank you! * [https://github.com/secretjupiter @secretjupiter] update readme file. Thank you! '''v7.1 2023/12/26''' * Drivers added into Windows installer. App checks if there are drivers in application folder and would try to download them only if absent. Important for some folks. [https://github.com/developersu/ns-usbloader/issues/156 #156] * HiDPI support! Well, sort of :) You can change application font and size in settings. Makes sense for Rectify11 users. [https://github.com/developersu/ns-usbloader/issues/153 #153] * Fix locale processing. Important for some Linux users. [https://github.com/developersu/ns-usbloader/issues/139 #139] * Simplified Chinese translation updated by @exiori. Thanks! * French translation updated by @requinDr. Thanks! * Korean translation updated by @DDinghoya. Thanks! * @justindhillon corrected broken links in 'readme' and 'pom'. Thanks! '''v7.0 2023/02/11''' *First things first. @kuragehimekurara1 translated this application to Japanese and Ryukyuan languages! Thank you! *Build setup updated to generate sources for Java 11. This means, that now in linux and mac you have to install JDK11 or higher. *macOS M1 users, there is a <code>ns-usbloader-7.0-m1.jar</code> built for you! Works with any JDK, so no need to search and install something special. I've tested it with Oracle JDK 19. It was [https://www.oracle.com/java/technologies/downloads/#jdk19-mac Java SE Development Kit 19.0.2 'Arm 64 DMG Installer']. **EDIT (17.02.23): On apple silicone you still have to manually install libusb via brew install <code>libusb</code>. *Windows users now receives <code>Installer-7.0.exe</code> which installs all necessary dependenies at once! In other words you don't have to download and install JRE from java.com. Application (jar) wrapped into exe file and bundled with java runtime. It was 'taken' from OpenJDK 19.0.2. *Since this release you are also will be able to install 'Split NSP/XCI/NSZ/XCZ', not only 'NSP'. This silly limitation removed. To be honest, I didn't test it. Guess it's should be fine. '''v6.1 2022/09/25''' *Swedish translation added by @yeager. Thank you. *Korean translation updated by @DDinghoya. Thank you. '''v6.0 2022/08/03''' *GoldLeaf v0.10 support added. *Chinese translation (Traditional) updated by @qazrfv1234. Thank you. *Chinese translation (Simplified) updated by @exiori. Thank you. *Korean translation updated by @DDinghoya. Thank you. *Spanish translation updated by @Uzi-Oni. Thank you. '''v5.2 2021/09/16''' *Apple Silicon support. To run it on M1 you will need [https://www.azul.com/downloads/zulu-community/?version=java-11-lts&os=macos&architecture=arm-64-bit&package=jdk-fx Zulu-JDK with FX]. Please check [https://github.com/developersu/ns-usbloader/issues/91 discussion thread] for details. **I don't have apple hardware and I highly appreciate community assistance in implementing this feature! Thank you for library, **@agungrbudiman! Thank you for testing, @cythb! And thank you for ideas, [https://github.com/nastye nastye]. *Chinese translations (Simplified and Traditional) updated by [https://www.xxgame.net/ FFT9 (XXgame Group)]. Thank you. '''v5.1 2021/08/26''' *Batch Split/Merge in GUI (fix [https://github.com/developersu/ns-usbloader/issues/87 #87]). *On start always open tab which has been opened before application closed (Game/RCM/Split-Merge). *Update to OpenJFX 16. Should be fixing issues on some macOS ([https://github.com/developersu/ns-usbloader/issues/44 #44] and [https://github.com/developersu/ns-usbloader/issues/92 #92]). *Replaced 'Tinfoil' name to 'Awoo' everywhere because I think we need a new name to specify 'original Tinfoil'. Since it's 99% the same, *let's just use this. Reference to [https://github.com/Huntereb/Awoo-Installer Awoo Installer] but as always you are more than welcome to use what you want. *Tested compatibility with GoldLeaf 0.9 and added small updates to UI. *Korean translation updated by [https://github.com/DDinghoya DDinghoya]. Thank you. *Romanian translation added by [https://github.com/calini Călin Ilie]. Thank you. *Italian translation updated by [https://github.com/unbranched unbranched]. Thank you. '''v5.0 2020/12/10''' *@wolfposd added 'files-scanner functionality': You can select folder instead of file/files to run recursive scan: all supported formats would be added. Same functionality set for drag-n-drop. See [https://github.com/developersu/ns-usbloader/issues/51 #51] for details (BTW it's not yet implemented for CLI). Thank you, wolfposd! *@eslamabdel translated application to Arabic. Thank you. *@DDinghoya updated Korean translation. Thank you. *Other not important minor color adjustments for 'light' theme, aligning pixels etc. '''v4.5 2020/11/07''' *Real fix for [https://github.com/developersu/ns-usbloader/issues/79 #79], [https://github.com/developersu/ns-usbloader/issues/80 #80] and [https://github.com/developersu/ns-usbloader/issues/81 #81]. *Long story short: In situation when application configuration (for whatever reason) contained incorrect/non-existing path to the recently used directory, application crashed or buttons stopped working. So now it's finally fixed. Really. I tested (Thanks for details, @tefanga). '''v4.4 2020/11/06''' *Fix broken "Don't serve requests" option. *Update Brazilian Portuguese Translation by @andercard0. Thank you. *Fix/improve split-files validations. *Fix [https://github.com/developersu/ns-usbloader/issues/79 #79] (Merge: Save to folder not working), [https://github.com/developersu/ns-usbloader/issues/80 #80] (Select NSP files not working). Thanks @xXxQuiquexXx, @tefanga. '''v4.3 2020/09/24''' *Simplified Chinese translation updated by @exiori. Thank you. *Brazilian Portuguese translation updated by @almircanella. Thank you. '''v4.2 2020/07/28''' *Add Czech Translation by @spenaat. Thank you. *Add Traditional Chinese translation by @qazrfv1234. Thank you. *Minor corrections: language drop-down selector in settings now showing language names (and locale) instead of three-letter abbreviations; preferences option name changed (back end). [https://github.com/developersu/ns-usbloader/releases Release notes.] ==Credits== Used libraries &amp; resources: * [https://wiki.openjdk.java.net/display/OpenJFX/Main OpenJFX] * [https://mvnrepository.com/artifact/org.usb4java/usb4java usb4java] * Few icons taken from: [http://materialdesignicons.com/ materialdesignicons.com] * Information, ideas and data from [https://github.com/reswitched/fusee-launcher 'fusee-launcher'] application * [https://commons.apache.org/proper/commons-cli/ Apache Commons CLI] List of awesome code contributors, translators and other great people: * [https://github.com/DarkMatterCore Pablo Curiel (DarkMatterCore)] * [https://github.com/wolfposd wolfposd] * [https://github.com/agungrbudiman agungrbudiman] * Perfect algorithms and great examples taken from mrdude project [https://github.com/mrdude2478/IPS_Patch_Creator/ mrdude2478/IPS_Patch_Creator] * French by [https://github.com/JackFromNice Stephane Meden (JackFromNice)] * Italian by [https://github.com/unbranched unbranched] * Korean by [https://github.com/DDinghoya DDinghoya] * Portuguese by [https://github.com/almircanella almircanella] * Spanish by [https://www.reddit.com/u/cokimaya007 /u/cokimaya007], [https://github.com/Uzi-Oni Kuziel Alejandro] * Chinese (Simplified) by [https://github.com/htynkn Huang YunKun (htynkn)], [http://xxgame.net/ FFT9 (XXgame Group)] * Chinese (Traditional) by [https://github.com/qazrfv1234 qazrfv1234], [http://xxgame.net/ FFT9 (XXgame Group)] * German by [https://github.com/Swarsele Swarsele] * Vietnamese by [https://github.com/pnghai Hai Phan Nguyen (pnghai)] * Czech by [https://github.com/spenaat Spenaat] * Arabic by [https://github.com/eslamabdel eslamabdel] * Romanian by [https://github.com/calini Călin Ilie] * Swedish by [https://github.com/yeager Daniel Nylander] * Japanese by [https://github.com/kuragehimekurara1 kuragehime] * Ryukyuan languages by [https://github.com/kuragehimekurara1 kuragehime] * Turkish language by [https://github.com/Erimsaholut Erimsaholut] * Angelo Elias Dalzotto makes packages in AUR * Phoenix[Msc] provides his shiny Mac M1 for debug == External links == * Author's website - https://developersu.blogspot.com/search/label/NS-USBloader * GitHub - https://github.com/developersu/ns-usbloader * GBAtemp - https://gbatemp.net/threads/ns-usbloader-another-one-tinfoil-and-goldleaf-usb-installer.533394/