CtrBootManager 3DS: Difference between revisions

From GameBrew
(Created page with "{{Infobox 3DS homebrew | title = CtrBootManager | image = https://dlhb.gamebrew.org/3dshomebrew/CtrBootManager.jpeg|250px | type = Utilities | version = 1.9 | licence = Mixed...")
 
m (Text replacement - "Category:Support the author" to "")
 
(29 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
}}
}}
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:
* <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.
Or you can install using the prebuild binaries.
===Installing===
Install [https://github.com/yellows8/3ds_homemenuhax 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 [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.
<code>convert yourimg.png -channel BGR -separate -channel RGB -combine -rotate 90 yourimg.rgb</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>
<youtube>FxFrLFQwCb8</youtube>


#CtrBootManager CtrBootManager is a boot manager for some 3DS homebrew applications, like HBL and CFW. ##Dependencies
'''CtrBootManager theme compilation''' ([https://www.youtube.com/watch?v=rD8Qco8ABhQ Rohul1997]) <br>
* devkitpro-4.5 at least (ctrulib-1.0 at least)
<youtube>rD8Qco8ABhQ</youtube>
* libconfig in portlibs (tried with v1.5) ##Building ###The recommended way:
 
# <code>mkdir build/</code>
'''New 3ds XL - Coldboot rxtools + ctrbootmanager''' ([https://www.youtube.com/watch?v=crV4_wZ10iQ Rocco Antonio Cannale]) <br>
# <code>cd build/</code>
<youtube>crV4_wZ10iQ</youtube>
# <code>cmake -DCMAKE_TOOLCHAIN_FILE=../DevkitArm3DS.cmake ../</code>
 
# <code>make</code> Binaries should now be in the <code>build</code> folder. ##Credits ###For contributions to hb_menu:
==Known issues==
* smea : code
Please see https://github.com/Cpasjuste/CtrBootManager/issues.
* GEMISIS : code
 
* fincs : code
==Changelog==
* mtheall : code
'''v1.9'''
* Fluto : graphics
* Added return to homemenu (needs ninjhax >= 2.6).
* Arkhandar : graphics
 
* dotjasp : graphics (regionfree icon) ###Other credits: Readme by gemarcano This project also uses [https://github.com/patois/Brahma Brahma]. See its repository for its credits.
'''v1.8'''
<blockquote class="messageText SelectQuoteContainer ugc baseHtml">
* Added arm9 netloader (nc 192.168.1.2 80 < arm9.bin).
Here is a boot manager / loader, mainly for the HomeMenuHax but it should also work from homebrew menu(for loading arm9 payloads for example).<br> <br>
* Updated to latest ctrulib + hax.
* 3ds with fw &lt;= 9.2 !<br>
 
<br>
'''v1.7'''
- 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.<br>
* Fix ui when no theme section found in cfg.
- It can boot some arm9 payload "*.bin/dat" or ".3dsx" files from a crappy file manager if needed.<br>
 
- It can receive/execute .3dsx files from network (3dslink)<br>
'''v1.6'''
<br>
* Fix file browser.
<b><span style="text-decoration: underline">Installation :<br>
* Add reboot/shutdown items to config.
</span></b><br>
 
- Install "HomeMenuHax", automatic one is better (no button to press for booting).<br>
'''v1.5'''
- Edit "boot.cfg" to suits your needs (be careful to errors)<br>
* Minor fixes and improvements.
- Copy "boot.3dsx" and "boot.cfg" to sdcard root<br>
 
<br>
'''v1.4'''
<span style="text-decoration: underline"><b>Custom backgrounds (Thanks to <a href="https://github.com/Flat" target="_blank" class="externalLink" rel="nofollow">@Flat</a>):</b></span><br>
* Adds support for user images as a background (thanks Flat).
<br>
 
Images need to be in .bgr bin format. You can use this website to do so :<br>
'''v1.3'''
<a href="https://xem.github.io/3DShomebrew/tools/image-to-bin.html" target="_blank" class="externalLink" rel="nofollow">https://xem.github.io/3DShomebrew/tools/image-to-bin.html</a><br>
* Add colors to configuration file
This can also be accomplished with image magick using the convert command and then rotating the image 90 degrees.<br>
* Fix override button not working when timeout > 0 (thanks Aroth).
<div class="bbCodeBlock bbCodeCode">
* Add old ctrulib as submodule (fix CakeBrah).
<div class="type">Code:</div>
* Add old CakeBrah as submodule (fix CakeBrah).
<pre>convert yourimg.png -channel BGR -separate -channel RGB -combine -rotate 90 yourimg.rgb</pre>
 
</div>Place it on your sdcard and edit your config to the path of the image.<br>
'''v1.2'''
<br>
* Change font.
<b><span style="text-decoration: underline">boot.cfg sample :<br>
 
</span></b><br>
'''v1.1'''
<a href="https://github.com/Cpasjuste/CtrBootManager/blob/master/data/boot.cfg" target="_blank" class="externalLink" rel="nofollow">https://github.com/Cpasjuste/CtrBootManager/blob/master/data/boot.cfg</a><br>
* Add ("key") option to override autoboot entry.
<br>
 
<span style="text-decoration: underline"><b>Screenshot :</b></span><br>
'''v1.0'''
<br>
* Add boot menu entry from the file manager (X) (.3dsx only).
<img src="proxy.php?image=http%3A%2F%2Ffiles.mydedibox.fr%2Ffiles%2FDev%2F3ds%2Fcbm.png&amp;hash=6d81c01c2e1a057a93cfffab3bae3add" class="bbCodeImage LbImage" alt="[?IMG]" data-url="http://files.mydedibox.fr/files/Dev/3ds/cbm.png" style=""><br>
* Remove boot menu entry from boot menu (X).
<br>
* Add a few more help/information to the bottom screen.
<b><span style="text-decoration: underline">Source code:<br>
 
</span></b><br>
'''b09'''
<a href="https://github.com/Cpasjuste/CtrBootManager" target="_blank" class="externalLink" rel="nofollow">https://github.com/Cpasjuste/CtrBootManager</a><br>
* Add simple boot configuration screen ("More... -> Settings" menu).
Thanks to smea since a lot of code comes from him, and all other people involved (Myria, Steveice10..)<br>
* (Re-re-re-re) fix netloading code.
<br>
 
<b><span style="text-decoration: underline">Changelog:<br>
'''b08'''
</span></b><br>
* Fix broken wifi on a lot of 3dsx.
1.9: <a href="https://github.com/Cpasjuste/CtrBootManager/blob/master/data/boot.cfg#L40-L43" target="_blank" class="externalLink" rel="nofollow">added return to homemenu</a> (needs ninjhax &gt;= 2.6)<br>
* Fix booting some 3dsx.
-------------------------------------------------------<br>
* Added 3dsx descriptor support (xml).
1.8: added arm9 netloader (nc 192.168.1.2 80 &lt; arm9.bin)<br>
* Fix 3dsx netload.
1.8: updated to latest ctrulib + hax<br>
* Updated to latest ctrulib.
-------------------------------------------------------<br>
 
1.7: fix ui when no theme section found in cfg<br>
'''b07'''
-------------------------------------------------------<br>
* Add "autobootfix" option to config.cfg file.
1.6: fix file browser<br>
* Fix a bug when more than 22 files are in a directory (filer).
1.6: add reboot/shutdown items to config<br>
 
-------------------------------------------------------<br>
'''b06'''
1.5: minor fixes and improvements<br>
* Added colored ui.
-------------------------------------------------------<br>
* Alphasort files/dirs in filer.
1.4: adds support for user images as a background (thanks <a href="https://github.com/Flat" target="_blank" class="externalLink" rel="nofollow">@Flat</a>)<br>
* Filter out .3dsx, .bin, .dat in filer.
-------------------------------------------------------<br>
* Fix 3dsx loading (was broken after multiple launch).
1.3: add colors to configuration file<br>
* Few fix and improvements.
1.3: fix override button not working when timeout &gt; 0 (thanks @<a href="https://gbatemp.net/members/aroth.364528/" class="internalLink">Aroth</a>)<br>
 
1.3: add old ctrulib as submodule (fix CakeBrah)<br>
'''b05'''
1.3: add old CakeBrah as submodule (fix CakeBrah)<br>
* Fixed autoboot.
-------------------------------------------------------<br>
* Fixed booting of arm9 payload from filer (which doesn't require specific offset).
1.2: change font<br>
 
-------------------------------------------------------<br>
'''b04'''
1.1: add ("key") option to override autoboot entry<br>
* Fixed some .3dsx not booting.
-------------------------------------------------------<br>
 
1.0: add boot menu entry from the file manager (X) (.3dsx only)<br>
'''b03'''
1.0: remove boot menu entry from boot menu (X)<br>
* Added reboot and power off.
1.0: add a few more help/information to the bottom screen<br>
* Added 3dsx netloader (use 3dslink), thanks smea.
-------------------------------------------------------<br>
* Added recovery button to config.cfg (to be used when timeout=0).
b09: add simple boot configuration screen ("More... -&gt; Settings" menu)<br>
* Various menu changes cleanup and bug fixes.
b09: (re-re-re-re) fix netloading code<br>
 
-------------------------------------------------------<br>
'''b02'''
b08: fix broken wifi on a lot of 3dsx<br>
* Fix cake-cfw loading.
b08: fix booting some 3dsx<br>
* Fix screen corruption.
b08: added 3dsx descriptor support (xml)<br>
* Added arm9 offset in config file.
b08: fix 3dsx netload<br>
 
b08: updated to latest ctrulib<br>
==Credits==
-------------------------------------------------------<br>
For contributions to hb_menu:
b07: add "autobootfix" option to config.cfg file<br>
* smea - Code.
b07: fix a bug when more than 22 files are in a directory (filer)...<br>
* GEMISIS - Code.
-------------------------------------------------------<br>
* fincs - Code.
b06: added colored ui<br>
* mtheall - Code.
b06: alphasort files/dirs in filer<br>
* Fluto - Graphics.
b06: filter out .3dsx, .bin, .dat in filer<br>
* Arkhandar - Graphics.
b06: fix 3dsx loading (was broken after multiple launch)<br>
* dotjasp - Graphics (regionfree icon).
b06: few fix and improvements<br>
 
-------------------------------------------------------<br>
Readme by gemarcano This project also uses [https://github.com/patois/Brahma Brahma]. See its repository for its credits.
b05: fixed autoboot<br>
 
b05: fixed booting of arm9 payload from filer (which doesn't require specific offset)<br>
==External links==
-------------------------------------------------------<br>
* GitHub - https://github.com/Cpasjuste/CtrBootManager
b04: fixed some .3dsx not booting<br>
* GBAtemp - https://gbatemp.net/threads/ctrbootmanager-3ds-boot-manager-loader-homemenuhax.398383
-------------------------------------------------------<br>
b03: added reboot and power off<br>
b03: added 3dsx netloader (use 3dslink), thanks smea<br>
b03: added recovery button to config.cfg (to be used when timeout=0)<br>
b03: various menu changes cleanup and bug fixes<br>
--------------------------------------------------------<br>
b02: fix cake-cfw loading<br>
b02: fix screen corruption<br>
b02: added arm9 offset in config file
<div class="messageTextEndMarker">&nbsp;</div>
</blockquote>

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: