explaingit

atmosphere-nx/atmosphere

★ 19,055C++Audience · developerComplexity · 5/5ActiveLicenseSetup · hard

TLDR

Custom firmware for Nintendo Switch that replaces the stock OS to enable homebrew apps, advanced control, and system modifications.

Mindmap

mindmap
  root((Atmosphère))
    What it does
      Custom firmware
      Homebrew support
      System control
    Architecture
      Bootloader
      TrustZone
      EmuNAND
      Kernel modules
    Use cases
      Run unofficial apps
      Advanced OS control
      Separate OS instance
    Audience
      Console modders
      Homebrew developers
      Advanced users

Things people build with this

USE CASE 1

Run homebrew games and applications on your Nintendo Switch that aren't available through the official store.

USE CASE 2

Create a separate virtual OS instance (EmuNAND) to test mods and custom software without risking your original system.

USE CASE 3

Develop and test custom system modules and kernel extensions for the Switch platform.

Tech stack

C++ARM assemblyNintendo Switch hardware

Getting it running

Difficulty · hard Time to first run · 1day+

Requires Nintendo Switch hardware, specialized flashing tools, and deep knowledge of ARM assembly and bootloader exploitation.

Use and modify freely under GPLv2; any distributed modifications must also be open-source and include the license.

In plain English

Atmosphère is a custom firmware for the Nintendo Switch gaming console. Firmware is the low-level software baked into a device that controls how it starts up and what operating system features are available. By replacing parts of the Switch's original firmware, Atmosphère gives users access to features and capabilities that Nintendo's stock software does not allow. It is built as a collection of layered components, each replacing a different part of the system's boot and runtime stack: a custom first-stage bootloader, a modified security processor (TrustZone), virtualized storage so you can run a separate copy of the operating system without touching the original (called EmuNAND), custom system modules that extend what the kernel can do, and application-level patches. Together these layers form a complete custom operating environment. You would use Atmosphère if you want to run homebrew software (unofficial apps and games) on your Nintendo Switch, or if you need advanced control over the device's operating system. It is a technically complex, work-in-progress project written in C++ and licensed under GPLv2, intended for users who understand the risks of modifying console firmware.

Copy-paste prompts

Prompt 1
How do I set up Atmosphère on my Nintendo Switch to run homebrew games?
Prompt 2
Explain how EmuNAND works in Atmosphère and why you'd want to use it instead of modifying the original firmware.
Prompt 3
What are the main components of Atmosphère's architecture and what does each layer do?
Prompt 4
How do I develop a custom system module or kernel patch for Atmosphère?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.