hacks-guide/finalize
1
0
Fork 0
mirror of https://github.com/hacks-guide/finalize.git synced 2024-11-23 00:59:39 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
Scripts relating to Finalizing Setup on https://3ds.hacks.guide/finalizing-setup
33 Commits 1 Branch 8 Tags 10 MiB
Makefile 100%
070435246d
Go to file
TophattedWasTaken 070435246d
Remove the new MSET9 files
2024-09-17 17:15:33 -05:00
.github/workflows workflow: Pin devkitARM Docker to 20240202 revision 2024-05-22 09:03:16 -07:00
GodMode9@f611b31c0c Add GodMode9 as submodule 2024-03-14 11:48:06 -07:00
romfs/finalize Remove the new MSET9 files 2024-09-17 17:15:33 -05:00
.gitignore gitignore: add venv 2024-05-19 13:05:12 -07:00
.gitmodules Add GodMode9 as submodule 2024-03-14 11:48:06 -07:00
docs.md update docs for 1.8.0 2024-04-07 18:29:21 +02:00
finalize_helper.gm9 add support images, increment helper version 2024-04-07 06:36:07 +02:00
Makefile make: x_finalize_helper.firm 2024-08-14 01:23:20 +02:00
README.md docs/readme: update links & info 2024-03-15 00:32:18 +01:00

README.md

finalize

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

  • /romfs/finalize/: Files that are packed into finalize.romfs
    • /romfs/finalize/img: Images used for visual troubleshooting
    • /romfs/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
    • /romfs/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, you have two options:

Automatically built binaries

Binaries are automatically built by GitHub Actions. Place finalize_helper.firm in /luma/payloads/ and finalize.romfs on root of SD.

Manual file placement

  • Clone this repository (latest commit, or a tagged release if you are looking for a specific version)
  • Copy the contents of finalize (inside of the romfs folder) 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

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 do 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