CtrBootManager 3DS

From GameBrew
Revision as of 04:56, 21 November 2021 by HydeWing (talk | contribs)
CtrBootManager
Ctrbootmanager.png
General
AuthorCpasjuste
TypeUtilities
Version1.9
LicenseMixed
Last Updated2016/03/03
Links
Download
Website
Source

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 is to build from source:

  • mkdir build/
  • cd build/
  • cmake -DCMAKE_TOOLCHAIN_FILE=../DevkitArm3DS.cmake ../
  • make

Binaries should now be in the build folder.

Or you can install using the prebuild binaries.

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)
ctrbootmanager2.pngctrbootmanager3.jpg

Custom theme by Columbo2811
ctrbootmanager4.jpgctrbootmanager5.jpg

Custom theme by tilkimelek
ctrbootmanager6.jpgctrbootmanager7.png

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

Advertising: