Go to file
Michael Scire b7ec64ea16 fs.mitm: add and use memlet module to temporarily steal applet memory while building romfs images.
Starting in 20.0.0, the browser needs more applet memory to function, so we can't steal as much any more.
Thus, we now steal 14 MB on 20.0.0+ instead of 40MB.

However, since this reduces memory available for custom system modules, we are adjusting to compensate.
ams.mitm's heap size has been reduced from 32MB to 12MB (recovering 20MB).
In addition, fs.mitm now uses a new mechanism for stealing memory from the applet pool while romfs is being built.

On net, we are compromising:
    * Custom sysmodules lose memory available to them.
        On 19.0.0/AMS 1.8.0, there was 30 MB available for custom sysmodules.
        Stealing 14 MB instead of 40 MB, we lose 26 MB of that. Reducing ams.mitm's usage will gain us back 20.
        Nintendo also appears to...use 4 extra MB, in 20.0.0, from my test homebrew.
        So on 20.0.0/AMS 1.9.0, there should be 20 MB available for custom sysmodules.
        On the bright side, on <20.0.0/AMS 1.9.0, I guess there will be 50 MB available for custom sysmodules now?
    * totk mods will lose the ability to...put every file in the romfs on sd card. There will be some unknown maximum filecount for totk mods.
        On the bright side, implementing the transient memory stealing should improve compatibility for some mods which strictly add files?
2025-05-09 11:55:21 -07:00
.github/ISSUE_TEMPLATE Update issue template to ask whether sysmmc or emummc. 2021-05-12 08:27:21 -07:00
config_templates kern/strat: update for new DebugFlags capability semantics 2024-10-15 21:48:59 -07:00
docs Add extensions to dmnt cheat virtual machine (#2479) 2025-01-09 19:38:59 -07:00
emummc emummc: fix offsets for 20.0.0-exfat 2025-05-09 11:55:21 -07:00
exosphere fusee/exo/ams: update with new keydata/version enums 2025-05-09 11:55:21 -07:00
fusee fusee/exo/ams: update with new keydata/version enums 2025-05-09 11:55:21 -07:00
img utils: add script for inserting custom image into package3 2021-09-06 16:26:50 -07:00
libraries fs.mitm: add and use memlet module to temporarily steal applet memory while building romfs images. 2025-05-09 11:55:21 -07:00
mesosphere kern: update synchronous exception handlers to assume FAR validity on TLB conflict 2025-05-09 11:55:21 -07:00
stratosphere fs.mitm: add and use memlet module to temporarily steal applet memory while building romfs images. 2025-05-09 11:55:21 -07:00
tests strat: add windows socket api, linux/macos TODO 2022-03-27 14:36:31 -07:00
thermosphere build: remove unnecessary g-dwarf4 flags 2022-02-14 14:58:52 -08:00
troposphere ams: build with -std=gnu++23 2024-06-01 22:36:37 -07:00
utilities erpt: update ids for 20.0.0 2025-05-09 11:55:21 -07:00
.gitattributes linguist: add vanity corrections 2021-09-11 20:03:42 -07:00
.gitignore util: update function dtors, update gitignore 2022-03-21 17:21:44 -07:00
.gitmodules Remove boost submodule 2019-12-08 16:27:45 -08:00
atmosphere.mk fs.mitm: add and use memlet module to temporarily steal applet memory while building romfs images. 2025-05-09 11:55:21 -07:00
LICENSE Add license and disclaimer. 2018-01-17 23:54:38 -08:00
Makefile ams: support building unit test programs on windows/linux/macos 2022-03-21 17:21:44 -07:00
README.md readme: sept has not been in the project for many years 2025-05-09 11:55:21 -07:00

Banner

License Chat on Discord

Atmosphère is a work-in-progress customized firmware for the Nintendo Switch.

Components

Atmosphère consists of multiple components, each of which replaces/modifies a different component of the system:

  • Fusée: First-stage Loader, responsible for loading and validating stage 2 (custom TrustZone) plus package2 (Kernel/FIRM sysmodules), and patching them as needed. This replaces all functionality normally in Package1loader/NX Bootloader.
  • Exosphère: Customized TrustZone, to run a customized Secure Monitor
  • Thermosphère: EL2 EmuNAND support, i.e. backing up and using virtualized/redirected NAND images
  • Stratosphère: Custom Sysmodule(s), both Rosalina style to extend the kernel/provide new features, and of the loader reimplementation style to hook important system actions
  • Troposphère: Application-level Horizon OS patches, used to implement desirable CFW features

Licensing

This software is licensed under the terms of the GPLv2, with exemptions for specific projects noted below.

You can find a copy of the license in the LICENSE file.

Exemptions:

  • Nintendo is exempt from GPLv2 licensing and may (at its option) instead license any source code authored for the Atmosphère project under the Zero-Clause BSD license.

Credits

Atmosphère is currently being developed and maintained by SciresM, TuxSH, hexkyz, and fincs.
In no particular order, we credit the following for their invaluable contributions:

  • switchbrew for the libnx project and the extensive documentation, research and tool development pertaining to the Nintendo Switch.
  • devkitPro for the devkitA64 toolchain and libnx support.
  • ReSwitched Team for additional documentation, research and tool development pertaining to the Nintendo Switch.
  • ChaN for the FatFs module.
  • Marcus Geelnard for the bcl-1.2.0 library.
  • naehrwert and st4rk for the original hekate project and its hwinit code base.
  • CTCaer for the continued hekate project's fork and the minerva_tc project.
  • m4xw for development of the emuMMC project.
  • Riley for suggesting "Atmosphere" as a Horizon OS reimplementation+customization project name.
  • hedgeberg for research and hardware testing.
  • lioncash for code cleanup and general improvements.
  • jaames for designing and providing Atmosphère's graphical resources.
  • Everyone who submitted entries for Atmosphère's splash design contest.
  • All those who actively contribute to the Atmosphère repository.