CtrBootManager 3DS

CtrBootManager is a boot manager for some 3DS homebrew applications, like HBL and CFW.

It is a boot manager/loader, mainly for the HomeMenuHax but it should also work from homebrew menu (for loading arm9 payloads for example).

Note: This homebrew will not run ninjhax 1 or current CFW on 9.3+.

Features

For 3DS with fw <= 9.2.
Allows you to configure boot entries (arm9 payload *.bin/dat, tested with rxTools code.bin and homebrew menu boot.3dsx) in a configuration file to be booted automatically, with a specified timer.
Can boot some arm9 payload *.bin/dat or .3dsx files from a simple file manager if needed.
Can receive/execute .3dsx files from network (3dslink).

Installation

Installing

Install HomeMenuHax, preferably the automatic one (no button to press for booting).

Edit boot.cfg to suits your needs (be careful to errors).

Copy boot.3dsx and boot.cfg to the root of your SD card.

Custom backgrounds

Images need to be in .bgr bin format. You can use this website to convert image (thanks to Flat).

This can also be accomplished with image magick using the convert command and then rotating the image 90 degrees.

convert yourimg.png -channel BGR -separate -channel RGB -combine -rotate 90 yourimg.rgb

Place it on your sdcard and edit your config to the path of the image.

boot.cfg sample.

Building

Dependencies:

devkitpro-4.5 at least (ctrulib-1.0 at least)
libconfig in portlibs (tried with v1.5)

The recommended way:

mkdir build/
cd build/
cmake -DCMAKE_TOOLCHAIN_FILE=../DevkitArm3DS.cmake ../
make Binaries should now be in the build folder.

Media

CtrBootManager presentation (French) (Ooggle)

Known issues

Please see https://github.com/Cpasjuste/CtrBootManager/issues.

Changelog

v1.9

Added return to homemenu (needs ninjhax >= 2.6).

v1.8

Added arm9 netloader (nc 192.168.1.2 80 < arm9.bin).
Updated to latest ctrulib + hax.

v1.7

Fix ui when no theme section found in cfg.

v1.6

Fix file browser.
Add reboot/shutdown items to config.

v1.5

Minor fixes and improvements.

v1.4

Adds support for user images as a background (thanks Flat).

v1.3

Add colors to configuration file
Fix override button not working when timeout > 0 (thanks Aroth).
Add old ctrulib as submodule (fix CakeBrah).
Add old CakeBrah as submodule (fix CakeBrah).

v1.2

Change font.

v1.1

Add ("key") option to override autoboot entry.

v1.0

Add boot menu entry from the file manager (X) (.3dsx only).
Remove boot menu entry from boot menu (X).
Add a few more help/information to the bottom screen.

b09

Add simple boot configuration screen ("More... -> Settings" menu).
(Re-re-re-re) fix netloading code.

b08

Fix broken wifi on a lot of 3dsx.
Fix booting some 3dsx.
Added 3dsx descriptor support (xml).
Fix 3dsx netload.
Updated to latest ctrulib.

b07

Add "autobootfix" option to config.cfg file.
Fix a bug when more than 22 files are in a directory (filer).

b06

Added colored ui.
Alphasort files/dirs in filer.
Filter out .3dsx, .bin, .dat in filer.
Fix 3dsx loading (was broken after multiple launch).
Few fix and improvements.

b05

Fixed autoboot.
Fixed booting of arm9 payload from filer (which doesn't require specific offset).

b04

Fixed some .3dsx not booting.

b03

Added reboot and power off.
Added 3dsx netloader (use 3dslink), thanks smea.
Added recovery button to config.cfg (to be used when timeout=0).
Various menu changes cleanup and bug fixes.

b02

Fix cake-cfw loading.
Fix screen corruption.
Added arm9 offset in config file.

Credits

For contributions to hb_menu:

smea - Code.
GEMISIS - Code.
fincs - Code.
mtheall - Code.
Fluto - Graphics.
Arkhandar - Graphics.
dotjasp - Graphics (regionfree icon).

Readme by gemarcano This project also uses Brahma. See its repository for its credits.

External links