Homebrew Launcher (PegaSwitch)


'Tis guide currently be out 'o date, 'n it has been 'tis way fer quite some time. 'Tis be a result 'o me bein' extremely busy wit' me courses as 'o late. 'Tis guide gunna be updated straightaway when I've th' ability, but 'til then ye oughtta follow th' NH Switch Guide (only in th' English 'o landlubbers) fer more updated instruction.


Required Readin’

On firmwares 1.0.0 - 2.3.0, th’ Homebrew Launcher currently be “installed” to ye device usin’ a script ran through PegaSwitch.

‘Tis gunna be allowin’ ye to access th’ Homebrew Launcher through th’ Album application, but only ‘til ye device be rebooted. After it be rebooted, ye gotta be rerunnin’ th’ script to restore Homebrew Launcher functionality.

After a reboot, ye gunna need to be re-runnin’ ‘tis secondary exploit in order to re-enable Homebrew Launcher access on ye device. Additionally, note that ‘tis secondary exploit gunna also prevent ye from playin’ retail games fer as long as it remains active (meanin’ ‘til ye device be rebooted).

If ye be familiar wit’ iOS devices’ “jailbreaking”, ‘tis idea could be thought analogous to a “tethered jailbreak”.

Note that although these instructions work fine on firmware version 3.0.0, it be far easier instead fer 3.0.0 users to be followin’ Homebrew Launcher (Installer).

What ye need

  • Firmware 1.0.0: Th’ 1.0.0 release ‘o nx-hbmenu (th’ latest nx-hbmenu currently crashes on 1.0.0)
  • Firmware 2.0.0 - 2.3.0: Th’ latest release ‘o nx-hbmenu
  • Th’ latest version ‘o PegaSwitch
  • Th’ latest version ‘o node.js
  • hbl.nsp
  • nsp.js

Instructions

Section I - Set th’ sails (prep work)

  1. Power off ye device
  2. Insert ye SD card into ye computer
  3. Copy hbmenu.nro from th’ nx-hbmenu .zip to th’ root ‘o ye SD card
  4. Copy hbl.nsp to th’ root ‘o ye SD card
  5. Create a folder named switch on th’ root ‘o ye SD card if it does not already exist
  6. Reinsert ye SD card into ye device
  7. Power on ye device

Section II - PegaSwitch Configuration

  1. After downloadin’ th’ latest version ‘o PegaSwitch, copy nsp.js to PegaSwitch/usefulscripts
  2. Start CMD / Terminal, ‘n cd to th’ PegaSwitch folder
  3. Run npm install; ‘tis gunna be installin’ th’ node modules that PegaSwitch depends on
  4. Start PegaSwitch by runnin’ th’ command correspondin’ to ye operatin’ system
    • Linux/macOS: Run sudo node start.js ‘n make note ‘o th’ IP address it displays
    • Windows: Run node start.js ‘n make note ‘o th’ IP address it displays
  5. Press Ctrl+C twice to exit PegaSwitch

Section III - DNS Configuration

Note that these DNS servers gunna need to be set on each network ye device connects to, in order fer it to be able to trigger th’ exploit.

  1. Launch System Settin’s
  2. Navigate to Internet -> Internet Settings
  3. Select ye current network
    • ‘Tis be signified by a green check mark next to th’ network
  4. Select “Change Settings”
  5. Set “DNS Settings” to “Manual”
  6. Set “Primary DNS” ‘n “Secondary DNS” to th’ IP address displayed by PegaSwitch
    • ‘Tis usually be takin’ th’ form ‘o 192.168.1.XXX
  7. Save th’ network settin’s
  8. Exit System Settin’s

Section IV - Initial Installation

Note that ye gunna have to re-run ‘tis section ‘o th’ exploit after each reboot in order to re-enable access to th’ Homebrew Launcher.

Option i - Firmware Version 1.0.0

Note that ‘tis option be only applyin’ to devices wit’ firmware version 1.0.0; if ye have firmware versions 2.0.0 - 2.3.0, scroll down to “Option ii - Firmware Versions 2.0.0 - 2.3.0”.

