CtrBootManager 3DS: Difference between revisions

From GameBrew
No edit summary
m (Text replacement - "Category:Support the author" to "")
 
(27 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Infobox 3DS homebrew
{{Infobox 3DS Homebrews
| title = CtrBootManager
|title=CtrBootManager
| image = https://dlhb.gamebrew.org/3dshomebrew/CtrBootManager.jpeg|250px
|image=Ctrbootmanager.png
| type = Utilities
|description=A boot manager for some 3DS homebrew applications, like HBL and CFW.
| version = 1.9
|author=Cpasjuste
| licence = Mixed
|lastupdated=2016/03/03
| author = Cpasjuste
|type=Utilities
| website = https://github.com/Cpasjuste/CtrBootManager
|version=1.9
| download = https://dlhb.gamebrew.org/3dshomebrew/
|license=Mixed
| source = https://dlhb.gamebrew.org/3dshomebrew/
|download=https://dlhb.gamebrew.org/3dshomebrews/ctrbootmanager.7z?k33p0fil35
|website=https://gbatemp.net/threads/ctrbootmanager-3ds-boot-manager-loader-homemenuhax.398383
|source=https://github.com/Cpasjuste/CtrBootManager
|donation=https://paypal.me/cpasjuste
}}
}}
<youtube>FxFrLFQwCb8</youtube>
CtrBootManager, or CTR Boot Manager, is a boot manager for some 3DS homebrew applications, like HBL and CFW.


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


CtrBootManager is a boot manager for some 3DS homebrew applications, like HBL and CFW.
'''Note:''' This homebrew will not run ninjhax 1 or current CFW on 9.3+.


Here is a boot manager / loader, mainly for the HomeMenuHax but it should also work from homebrew menu(for loading arm9 payloads for example).
==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).


* 3ds with fw <= 9.2 !
==Installation==
* It currently allow 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.
===Dependencies===
* It can boot some arm9 payload "*.bin/dat" or ".3dsx" files from a crappy file manager if needed.
* devkitpro-4.5 at least (ctrulib-1.0 at least).
* It can receive/execute .3dsx files from network (3dslink)
* libconfig in portlibs (tried with v1.5).


==Installation:==
===Building===
The recommended way is to build from source:
* <code>mkdir build/</code>
* <code>cd build/</code>
* <code>cmake -DCMAKE_TOOLCHAIN_FILE=../DevkitArm3DS.cmake ../</code>
* <code>make</code>


* Install "HomeMenuHax", automatic one is better (no button to press for booting).
Binaries should now be in the <code>build</code> folder.
* Edit "boot.cfg" to suits your needs (be careful to errors)
* Copy "boot.3dsx" and "boot.cfg" to sdcard root


==Custom backgrounds (Thanks to @Flat):==
Or you can install using the prebuild binaries.


