rvtr/unlaunch-installer_dev
1
Fork 0
mirror of https://github.com/rvtr/unlaunch-installer_dev.git synced 2026-01-26 13:43:08 -05:00
Code Issues Actions Packages Projects Releases Wiki Activity
not really known
65 Commits 1 Branch 0 Tags 442 KiB
C 79.8%
C++ 16.7%
Makefile 3.5%
cae02f6607
Go to file
Edoardo Lolletti cae02f6607 Rework install/unlinstall flow 
Restructure the code and use the same approach as the launcher tmd restorer to deal with tmds.
Store all the known tmds for all the launcher versions with their corresponding shas, and use them when restoring the console.
Now if the main tmd isn't either the stock one or one with the patch done by this program, it's treated a invalid and will be restored from the saved ones when uninstalling.
This breaks for now proto/dev consoles as there is no handling for "default tmds" on them and the program logic has to be changed accordingly
2025-08-12 17:42:03 +02:00
.github/workflows Use last pre calico dkp docker image 2025-08-07 21:41:39 +02:00
arm7 Add battery level check 2024-04-27 17:58:24 +02:00
arm9 Rework install/unlinstall flow 2025-08-12 17:42:03 +02:00
nitrofiles Rework install/unlinstall flow 2025-08-12 17:42:03 +02:00
.clangd Update gitignore and add .clangd 2025-08-12 17:35:21 +02:00
.gitattributes Add giattributes 2025-04-29 18:22:35 +02:00
.gitignore Update gitignore and add .clangd 2025-08-12 17:35:21 +02:00
icon.bmp Add new icon 2024-04-28 00:48:02 +02:00
LICENSE.txt Initial NTM sources 2024-04-25 19:13:10 +02:00
Makefile Rework install/unlinstall flow 2025-08-12 17:42:03 +02:00
README.md Prevent the installer from installing on 1.4.2 2024-05-02 01:31:38 +02:00

README.md

"Safe" unlaunch installer

A basic homebrew with a single job, install and uninstall unlaunch from a console.

WARNING

This can modify your internal system NAND! There is always a risk of bricking, albeit small, when you modify NAND. Please proceed with caution.

Features

  • Safety checks to install and uninstall unlaunch without a risk of bricking
  • Fully compatible with older unlaunch installs
  • Works on every DSi, whether it's retail or development
  • Keeps a recovery copy of unlaunch in NAND to protect against future bricks (only on retail consoles)

Notes

This installer comes bundled with a specific version of unlaunch (2.0), but can load a separate unlaunch installer from the root of the sd card, named unlaunch.dsi.

Supported unlaunch versions are 1.8, 1.9 and 2.0, since earlier ones don't work if installed with this new method.

Due to some unforunate version differences, the install method used by this application won't be usable on consoles with firmware 1.4.2 (1.4.3 for china). So installing on consoles that ship that version will be prevented

Differences with official installer

The Nintendo DSi's stage2 has a failsafe where it will load a backup launcher (HNAA) if it can't find the real one (eg. missing, corrupted), even on retail consoles.

The official installer will append itself to the tmd of the "real" launcher. This leaves the console bricked in case of failed install or uninstall (since the backup launcher doesn't exist, stage2 can't save you). The safe unlaunch installer takes advantage of this feature by installing unlaunch to the backup launcher. The official launcher's TMD is "broken" by changing a byte, making stage2 load unlaunch in the backup launcher.

This is safer than normal unlaunch installs because as long as the main TMD isn't touched, the system can't be bricked by those operations (apart from total nand failure), and when the main TMD is tampered with, unlaunch is already there as fallback in case of errors. Uninstalling is also safer as this program only has to restore that previously changed byte to restore the main TMD. This allows to keep backup unlaunch "installed" as general brick protection since it won't interfere with the system. As a bonus, if you sell/trade you console in the future and the new owner uses the official installer, they'll be protected from bricks.

Credits