Note that firmware 1.0.0 currently requires a Japanese copy ‘o Puyo Puyo Tetris S in order to be connectin’ to PegaSwitch fer th’ first time. After that, an alternative method ‘o connectin’ to PegaSwitch gunna become available.

  1. Ensure that ye firewall does not block incomin’ connections to UDP port 53 or TCP ports 80 ‘n 8100
  2. Launch PegaSwitch in ye terminal/command prompt by typin’ sudo node start.js --webapplet
  3. Launch Puyo Puyo Tetris S on ye device
  4. Press A, ‘n then press R
  5. Press A ‘n touch th’ menu item at th’ very bottom labelled “お問い合わせ先”
  6. Touch th’ SEGA logo in th’ bottom-left corner; ‘tis gunna be launchin’ th’ webapplet ‘n load th’ PegaSwitch webpage.
  7. PegaSwitch on ye PC should be showin’ that ye device has connected. It also gunna show ye device’s firmware version ‘n MAC address in th’ prompt.
  8. In PegaSwitch on ye computer, type evalfile usefulscripts/nsp.js
  9. Press th’ Home button to exit
  10. Launch th’ Album applet
  11. If th’ exploit was successful, th’ Homebrew Launcher gunna launch
Option ii - Firmware Versions 2.0.0 - 2.3.0

Note that ‘tis option be only applyin’ to devices wit’ firmware versions 2.0.0 - 2.3.0; if ye have firmware version 1.0.0, scroll up to “Option i - Firmware Versions 1.0.0”.

  1. Launch PegaSwitch in ye terminal/command prompt by typin’ sudo node start.js
  2. Navigate to Internet -> Internet Settings
  3. Select ye current network
  4. Select “Connect to this Network”
  5. If th’ DNS connection was successful, ye gunna be seein’ th’ message “Registration is required to use this network.”
  6. Select “Next”
  7. The PegaSwitch webpage gunna load
  8. PegaSwitch on ye PC should be showin’ that ye device has connected. It also gunna show ye device’s firmware version ‘n MAC address in th’ prompt.
  9. Run evalfile usefulscripts/nsp.js
  10. Press th’ Home button to exit
  11. Launch th’ Album applet
  12. If th’ exploit was successful, th’ Homebrew Launcher gunna launch

Section V - Fake News (Optional)

As ye must re-run th’ “Initial Installation” section ‘o th’ exploit after each reboot, ye probably desire a more convenient way ‘o connectin’ to PegaSwitch.

Luckily, we got th’ ability to install a fake entry into th’ News applet (via an exploit dubbed “Fake News”) which can make connectin’ to PegaSwitch much easier.

Note that modifyin’ system save data can brick ye device permanently if ye do not be careful! It be strongly recommended that ye avoid editin’ th’ installFakeNews.js script so that ye may avoid damagin’ ye device.

  1. To begin th’ process, connect ye device to PegaSwitch as in Section III
  2. Once connected to PegaSwitch, run evalfile usefulscripts/installFakeNews.js ‘n be waitin’ fer it to finish
  3. Reboot ye device, ‘n ye should see a PegaSwitch news entry
  4. To trigger Fake News, start PegaSwitch on ye PC wit’ sudo node start.js --webapplet. Then select th’ Fake News entry on ye device, ‘n tap to open th’ “video”

Note that, currently, homebrew development be in a very early state wit’ a very limited number ‘o applications.

Ye can find available applications on switchbrew, /r/SwitchHacks on reddit, or Switch Homebrew on GBAtemp.

To be installin’ homebrew applications, simply copy th’ homebrew .nro file to th’ /switch/ folder on ye SD card.


Ye can now launch th’ Homebrew Launcher by launchin’ th’ Album application from ye device’s home menu (‘til ye device be rebooted).

Ye gunna now be unable to launch retail cartridge ‘n eShop games (‘til ye device be rebooted).

Ye gunna be needin’ to re-run evalfile usefulscripts/nsp.js wit’ PegaSwitch (usin’ any browser applet) after each reboot, in order to re-enable Homebrew Launcher access on ye device.

Fer regular homebrew ‘n development progress summaries, ye can be checkin’ th’ ReSwitched Weekly blog regularly.

Fer information on contributin’ to homebrew development as a developer, check out th’ Homebrew Development page.