Images need to be in .bgr bin format. You can use this website to do so :
===Installing===
Install [https://github.com/yellows8/3ds_homemenuhax HomeMenuHax], preferably the automatic one (no button to press for booting).


https://xem.github.io/3DShomebrew/tools/image-to-bin.html
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 [https://xem.github.io/3DShomebrew/tools/image-to-bin.html 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.
This can also be accomplished with image magick using the convert command and then rotating the image 90 degrees.


<code>convert yourimg.png -channel BGR -separate -channel RGB -combine -rotate 90 yourimg.rgb
<code>convert yourimg.png -channel BGR -separate -channel RGB -combine -rotate 90 yourimg.rgb</code>
</code>
 
Place it on your SD card and edit your config to the path of the image, [https://github.com/Cpasjuste/CtrBootManager/blob/master/data/boot.cfg boot.cfg sample].
 
A collection of custom backgrounds is available from the [https://gbatemp.net/threads/ctrbootmanager-backgrounds-collection-scripts.412013 discussion thread].
 
==Controls==
A - Launch
 
X - Remove entry
 
==Screenshots==
'''Custom background by [https://gbatemp.net/threads/ctrbootmanager-backgrounds-collection-scripts.412013/page-5#post-6061194 Mythrandir] (left) and [https://gbatemp.net/threads/ctrbootmanager-backgrounds-collection-scripts.412013/page-3#post-6024964 Anibal Pacheco] (right)''' <br>
https://dlhb.gamebrew.org/3dshomebrews/ctrbootmanager2.png
https://dlhb.gamebrew.org/3dshomebrews/ctrbootmanager3.jpg
 
'''Custom theme by [https://gbatemp.net/threads/ctrbootmanager-backgrounds-collection-scripts.412013/#post-6019781 Columbo2811]''' <br>
https://dlhb.gamebrew.org/3dshomebrews/ctrbootmanager4.jpg
https://dlhb.gamebrew.org/3dshomebrews/ctrbootmanager5.jpg
 
'''Custom theme by [https://gbatemp.net/threads/ctrbootmanager-backgrounds-collection-scripts.412013/page-2#post-6023775 tilkimelek]''' <br>
https://dlhb.gamebrew.org/3dshomebrews/ctrbootmanager6.jpg
https://dlhb.gamebrew.org/3dshomebrews/ctrbootmanager7.png
 
==Media==
'''CtrBootManager - custom boot demo presentation (French)''' ([https://www.youtube.com/watch?v=FxFrLFQwCb8 Ooggle]) <br>
<youtube>FxFrLFQwCb8</youtube>
 
'''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==
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).


Place it on your sdcard and edit your config to the path of the image.
'''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).


boot.cfg sample :
'''v1.2'''
* Change font.


https://github.com/Cpasjuste/CtrBootManager/blob/master/data/boot.cfg
'''v1.1'''
* Add ("key") option to override autoboot entry.


==Dependencies==
'''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.


* devkitpro-4.5 at least (ctrulib-1.0 at least)
'''b09'''
* libconfig in portlibs (tried with v1.5)
* Add simple boot configuration screen ("More... -> Settings" menu).
* (Re-re-re-re) fix netloading code.


==Building==
'''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.


===The recommended way:===
'''b07'''
* Add "autobootfix" option to config.cfg file.
* Fix a bug when more than 22 files are in a directory (filer).


* <code>mkdir build/</code>
'''b06'''
* <code>cd build/</code>
* Added colored ui.
* <code>cmake -DCMAKE_TOOLCHAIN_FILE=../DevkitArm3DS.cmake ../</code>
* Alphasort files/dirs in filer.
* <code>make</code> Binaries should now be in the <code>build</code> folder.
* Filter out .3dsx, .bin, .dat in filer.
* Fix 3dsx loading (was broken after multiple launch).
* Few fix and improvements.


===changelog===
'''b05'''
<pre>
* Fixed autoboot.
1.9: added return to homemenu (needs ninjhax >= 2.6)
* Fixed booting of arm9 payload from filer (which doesn't require specific offset).
-------------------------------------------------------
1.8: added arm9 netloader (nc 192.168.1.2 80 < arm9.bin)
1.8: updated to latest ctrulib + hax
-------------------------------------------------------
1.7: fix ui when no theme section found in cfg
-------------------------------------------------------
1.6: fix file browser
1.6: add reboot/shutdown items to config
-------------------------------------------------------
1.5: minor fixes and improvements
-------------------------------------------------------
1.4: adds support for user images as a background (thanks @Flat)
-------------------------------------------------------
1.3: add colors to configuration file
1.3: fix override button not working when timeout > 0 (thanks @Aroth)
1.3: add old ctrulib as submodule (fix CakeBrah)
1.3: add old CakeBrah as submodule (fix CakeBrah)
-------------------------------------------------------
1.2: change font
-------------------------------------------------------
1.1: add ("key") option to override autoboot entry
-------------------------------------------------------
1.0: add boot menu entry from the file manager (X) (.3dsx only)
1.0: remove boot menu entry from boot menu (X)
1.0: add a few more help/information to the bottom screen
-------------------------------------------------------
b09: add simple boot configuration screen ("More... -> Settings" menu)
b09: (re-re-re-re) fix netloading code
-------------------------------------------------------
b08: fix broken wifi on a lot of 3dsx
b08: fix booting some 3dsx
b08: added 3dsx descriptor support (xml)
b08: fix 3dsx netload
b08: updated to latest ctrulib
-------------------------------------------------------
b07: add "autobootfix" option to config.cfg file
b07: fix a bug when more than 22 files are in a directory (filer)...
-------------------------------------------------------
b06: added colored ui
b06: alphasort files/dirs in filer
b06: filter out .3dsx, .bin, .dat in filer
b06: fix 3dsx loading (was broken after multiple launch)
b06: few fix and improvements
-------------------------------------------------------
b05: fixed autoboot
b05: 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
b03: added 3dsx netloader (use 3dslink), thanks smea
b03: added recovery button to config.cfg (to be used when timeout=0)
b03: various menu changes cleanup and bug fixes
--------------------------------------------------------
b02: fix cake-cfw loading
b02: fix screen corruption
b02: added arm9 offset in config file
</pre>


==#Credits==
'''b04'''
* Fixed some .3dsx not booting.


===For contributions to hb_menu:===
'''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.


* smea : code
'''b02'''
* GEMISIS : code
* Fix cake-cfw loading.
* fincs : code
* Fix screen corruption.
* mtheall : code
* Added arm9 offset in config file.
* Fluto : graphics
* Arkhandar : graphics
* dotjasp : graphics (regionfree icon)


===Other credits:===
==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 [https://github.com/patois/Brahma Brahma]. See its repository for its credits.
Readme by gemarcano This project also uses [https://github.com/patois/Brahma Brahma]. See its repository for its credits.
==External links==
* GitHub - https://github.com/Cpasjuste/CtrBootManager
* GBAtemp - https://gbatemp.net/threads/ctrbootmanager-3ds-boot-manager-loader-homemenuhax.398383

Latest revision as of 04:08, 17 May 2024

CtrBootManager
Ctrbootmanager.png
General
AuthorCpasjuste
TypeUtilities
Version1.9
LicenseMixed
Last Updated2016/03/03
Links
Download
Website
Source
Support Author

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: