NS-USBloader
mit diesem Tool von developersu können Installationen über AtmoXL Titel Installer, Goldleaf, Awoo Installer, oder Tinfoil (Adubbz v0.2.1) vom PC (Linux, macOS oder Windows), oder über die Mobile-Version von einem Android-Smartphone durchgeführt werden.
System Anforderungen
- JDK 11 oder höher für macOS und Linux
Verwendungszweck
Linux:
Installiere JRE / JDK 8u60 oder höher (openJDK ist gut. Oracle ist auch gut). JavaFX wird nicht benötigt (es ist eingebettet).
root # java -jar /path/to/NS-USBloader.jar
Mac OS
Doppelklicke auf die heruntergeladene JAR-Datei. Instruktionen befolgen. Oder siehe Abschnitt 'Linux'.
Lege bei Bedarf die Einstellungen für "Sicherheit und Datenschutz" fest.
Bitte beachten: JDK 19 wird für die Verwendung unter macOS empfohlen. Es gibt bereits Probleme, die von Benutzern auf Mac mit JDK 14 gemeldet wurden.
Windows:
1. Sobald die Anwendung geöffnet ist, klicke auf das Zahnrad-Symbol.
2 Klicke auf "Treiber herunterladen und installieren".
3. Treiber installieren
Es gibt drei Registerkarten. Der erste ist der Haupt.
Erste Registerkarte.
Wähle oben aus der Dropdown-Liste die Anwendung und das Protokoll aus, die du verwenden möchtest. Für GoldLeaf ist nur USB verfügbar. Das Lampensymbol steht für das Umschalten der Themen (hell oder dunkel).
Anschließend kannst du einen Ordner mit NSPs ODER Dateien per Drag & Drop in die Anwendung ziehen oder die Schaltfläche "NSP-Dateien auswählen" verwenden. Mehrfachauswahl für Dateien möglich. Klicke erneut darauf und wähle die gewünschten Dateien aus einem anderen Ordner aus. Sie werden der Tabelle hinzugefügt.
Tabelle.
Dort kannst du das Kontrollkästchen für Dateien aktivieren, die an die Anwendung (TF / GL) gesendet werden. Da du in GoldLeaf immer nur eine Datei übertragen kannst, steht nur eine Datei zur Auswahl. Du kannst auch Leerzeichen verwenden, um Dateien auszuwählen oder die Auswahl aufzuheben, und die Schaltfläche "Löschen" zum Löschen. Per Rechtsklick gelangst du in das Kontextmenü, in dem du einen ODER alle Einträge aus der Tabelle löschen kannst.
Zweite Registerkarte.
Hier kannst du Einstellungen für die Übertragung von Netzwerkdateien konfigurieren. Normalerweise solltest du nichts ändern. Die interessanteste Option ist hier "Don't serve requests". Die Architektur des TinFoil NET-Teils funktioniert auf interessante Weise. Wenn du in TF Network NSP Transfer auswählst, wartet die Anwendung an Port 2000 auf die Information, woher sie Dateien nehmen soll. Wie '192.168.1.5:6060/my file.nsp'. Normalerweise bedient der NS-USBloader Anfragen, indem er einen vereinfachten HTTP-Server implementiert und ihn hochfährt und so weiter. Wenn diese Option ausgewählt ist, kannst du den Pfad zum Remote-Speicherort der Dateien definieren. Wenn du beispielsweise in den Einstellungen '192.168.4.2:80/ROMS/NS/' die Tabellendatei 'my file.nsp' festlegst und hinzufügst, teilt NS-USBloader TinFoil einfach mit: "Hey, nehmen Sie Dateien aus '192.168.4.2: 80 / ROMS / NS / my% 20file.nsp '". Natürlich musst du den Host '192.168.4.2' starten und die Datei von dieser Adresse aus zugänglich machen (installiere einfach nginx). Wie gesagt, dieses Feature ist interessant, aber ich denke, es wird nicht populär sein.
Auch hier kannst du die Option "Auto-check for updates" aktivieren oder auf die Schaltfläche klicken, um zu überprüfen, ob eine neue Version veröffentlicht wurde oder nicht.
Dritte Registerkarte.
Dort wurden alle Protokolle abgelegt. Ausführliche Informationen zu Übertragungen findest du hier.
Warum endet 'NET' nie, wenn es einmal gestartet wurde?
Da sich in der Anwendung ein HTTP-Server befindet. Es kann nicht festgestellt werden, wann alle Übertragungen beendet sind (es sei denn, sie sind fehlgeschlagen). Du musst also auf deinen Switch-Bildschirm schauen und ihn "unterbrechen", sobald sie fertig sind.
System Anforderungen
- Minimum: Android 4.0 (Ice Cream Sandwich)
- Maximum: Android 10.0 (Q)
- USB-OTG-Unterstützung
Verwendungszweck
- Öffne TinFoil / GoldLeaf
- Verbinde die Switch über ein OTG-Kabel mit einem Android-Gerät.
- Interaktionsanforderung zulassen. Die Anwendung wird geöffnet.
- Klicke auf die Menüschaltfläche "hamburger" und wähle die Anwendung aus, die du verwenden möchtest.
- Wähle auf deinem Gerät NSP aus. Eins nach dem anderen bei jedem Klick auf die Schaltfläche (ich weiß, dass es nicht perfekt ist)
- Klicke auf die Schaltfläche zum Hochladen.
- Hinweis: Verwende ein kurzes USB-Kabel.
v7.1
- 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. #156
- HiDPI support! Well, sort of You can change application font and size in settings. Makes sense for Rectify11 users. #153
- Fix locale processing. Important for some Linux users. #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
- 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
ns-usbloader-7.0-m1.jar
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 Java SE Development Kit 19.0.2 'Arm 64 DMG Installer' - Windows users now receives
Installer-7.0.exe
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 intoexe
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
- Swedish translation added by @yeager. Thank you!
- Korean translation updated by @DDinghoya. Thank you!
v6.0
- 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
- Apple Silicon support. To run it on M1 you will need Zulu-JDK with FX. Please check 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, nastye - Chinese translations (Simplified and Traditional) updated by FFT9 (XXgame Group). Thank you!
v5.1
- Batch Split/Merge in GUI (fix #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 (#44 and #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 Awoo Installer but as always you are more than welcome to use what you want [Blockierte Grafik: https://gbatemp.net/styles/default/xenforo/clear.png]
- Tested compatibility with GoldLeaf 0.9 and added small updates to UI.
- Korean translation updated by DDinghoya. Thank you!
- Romanian translation added by Călin Ilie. Thank you!
- Italian translation updated by unbranched. Thank you!
v5.0
- @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 #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
- Real fix for #79, #80 and #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
- Fix broken "Don't serve requests" option.
- Update Brazilian Portuguese Translation by @andercard0. Thank you!
- Fix/improve split-files validations.
- Fix #79 (Merge: Save to folder not working), #80 (Select NSP files not working). Thanks @xXxQuiquexXx, @tefanga!
v4.3
- Simplified Chinese translation updated by @exiori. Thank you!
- Brazilian Portuguese translation updated by @almircanella. Thank you!
v4.2
- 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).
v4.1
- Add RCM-payload tool support for Raspberry Pi. Built and tested on 'Raspberry Pi 3 Model B'.
v4.0
- Full command line interface support for people who don't have GUI (issue #50). Click to read more
- Updated Brazilian Portuguese translation by @almircanella. Thank you!
- Refactored Tinfoil/Awoo NET related code. Installations should work faster now.
- Update icon for 'Games' tab
- 'Allow XCI / NSZ / XCZ files selection for Tinfoil' settings option enabled by-default for new installations.
- GoldLeaf version should be set in options: v0.8 selected by-default. No more discouraging 'Use old GoldLeaf version' checkboxes.
- A lot of code polishing
v3.0
- New windows users can (download and) install drivers from application using button on settings ('Gear') tab. Drivers are libusbK v3.0.7.0 that people used to install over Zadig. Drivers would be installed for both APX (RCM Mode) and 'Homebrew' modes of the NS.
- Added CLI key for removing all application settings. I don't know why you may need this but maybe in case of some emergency. Read a bit more about CLI
v2.2.1
- Updated Vietnamese translation by @pnghai. Thank you!
v2.2
- Italian translation updated by @unbranched . Thank you!
- Fix bug #54
- Reduce number of messages in logs sections..
--
Actually it's all about updated Italian translation. Thanks and take care of yourself!
v2.1
- Portuguese translation updated by @almircanella. Thank you!
- Bugfix: 'Fails to autodetect system IP Address on macOS Catalina' #45
v2.0
- UI updated: colors, tabs, drag-n-drop functions etc.
- Added tool for splitting files
- Added tool for merging split-files
- Added 'Fusée Gelée' RCM payload tool for:
- Windows (I tested it on Windows 7 64-bit)
- MacOS (not tested)
- Linux (I tested on amd64)
- FreeBSD (not tested)
v1.0
- GoldLeaf v0.8 support (set as default).
- For using with GoldLeaf v0.7-v0.7.3 (or v0.5) please set appropriate option in 'Settings'.
v0.9.1
- Settings tab: elements reorder.
- Bugfix in Tinfoil net-stack: in case of 404 condition you will see appropriate reply in homebrew instead of stuck UI.
- Bugfix in Tinfoil usb-stack: Now it won't ruin the data and thus your installation if there are no request from NS side for a while.
(Really rare bug. Many thanks to developers/contributors of 'Awoo Installer': Huntereb and HookedBehemoth for detailed report!) - Minor updates in Tinfoil logs.
v0.9
- Split-files support (for all supported home-brew applications)
- Bug fixes: application won't fail to start in case application saved in folder that has '+' character in name.
- Many minor UI updates
v0.8.1
- Vietnamese translation added. Thanks to @pnghai
- Fixed sorting files by size. Thanks to @wolfposd
- Now window size will be saved on close and restored once application starts.
- Minor fixes in UI
v0.8
- Fixed old annoying issue related to process interruption. Now button 'Interrupt' really interrupts the process in any moment
- If you still use GL v0.5 use option 'Use old GoldLeaf version' in settings. (Yes, you still have to add one file to table and select it, otherwise only the first one from selected files would be used. Or nothing will work if you didn't select anything.)
- Now any file could be added to VIRT:/ if check-box 'Show only *.nsp in GoldLeaf' (in settings) not selected.
This option sets filters to file chooser when you select files via 'Select .NSP files' or drag-n-drop files/folders. Enabled -> only NSPs; disabled -> everything (except hidden).
Also this option excludes any non-NSP files from HOME:/ pseudo-drive in GoldLeaf. Yes, I know, it's a bit strange solution.
- Portuguese language updated by almircanella.
- Other not interesting changes (like a window now a bit larger, some icons a bit more round etc.)
- Not tested on GoldLeaf v0.7.1/v0.7.2
v0.7
- GoldLeaf v0.7 support
- Chinese translation made by Huang YunKun (htynkn). Thanks!
- German translation made by Swarsele. Thanks!
- Some other minor changes.
v0.6
- GoldLeaf v0.6.1 support
- Bugfix for #24
- Logs for GL scenario is limited to warnings and failures since showing everything that happens is resource-consuming.
- Spanish translation updated by Kuziel Alejandro. Thanks!
v5.0
- Korean translation added by @DDinghoya. Thank you!
v4.0
- Italian translation added by @IvanMazzoli. Thank you!
@htynkn added many interesting things:
- Added file associations for nsp, nsz, xci, xcz files.
- Added CI (GitHub Actions)
- Corrected Chinese translations
Many thanks!
v3.0
Update user interface:
- Add dark theme
- Created and added navigation panel pattern
- Updated margins for better view on phones with curved screens (e.g. 1+ 8pro)
- Add ability for users to select application theme: day/night/system
- Update notification priority: there should be no sound on modern devices when notification icon appears (reinstall app if you still hear it or disable somewhere in system settings if don't want to reinstall)
- Made disable button(s) on a main application screen looks 'disable' (darker colour).
Update back end:
- Rewrite a bit net-related code to make it readable.
v2.0
- Add Simplified Chinese by FFT9 (XXGAME GROUP). Thank you!
v1.0
- Remove notification that appears once user connects NS
- Add Traditional Chinese by @qazrfv1234. Thank you!
- Fix startup failures on old android versions related to vector assets
- Add split-screen and window-in-window support for 'modern' android versions
v0.2
- TinFoil-style network transfer support.
- Change progress bar behavior (maybe it caused application failures for large files?).
- Add settings.
- Add NCZ/XCI/XCZ 'support' that is used in Huntereb/Awoo-Installer and/or any similar applications.
v0.1
- First public Release