Giter VIP home page Giter VIP logo

switcheroo's Introduction

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

Installation

Download and install the latest release on the releases page

or install with cargo (binary name is switcheroo)
cargo install switcheroo-nx

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

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.