Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Platform:Nintendo Switch

From ReverseEngineering.wiki
Platform
Vendor Nintendo
Versions Switch, Switch Lite, Switch OLED
On this wiki Facts · Code · Notes · Topics

Nintendo's hybrid console (2017): an NVIDIA Tegra X1 (AArch64 Cortex-A57) running the Horizon OS microkernel with system services in separate processes. Homebrew-visible executables are NRO (user homebrew) and NSO (system and game modules), with NACP application metadata.

Overview

Game code is a set of NSO modules (rtld, main, sdk, subsdk0..9) inside an NCA program section (Format:NSO). Homebrew is a single Format:NRO launched by the Homebrew Loader; both start with a MOD0 header (Format:NRO#MOD0). Application title and author live in Format:NACP. Services are reached through IPC over svcSendSyncRequest; Library:libnx has wrappers and headers for hundreds of them.

Container formats (public structure only)

Pages for the container formats: Format:PFS0 and HFS0 (NSP packages, ExeFS, HFS0 partitions), Format:XCI (game card image), Format:NCA (content archive), Format:RomFS (Switch), Format:NPDM (process metadata), Format:KIP1 (kernel initial processes). Only public header layouts are documented on this wiki, and nothing about keys.

An NCA is stored with an encrypted header: after decryption the 0xC00-byte header has the magic NCA3 (or NCA2) at 0x200 after two 0x100-byte signatures (read in Atmosphere's fssystem_nca_header.hpp and hactool's nca.h), but the magic is not visible in a stored file.

Related

Decompilation projects: Software:The Legend of Zelda: Breath of the Wild, Software:Super Mario Odyssey (see Format:NSO#Address mapping in decompilation projects).

Code & repositories

Library:libnx.

  • https://github.com/switchbrew/libnx @ 20cbcfd90567f7bf84df7725f27e345e2164fa6b · license: ISC
    libnx: nx/include/switch/nro.h (NRO), nacp.h (NACP), nx/source/runtime/dynamic.c (MOD0), switch_crt0.s (entry convention).
    Tested on: source read, not run: source read · checked 2026-10-18; last activity 2026-10-14