NUT GUI USB Switch

NUT GUI USB
General
Author	blawar
Type	Game Installer Companion
Version	3.3
License	GPL-3.0
Last Updated	2021/07/15
Links
Download
Website
Source

Nut is a multi-purpose utility to organize, manage, and install Nintendo Switch files (NSP, NSZ, XCI, XCZ). It has the ability to act as a USB and network server for Tinfoil.

Installation

Windows users:

• Download tinfoil_driver.exe and nut.exe from the release page.
• Install the drivers by running the tinfoil_driver.exe in the previous step.
• Run nut.exe. You should be presented with a GUI as shown in the picture.
• Install the latest version of Tinfoil and open it on the Switch, connect to your PC with either a USB cable, or set up a nut server location using the information displayed in nut server.

Setup guide for UNIX user can be found here.

User guide

Buttons

• Scan - Populates file list.
• Organize Files - Moves files on disk to match the format specified in the configuration.
• Pull - Gets new files that match your filters from the remote locations (see configuration).
• Update TitleDB - Force-reloads the latest title database.
• Decompress NSZ - For any NSZ.XCZ files found, uncompresses them to NSP/XCI.
• Compress NSP - For any NSP/XCI files found, compresses them to NSZ/XCZ CPU INTENSIVE.
• Setup GDrive OAuth - See below.

Configuration

The GUI has the ability to set the most common configuration options, see the below images. You can also create a custom configuration by creating conf/nut.conf. The format should mirror nut.default.conf.

The IP/Port/User/Password are the information needed to login to the NUT server. To the right of those, you can also see a USB Status indicator, indicating whether a Tinfoil client is connected via USB with the server.

THe body shows a table containing a list of files that were detected by NUT from the scanned paths. It shows the title count, file name, title ID, title type and title size for each scanned file.

The footer shows the progress information of any file that is currently being downloaded from the server.

Google Drive Integration

NUT has the ability to interact with Google Drive. For this to work, you will need to download a credentials.json, using the guide found here. Once you have this file placed either in NUT's root or conf directory, click the Setup GDrive OAuth button in the GUI and follow the prompts.

You will be able to access your GDrive through Tinfoil via the gdrive:/ protocol after copying credentials.json and token.json to /switch/tinfoil on your microSD card. (This is automatically done if you connect Tinfoil to nut)

Screenshots

Changelog

v3.3 2021/07/15

• Fixed USBFS and USB installs.
• Be sure to use tinfoil_driver.exe with NUT for Tinfoil, NOT manually install the zadig driver.

v3.2 2021/7/15

• Lots of bug fixes, especially with usbfs. Fixed #307.
• Be sure to use tinfoil_driver.exe with NUT for Tinfoil, NOT manually install the zadig driver.

v3.1 2021/02/1

• Fixed start of application due to issue with timestamp.
• Fixed issue #234.
• Fixed adding of remote folders.
• Fixed FTP download.
• Added min/max size filter from the config file.
• EDIT: Attached Windows driver and reg file (only needed once) - identical to v2.7 release.

v3.0 2020/12/19

• Added a lot of cool "new" features for collection management and syncing. Big thanks to introkun for doing much of the work and motivating me to update the project.

v2.7 2020/05/02

• Added button in NUT for setting up gdrive oauth with prompts.
• The registry file increases USB MTP timeouts, to fix failed MTP transfers.

v2.6 2020/02/4

• This is required for Tinfoil 8.0+ but is also backwards compatible with older versions of Tinfoil.
• The USB driver was changed in Tinfoil 8.0, so you must re-install the USB driver. For windows users, tinfoil_driver.exe is included for your convenience. Be sure to have Tinfoil running on your switch and connected to PC via USB before installing the driver. Non-Windows users can use the normal zadig process, be sure to only install to interface 0.

v2.5 2019/12/13

• Changed gdrive api permissions from read only to full so tinfoil can write to the gdrive.

v2.4 2019/11/18

• Fixed network installs failing.

v2.3 2019/11/08

• XCI and XCZ now show up in regular usb:/ and nut:/ scans.
• GDdrive bug fixes, where some folders did not list files correctly.
• USB timeout bug fixes.

v2.2C 2019/10/07

• Added support for scanning NSZ / XCZ compressed formats.

v2.1 2019/09/12

• Nut will authenticate with gdrive if you create a gdrive application, and place its credentials.json file either in nut's root directory, or in the conf directory. You can generate / download credentials.json from https://developers.google.com/drive/api/v3/quickstart/go
• Once this is set up, you can access your gdrive through tinfoil, by using either the usbfs, nutfs, or gdrive protocol. Accessing gdrive while connected to nut will download the credentials so further gdrive authentication will not need to be tethered to Nut.

v2.0 2019/08/04

• Slimmed down, boots much faster, and works better with network attached storage such as google file stream.

v1.2 2019/03/28

• Bugfixes for usbfs and nutfs.

v1.1 2019/02/18

• Scan path is now saved and remembered.
• Web GUI is now works with the windows release.
• Web gui optionally launches at application launch.
• Various bugfixes / enhancements to web gui.
• Fixed display bug where username did not display in gui.
• conf/users.conf is created, and users can edit their username and password there.
• Fixed random error when initializing.

v1.0 2019/02/14

• Windows only. Depedency free GUI for running nut server, and nut usb for installing titles on Tinfoil and SX Installer.

External links

• GitHub - https://github.com/blawar/nut
• GBAtemp - https://gbatemp.net/threads/nut-gui-usb-and-network-installer-for-tinfoil-and-sx-installer.531327/