CtrBootManager 3DS: Difference between revisions

Revision as of 06:57, 21 July 2021

CtrBootManager, or CTR Boot Manager, 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

Dependencies

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

Building

The recommended way:

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

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 SD card and edit your config to the path of the image, boot.cfg sample.

A collection of custom backgrounds is available from the discussion thread.

Controls

A - Launch

X - Remove entry

Screenshots

Custom background by Mythrandir (left) and Anibal Pacheco (right)

Custom theme by Columbo2811

Custom theme by tilkimelek

Media

CtrBootManager - custom boot demo presentation (French) (Ooggle)

CtrBootManager theme compilation (Rohul1997)

New 3ds XL - Coldboot rxtools + ctrbootmanager (Rocco Antonio Cannale)

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

@@ Line 7: / Line 7: @@
 | author = Cpasjuste
 | website = https://github.com/Cpasjuste/CtrBootManager
-| download = https://dlhb.gamebrew.org/3dshomebrew
+| download =
-| source = https://dlhb.gamebrew.org/3dshomebrew
+| source = https://github.com/Cpasjuste/CtrBootManager
 }}
@@ Line 24: / Line 24: @@
 ==Installation==
+===Dependencies===
+* devkitpro-4.5 at least (ctrulib-1.0 at least)
+* libconfig in portlibs (tried with v1.5)
+===Building===
+The recommended way:
+* <code>mkdir build/</code>
+* <code>cd build/</code>
+* <code>cmake -DCMAKE_TOOLCHAIN_FILE=../DevkitArm3DS.cmake ../</code>
+* <code>make</code> Binaries should now be in the <code>build</code> folder.
 ===Installing===
 Install [https://github.com/yellows8/3ds_homemenuhax HomeMenuHax], preferably the automatic one (no button to press for booting).
@@ Line 41: / Line 52: @@
 A collection of custom backgrounds is available from the [https://gbatemp.net/threads/ctrbootmanager-backgrounds-collection-scripts.412013 discussion thread].
-===Building===
-===Dependencies===
-* devkitpro-4.5 at least (ctrulib-1.0 at least)
-* libconfig in portlibs (tried with v1.5)
-The recommended way:
-* <code>mkdir build/</code>
-* <code>cd build/</code>
-* <code>cmake -DCMAKE_TOOLCHAIN_FILE=../DevkitArm3DS.cmake ../</code>
-* <code>make</code> Binaries should now be in the <code>build</code> folder.
 ==Controls==
@@ Line 77: / Line 77: @@
 '''CtrBootManager theme compilation''' ([https://www.youtube.com/watch?v=rD8Qco8ABhQ Rohul1997]) <br>
 <youtube>rD8Qco8ABhQ</youtube>
+'''New 3ds XL - Coldboot rxtools + ctrbootmanager''' ([https://www.youtube.com/watch?v=crV4_wZ10iQ Rocco Antonio Cannale]) <br>
+<youtube>crV4_wZ10iQ</youtube>
 ==Known issues==