derrekr / fastboot3DS

A homebrew bootloader for the Nintendo 3DS that is similar to android's fastboot.
GNU General Public License v3.0
371 stars 19 forks source link
bootloader homebrew nintendo-3ds

fastboot3DS

A bootloader for the 3DS console, written by derrek, profi200, d0k3

fastboot3DS is a bootloader for the 3DS console, intended to be installed to the FIRM0 partition. It allows you to assign homebrew in .firm format to bootslots, and to chainload bootslots via either a bootmenu or a button combo of your choosing. fastboot3DS also contains basic tools for NAND backups and restores.

fastboot3DS on a real N3DS

Disclaimer

fastboot3DS installs to a critical partition of your system, and thus becomes one of the softwares critical to the functioning of your system. Although having been thoroughly tested, some risk may still remain, especially when fastboot3DS is not used in the way it is intended. In short: we are not responsible for any damage that may occur to your system as a direct or indirect result of you using fastboot3DS.

Quick start guide

These short instructions require you to have a way of booting OpenFirmInstaller. If you already have boot9strap installed, this is as simple as chainloading the OpenFirmInstaller.firm (either via some chainloader of your choosing, or put it on your SD card as sdmc:/boot.firm).

You may also want to set up the other boot slots and assign key combos to them. Keep in mind you need one autoboot slot (= a slot with no key combo assigned). If you want to access the fastboot3DS menu at a later point in time, hold the HOME button when powering on the console. From the fastboot3DS menu, you may continue the boot process via Continue boot, chainload a .firm file via Boot from file..., access the boot menu via Boot menu... or power off the console via the POWER button.

How to build

To compile fastboot3DS you need devkitARM, CTR firm builder and splashtool installed in your system. Additionally you need 7-Zip or on Linux p7z installed to make release builds. Also make sure the CTR firm builder and splashtool binaries are in your $PATH environment variable and accessible to the Makefile. Build fastboot3DS as debug build via make or as release build via make release.

Known issues

This section is reserved for a listing of known issues. At present only this remains:

If you happen to stumble over another bug, please open an issue in the official fastboot3DS repo on GitHub or contact us via other platforms.

License

You may use this under the terms of the GNU General Public License GPL v3 or under the terms of any later revisions of the GPL. Refer to the provided LICENSE.txt file for further information.

Thanks to...

Copyright (C) 2017 derrek, profi200, d0k3