finalize/README.md
2024-03-14 12:38:33 -07:00

2.8 KiB

finalize

Scripts relating to Finalizing Setup on https://3ds.hacks.guide/finalizing-setup.

  • /finalize/: Files that are packed into finalize.romfs
    • /finalize/img: Images used for visual troubleshooting
    • /finalize/finalize.gm9: Script run after finalize_helper.gm9 that:
      • Installs base homebrew applications to SYSNAND SD (see below for list)
      • Copies GodMode9 to CTRNAND (/rw/luma/payloads)
      • Backs up essential.exefs to /gm9/backups
      • Deletes CFW installation files that are no longer necessary
      • Backs up minsize NAND backup to /gm9/backups
    • /finalize/donor.db: Empty title database used for consoles that do not have title database (i.e. no eShop software)
  • finalize_helper.gm9: Script that is compiled as GM9 scriptrunner (finalize_helper.firm); extracts finalize.romfs
  • docs.md: Full error information / script documentation

Bundled software

The following repositories have their compiled builds in this software package:

Releases

Releases are tagged for reference (based on usage in the guide). Releases in this repository are not intended to be for general use. If you want to use them regardless:

  • Clone this repository (latest commit, or a tagged release if you are looking for a specific version)
  • Copy the contents of finalize to the root of your console's SD card
  • Copy finalize.gm9 from the finalize folder to /gm9/scripts/
  • Copy GodMode9.firm from the finalize folder to /luma/payloads/
    • Create any folders that do not exist
    • Luma's boot.firm needs to be on root of SD for this to work

finalize_helper is not necessary unless you intend to use the RomFS build.

Building

You need the following tools installed on your computer:

  • 3dstool
  • devkitARM
    • devkitARM is only required if you are building the FIRM, which you are going to want to anyway
    • Install the 3DS related packages

Clone the repository via the following commands:

git clone https://github.com/hacks-guide/finalize --recurse-submodules
cd finalize

And build:

make

The romfs and FIRM will be present in the builds directory.

License

TBD