explaingit

atmosphere-nx/atmosphere

Analysis updated 2026-06-21

19,040C++Audience · developerComplexity · 5/5LicenseSetup · hard

TLDR

A custom firmware for the Nintendo Switch that replaces the console's boot and runtime stack to enable homebrew software, EmuNAND, and advanced system control that Nintendo's stock firmware blocks.

Mindmap

mindmap
  root((Atmosphère))
    What it does
      Custom firmware
      Homebrew support
      EmuNAND
    Tech stack
      C++
      TrustZone
      Switch hardware
    Components
      Bootloader
      Kernel patches
      System modules
    Audience
      Homebrew developers
      Advanced users
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run unofficial homebrew apps and games on a Nintendo Switch

USE CASE 2

Boot a separate emulated copy of the Switch OS so homebrew runs without touching original system storage

USE CASE 3

Add custom kernel modules that extend what the Nintendo Switch operating system can do

What is it built with?

C++

How does it compare?

atmosphere-nx/atmospherecocos2d/cocos2d-xkyleneideck/backgroundmusic
Stars19,04019,00718,938
LanguageC++C++C++
Setup difficultyhardhardmoderate
Complexity5/54/53/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1day+

Requires a hackable Nintendo Switch hardware revision, modifying console firmware may void warranty and carries ban risk.

Free to use and modify, but any modified version you distribute must also be released as open source under the same GPL-2.0 terms.

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
Explain the Atmosphère boot chain and how it replaces each layer from the first-stage bootloader to system modules
Prompt 2
How do I set up EmuNAND with Atmosphère to run homebrew without risking my original Nintendo Switch system?
Prompt 3
Walk me through building Atmosphère from source and copying the output to a Switch SD card
Prompt 4
What C++ techniques does Atmosphère use to intercept Nintendo Switch kernel calls and patch system behavior?

Frequently asked questions

What is atmosphere?

A custom firmware for the Nintendo Switch that replaces the console's boot and runtime stack to enable homebrew software, EmuNAND, and advanced system control that Nintendo's stock firmware blocks.

What language is atmosphere written in?

Mainly C++. The stack also includes C++.

What license does atmosphere use?

Free to use and modify, but any modified version you distribute must also be released as open source under the same GPL-2.0 terms.

How hard is atmosphere to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is atmosphere for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub atmosphere-nx on gitmyhub

Verify against the repo before relying on details.