Platform:Nintendo Switch
| 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
- 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