#cli #utilities #rcm

app switcheroo-nx

A cross platform CLI and GUI for the Nintendo Switch RCM exploit

1 unstable release

Uses new Rust 2021

0.2.1 Aug 2, 2022

#1331 in Command line utilities

GPL-2.0-or-later

2MB
2K SLoC

Rust 1.5K SLoC // 0.0% comments BASH 154 SLoC Shell 77 SLoC // 0.2% comments

Switcheroo

License GitHub Workflow Status GitHub Workflow Status

A cross platform CLI and GUI for the RCM BootRom exploit (Fusée Gelée exploit for Nintendo Switch)

Only works on unpatched Switches: https://ismyswitchpatched.com/

Written in Rust using clap for the CLI and egui for the GUI.

Features

  • CLI interface
  • GUI interface
  • Works on MacOS, Linux, and Windows
  • A favorites tab for saving payloads

Command Line Interface Example


Graphical User Interface Example

Usage

The binary name is switcheroo

To display application use switcheroo help
Use switcheroo <subcommand> help for help with that subcommand.

Examples

Execute a payload.
switcheroo execute <path>

Check if the switch is connected.
switcheroo device

Start the GUI.
switcheroo gui

Troubleshooting

Linux: Permission denied error

On many linux systems the usb control is blocked by default.

This can be fixed by adding the following file:
/etc/udev/rules.d/99-switch.rules
with the following content:

SUBSYSTEM=="usb", ATTRS{idVendor}=="057e", ATTRS{idProduct}=="3000", MODE="0666"
SUBSYSTEM=="usb", ATTRS{idVendor}=="0955", ATTRS{idProduct}=="7321", MODE="0666"

then reload the udev rules:
sudo udevadm control --reload-rules

Finally unplug and plug back in the switch.

Linux: Flatpak not detecting Switch

Due to a limitation of flatpak not allowing access to udev, the flatpak version only works if the Switch is already in rcm mode and plugged in when it is launched. If the application is launched without these conditions being met, it will never show RCM OK

Windows: Wrong driver error

On windows the rcm connection will only work if the Switch is using the libusbK drivers.
The easiest way to install them is to plug in the switch in RCM mode and use zadig to install the correct driver

Similar projects

Here are some other similar projects

Credit

Implementation is largely based on the following reference implementation: Fusee Launcher
Gui design inspired from the great: TegraRcmGui

License

GPL-2.0 License

Dependencies

~14–27MB
~456K SLoC