Nyx Rescue Mod (Alpha)
Custom Hekate/Nyx build with integrated Atmosphere recovery tools
GitHub Repository
Custom Hekate/Nyx build with integrated Atmosphere recovery tools
GitHub Repository
What is this?
Nyx Rescue Mod is a custom fork of Nyx (the Hekate GUI) that adds several recovery tools intended to help troubleshoot and recover common Atmosphere boot failures directly from Hekate, with no PC required (Step 1 and 2) or limited PC uses.
The goal is to provide a quick first-response toolkit for situations such as:
- Black screen after updating firmware
- Atmosphere fatal errors
- Broken custom themes
- Outdated overlays and sysmodules
- Archive Bit corruption
- Warmboot crash loops
- General Atmosphere boot failures caused by SD card contents
This project currently modifies Nyx primarily through changes in:
Code:
nyx/nyx_gui/frontend/gui_tools.cand a small linker adjustment in:
Code:
nyx/link.ldWARNING — ALPHA SOFTWARE
This release is intended for experienced Switch modders and testers.
Please do NOT install this if you are unfamiliar with:
- Atmosphere
- Hekate
- emuMMC
- Payload injection
- Manual recovery procedures
While the recovery actions are designed to target common causes of boot failures, this software has not yet received extensive testing across different setups.
Always keep backups of:
- BOOT0
- BOOT1
- NAND
- SD Card contents
before testing.
Current Recovery Functions
Step 1 — Fast Purge
Removes known problematic content including:
- Custom Home Menu themes
- Profile page themes
- System Settings customizations
- Lockscreen mods
- Outdated sys-patch installations
- Outdated Tesla Menu components
- Broken uLaunch replacements
- Atmosphere error reports
Step 2 — Advanced System Reset
Additional cleanup actions:
- Removes reboot_payload.bin
- Deletes system_settings.ini
- Cleans cheat VM logs
Step 3 — Reinstall Custom Firmware
Automatically reinstalls Atmosphere and Hekate from packages placed in:
Code:
/bootloader/rescue/Also includes optional installation of:
- nx-ovlloader
- Tesla Menu
- sys-patch
Screenshots
A Small Backstory
This project started as a personal solution rather than a planned public release.
My sister's Switch managed to become unbootable multiple times over the years due to things such as accidental firmware updates, outdated components, and theme-related crashes. After repeatedly walking her through recovery procedures, I decided to automate some of the more common fixes directly inside Nyx. Mostly this project is vibe-coded via Claude and some Gemini as I have very very limited experience as developer.
Eventually the tool grew enough that I thought it might be useful to other members of the community facing similar problems.
Support Expectations
Please note that this is a hobby project developed in my spare time.
I am not an active Switch developer, nor do I work on this project full-time. Development generally happens only when I have free time or encounter a problem worth solving.
I will read bug reports, suggestions, and recovery results whenever possible, but I may not always be able to respond quickly, investigate every issue, or provide technical support for individual setups.
Community feedback is still greatly appreciated, especially reports that include:
- Switch model (V1, V2, Lite)
- sysMMC or emuMMC
- Firmware version
- Atmosphere version
- Steps performed
- Whether the recovery attempt succeeded or failed
Even if I cannot immediately reply, the information may help improve future versions of the project.
GitHub
https://github.com/jiraiya78/nyx-rescue-mod
Source code, build instructions, and future updates will be maintained there.
Thanks to CTCaer and all contributors to Hekate/Nyx for their excellent work.[/CENTER][/CENTER]
