mirror of https://github.com/ihaveamac/custom-install.git synced 2025-12-06 06:41:45 +00:00

Go to file

Ian Burgwin 8d3e09cc29 README: update

* Link to guide to dump boot9/movable.sed.
* Link to Setting_up_Development_Environment on 3dbrew. No need for
  duplicate instructions here.

2019-11-12 12:10:29 -08:00

bin

bin: update save3ds

2019-11-12 12:03:57 -08:00

finalize

finalize: update for new cifinish.bin without titlekey, check cifinish version and print error if mismatched

2019-11-12 00:55:36 -08:00

pyctr

pyctr: update

2019-11-12 00:29:11 -08:00

.gitignore

gitignore: update

2019-11-12 00:54:55 -08:00

.pylintrc

Module rewrite, rewritten terminal tool

2019-11-05 22:27:45 -05:00

custominstall.py

custominstall: remove titlekey from cifinish.bin, make --boot9 optional

2019-11-12 00:34:33 -08:00

gui-custominstall.py

GUI

2019-11-10 18:43:21 -05:00

LICENSE.md

initial commit

2019-09-06 14:22:13 -07:00

README.md

README: update

2019-11-12 12:10:29 -08:00

requirements.txt

GUI

2019-11-10 18:43:21 -05:00

README.md

custom-install

Experimental script to automate the process of a manual title install for Nintendo 3DS. Originally created late June 2019.

Summary

Dump boot9.bin and movable.sed from a 3DS system.
Install the packages:

Windows: py -3 -m pip install --user -r requirements.txt
macOS/Linux: python3 -m pip install --user -r requirements.txt

Download the repo (zip link or git clone)
Run custominstall.py with boot9.bin, movable.sed, path to the SD root, and CIA files to install (see Usage section).
Download and use custom-install-finalize on the 3DS system to finish the install.

Setup

Linux users must build wwylele/save3ds and place save3ds_fuse in bin/linux. Just install rust using rustup, then compile with: cargo build. Your compiled binary is located in target/debug/save3ds_fuse, copy it to bin/linux.

movable.sed is required and can be provided with -m or --movable.

boot9 is needed:

-b or --boot9 argument (if set)
BOOT9_PATH environment variable (if set)
%APPDATA%\3ds\boot9.bin (Windows-specific)
~/Library/Application Support/3ds/boot9.bin (macOS-specific)
~/.3ds/boot9.bin
~/3ds/boot9.bin

A SeedDB is needed for newer games (2015+) that use seeds.
SeedDB is checked in order of:

--seeddb argument (if set)
SEEDDB_PATH environment variable (if set)
%APPDATA%\3ds\seeddb.bin (Windows-specific)
~/Library/Application Support/3ds/seeddb.bin (macOS-specific)
~/.3ds/seeddb.bin
~/3ds/seeddb.bin

custom-install-finalize

custom-install-finalize installs a ticket, plus a seed if required. This is required for the title to appear and function.

This can be built as most 3DS homebrew projects with devkitARM.

Usage

Use -h to view arguments.

Examples:

py -3 custominstall.py -b boot9.bin -m movable.sed --sd E:\ file.cia file2.cia
python3 custominstall.py -b boot9.bin -m movable.sed --sd /Volumes/GM9SD file.cia file2.cia
python3 custominstall.py -b boot9.bin -m movable.sed --sd /media/GM9SD file.cia file2.cia

License/Credits

pyctr/ is from ninfs 795373d.

save3ds by wwylele is used to interact with the Title Database (details in bin/README).

Thanks to @BpyH64 for researching how to generate the cmacs.