ROOT / TOOLS / SWITCH

SWITCH 2 / RESEARCH WIZARD 研究段階

Switch 2
setup wizard.

Beta / work in progress. Prepare SmileBASIC and verify each stage; FS execution remains on safety hold.

Switch 2 concept image with a glowing Pi on its screen
Safety holdFS execution is paused while a reported Switch 2 brick is investigated. Do not run NS2 or retry a failed attempt. NXHID preparation remains available; an EmuHub app loader is still under development.
STEP 1 OF 4

Check device

Read these values on your own console. A website cannot detect its firmware or installed games over USB.

No device values confirmed yet.
STEP 2 OF 4

Prepare SmileBASIC

The upstream bootstrap must exist as NS2 in program slot 0. There is no published SmileBASIC download key.

Have an original Switch already running Atmosphère? It can run NXHID 0.1.0 ↗ as a Wi-Fi controlled USB keyboard. This avoids 229 lines of manual typing and changes no Mac security setting. Its author shows a Switch 1 connected to a Switch 2; your exact console transfer still needs a live check.
  1. On the original Switch, launch its FTP server app and note the IP and port it shows. ftpd ↗ commonly uses port 5000. If no FTP app is installed, copy switch/nxhid/nxhid.nro from the official NXHID package ↗ to /switch/nxhid/nxhid.nro on the SD card by your usual method.
  2. In the LAN wizard below, enter that IP and press Install NXHID over FTP. It uploads only the checked NXHID app and reads it back to verify. Then exit a foreground FTP app.
  3. Hold R while opening a game on the original Switch to enter Homebrew Menu in full application mode, then launch NXHID. Keep it open and note the original Switch IP shown on its screen.
  4. Put the Switch 2 in its dock in TV mode and open SmileBASIC's empty program editor in slot 0. Connect Switch 1 USB-C to a USB-A port on the Switch 2 dock using a USB-A-to-USB-C data cable. Wait for Keyboard ready on NXHID; do not send keys while it says waiting for USB host. NXHID's author also reports a direct connection to Switch 2, but neither arrangement is confirmed on your hardware until this status changes.
  5. From this LAN wizard, send a short test line. Confirm it appears correctly on the Switch 2, then erase it and return to the empty slot 0 editor. Send the pinned bootstrap, check the result, and save it as NS2.
Open this page from your LAN companion to use the transfer buttons. The public website cannot reach a private Switch IP.
Other keyboard choices
  1. A regular USB keyboard can be connected through the Switch 2 dock in TV mode, as Nintendo documents. Test it in SmileBASIC Direct mode with PRINT "USB OK"; manually entering the pinned bootstrap.bas ↗ is around 229 lines.
  2. A purpose-built USB HID board can type the file. A browser USB cable alone cannot.
Research option: experimental Apple silicon Mac sender
  1. Get mac2jb ↗ and read its hardware and driver requirements before trying it.
  2. Its locally built USB gadget kernel extension is unsigned. Apple says personal kernel-extension testing on Apple silicon requires disabling SIP and using Permissive Security in Recovery; the published physical test did so. This changes Mac-wide protections and also requires Recovery to restore them. The wizard cannot do it for you.
  3. Only after the driver loads, test hello in an empty SmileBASIC editor. Continue to a full bootstrap transfer only if the text appears on the console.

This sender has been verified on one different Mac model, not on every Apple silicon Mac. See Apple's current kernel-extension guidance ↗.

STEP 3 OF 4

Connect local host

Run the local companion on a Mac, Linux computer, or NAS the console can reach. The public website is the guide; the companion runs the actual upstream host process.

Local companion disconnectedOpen this wizard from the companion to control a session.
LOCAL SETUPgit clone https://github.com/gr33k/switch2loader.git
cd switch2loader
sh scripts/fetch-upstream.sh
node server.mjs
Open LAN wizard
STEP 4 OF 4

FS demo on hold

A reported Switch 2 brick needs a clear failure analysis before this procedure can be recommended. Do not run NS2, enter exploit commands, or retry a failed attempt.

FS execution demoPaused · safety review in progress
General homebrew loaderIn development · no verified public install path
EmuHub client installIn development · requires a verified loader and client package
Safety review in progress. Do not run NS2.
LIVE SESSION

Waiting for local host

Start the local companion, then open its wizard.

Run progress starts when the host reports a stage—
Recent events 0
  1. No session started

What happens on the Switch 2?

01

Prepare the keyboard path

An original homebrewed Switch can run NXHID and act as a USB keyboard. Check a one-line probe in an empty SmileBASIC editor first.

02

Inspect before saving

If you choose to transfer bootstrap.bas, verify its contents on the Switch 2 before saving NS2. Transfer completion alone does not prove correctness.

03

Do not execute

The FS demo is paused. A failed run has no proven safe stop procedure. Do not run NS2, enter exploit commands, or retry a failed attempt while the reported brick is investigated.

04

Wait for a verified path

Host tests and a saved program do not establish physical Switch 2 safety or an EmuHub installation path.