Awesome Open Source
Awesome Open Source


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


Note for Windows users: Enabling "Add Python 3.X to PATH" is NOT required! Python is installed with the py launcher by default.

  1. Dump boot9.bin and movable.sed from a 3DS system.
  2. Install pycryptodomex:
  • Windows: py -3 -m pip install --user --upgrade pycryptodomex
  • macOS/Linux: python3 -m pip install --user --upgrade pycryptodomex
  1. Download the repo (zip link or git clone)
  2. Run with boot9.bin, movable.sed, path to the SD root, and CIA files to install (see Usage section).
  3. Download and use custom-install-finalize on the 3DS system to finish the install.


Linux users must build wwylele/save3ds and place save3ds_fuse in 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_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


Use -h to view arguments.


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


pyctr/ is from ninfs d994c78.

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.

Alternatives To Custom Install
Select To Compare

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (890,046
Install (14,684
Manual (4,293
Automate (3,463
Nintendo (1,982
3ds (1,115