/nx-sd

A lightweight, ready-to-use custom firmware package for the Nintendo Switch.

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

nx-sd

nx-sd is a lightweight, ready-to-use custom firmware package for the Nintendo Switch. It includes everything necessary for launching homebrew and custom NSPs.

Quick Start Guide

  1. Download and extract the latest release of nx-sd.
  2. Copy the contents of the sdcard folder to the root of your microSD card.
  3. Power on your Nintendo Switch in RCM and inject the payload in payload folder.
  4. Atmosphère will boot automatically.

Building

  1. Install devkitARM and devkitA64 toolchains.

  2. Install dependencies

    sudo pacman -S devkitarm-rules switch-curl switch-freetype switch-libconfig switch-libjpeg-turbo switch-sdl2 switch-sdl2_image switch-sdl2_gfx switch-sdl2_ttf switch-zlib
    
  3. Install Python 3.7 or newer.

  4. Clone this repo and all submodules recursively.

    git clone https://github.com/nicoelayda/nx-sd.git --recurse-submodules
    
  5. Run build.py.

Components

Core components

Component Version Description
Atmosphère 0.8.9 Custom firmware for the Nintendo Switch
hekate 4.10.1 Custom Nintendo Switch bootloader
nx-hbloader 2.1 Host process for loading homebrew NROs
nx-hbmenu 3.0.1 The Nintendo Switch homebrew menu

Addons

Component Version Description
Checkpoint 3.6.0 Save manager for the Nintendo Switch