TUG Switch: Difference between revisions

TUG
TUG
	File:Tugswitch.png
General
Author	nxmango
Type	PC Utilities
Version	1.1
License	MIT License
Last Updated	2019/01/14
Links
	Download
	Website
	Source

Revision as of 05:47, 8 Haziran 2023

TUG is a simple GUI made with PyQt5 which allows you to choose a folder, view the .nsp files it contains and send the header to the Nintendo Switch making it simpler for users to use USB Install (usb_install_pc.py) on Tinfoil.

User guide

Windows Instructions

Download & Install Python 3 from https://www.python.org/downloads/
Install PyQt5.
- pip install pyqt5
Download Zadig from https://zadig.akeo.ie/.
With your Switch plugged in and on the Tinfoil USB install menu, choose "List All Devices" under the options menu in Zadig, and select libnx USB comms.
Choose libusbK from the driver list and click the "Replace Driver" button.
Go to Tinfoil > Title Management > USB Install NSP.
Double-click on tug.pyw.

macOS Instructions

Install Homebrew from https://brew.sh
Install Python 3 from https://www.python.org/downloads/
- sudo mkdir /usr/local/Frameworks
- sudo chown $(whoami) /usr/local/Frameworks
- brew install python
Install PyQt5:
- pip3 install pyqt5
Install PyUSB:
- pip3 install pyusb
Install libusb:
- brew install libusb
Plug in your Switch and go to Tinfoil > Title Management > USB Install NSP.
Double-click on tug.pyw.

Known issues

Disconnecting Nintendo Switch while TUG is running, might results in a crash with error code: 2345-0028 (0x3959).

Changelog

v1.1 2019/01/14

Ability to send multiple times the same header without closing TUG.
- Initial release hanged & crashed Nintendo Switch; this is now fixed!
- Connection is made on startup; TUG won't start if Nintendo Switch is not found.
More precise error messages.
Exceptions for imports (PyUSB & PyQt5).
More stable & cleaner code.

v1.0 2019/01/13

Initial release.
Select a folder.
- All .nsp files will show below the "Select folder" button.
Send header (Tinfoil > Title Management > USB Install NSP).
- Give an error if can't connect to Nintendo Switch.

Credits

Thanks to https://github.com/Adubbz for his work on Tinfoil.

External links

GitHub - https://github.com/nxmango/tug
Reddit - https://www.reddit.com/r/SwitchHaxing/comments/afgdgq/tug_a_tinfoil_usb_gui/

@@ Line 13: / Line 13: @@
 |donation=
 }}
-{{#seo:
+TUG is a simple GUI made with PyQt5 which allows you to choose a folder, view the .nsp files it contains and send the header to the Nintendo Switch making it simpler for users to use USB Install (usb_install_pc.py) on Tinfoil.
-|title=Switch Homebrew PC Tools (PC Utilities) - GameBrew
-|title_mode=append
-|image=tugswitch.png
-|image_alt=TUG
-}}
-{{cleanup|article|Needs cleanup}}
-A Tinfoil USB GUI.
-==Media==
+==User guide==
-<youtube></youtube>
+===Windows Instructions===
+*Download & Install Python 3 from https://www.python.org/downloads/
+*Install PyQt5.
+**<code>pip install pyqt5</code>
+*Download Zadig from https://zadig.akeo.ie/.
+*With your Switch plugged in and on the Tinfoil USB install menu, choose "List All Devices" under the options menu in Zadig, and select libnx USB comms.
+*Choose libusbK from the driver list and click the "Replace Driver" button.
+*Go to Tinfoil > Title Management > USB Install NSP.
+*Double-click on tug.pyw.
+===macOS Instructions===
+*Install Homebrew from https://brew.sh
+*Install Python 3 from https://www.python.org/downloads/
+**<code>sudo mkdir /usr/local/Frameworks</code>
+**<code>sudo chown $(whoami) /usr/local/Frameworks</code>
+**<code>brew install python</code>
+*Install PyQt5:
+**<code>pip3 install pyqt5</code>
+*Install PyUSB:
+**<code>pip3 install pyusb</code>
+*Install libusb:
+**<code>brew install libusb</code>
+*Plug in your Switch and go to Tinfoil > Title Management > USB Install NSP.
+*Double-click on tug.pyw.
-==Screenshots==
+==Known issues==
-https://dlhb.gamebrew.org/switchhomebrews/tugswitch-01.png
+Disconnecting Nintendo Switch while TUG is running, might results in a crash with error code: 2345-0028 (0x3959).
-https://dlhb.gamebrew.org/switchhomebrews/tugswitch-02.png
-https://dlhb.gamebrew.org/switchhomebrews/tugswitch-03.png
-https://dlhb.gamebrew.org/switchhomebrews/tugswitch-04.png
-https://dlhb.gamebrew.org/switchhomebrews/tugswitch-05.png
-https://dlhb.gamebrew.org/switchhomebrews/tugswitch-06.png
-https://dlhb.gamebrew.org/switchhomebrews/tugswitch-07.png
-https://dlhb.gamebrew.org/switchhomebrews/tugswitch-08.png
 ==Changelog==
-'''v.1.0'''
+'''v1.1 2019/01/14'''
-* First Release.
+*Ability to send multiple times the same header without closing TUG.
+**Initial release hanged & crashed Nintendo Switch; this is now fixed!
+**Connection is made on startup; TUG won't start if Nintendo Switch is not found.
+*More precise error messages.
+*Exceptions for imports (PyUSB & PyQt5).
+*More stable & cleaner code.
+'''v1.0 2019/01/13'''
+*Initial release.
+*Select a folder.
+**All .nsp files will show below the "Select folder" button.
+*Send header (Tinfoil > Title Management > USB Install NSP).
+**Give an error if can't connect to Nintendo Switch.
+==Credits==
+Thanks to https://github.com/Adubbz for his work on Tinfoil.
 == External links ==
-* Gbatemp - https://github.com/nxmango/tug
+* GitHub - https://github.com/nxmango/tug
-* Github - https://github.com/nxmango/tug
+* Reddit - https://www.reddit.com/r/SwitchHaxing/comments/afgdgq/tug_a_tinfoil_usb_gui/
-* Reddit -