|
|
| (10 intermediate revisions by 3 users not shown) |
| Line 1: |
Line 1: |
| {{Page WIP|notes=
| |
| * Needs installation instructions
| |
| * Needs subpage for instructions on makebax
| |
| * Needs configuration info
| |
| * Needs usage info
| |
| * Make important notes flashier
| |
| }}
| |
|
| |
| {{Infobox homebrew | | {{Infobox homebrew |
| | developers = Wolfvak | | | developers = Wolfvak |
| | for3ds = 1 | | | for3ds = 1 |
| | version = 3 | | | version = 3 |
| | | releasedate = 2018-03-19 |
| | website = https://gbatemp.net/threads/497717/ gbatemp.net/threads/497717 | | | website = https://gbatemp.net/threads/497717/ gbatemp.net/threads/497717 |
| | gitlab = Wolfvak/BAX | | | gitlab = Wolfvak/BAX |
| | | gitlabtag = third_release |
| }} | | }} |
| '''BAX''' is a homebrew program for the Nintendo 3DS (compatible with all models) that allows you to display video streams on load. Thanks to boot-time entrypoints, this can be done on boot, giving a similar impression to the loading animation of a PC or a mobile smartphone. Please note that while it's designed to boot another program, it does not allow both itself and the other to run concurrently, but rather sequentially. Therefore, any time that is "taken" by loading/playing the animation file will not be somehow "given" to the next program (f.e. independently of the time taken by the animation, the FIRM will take the same amount of time to load). | | '''BAX''' is a homebrew program for the Nintendo 3DS (compatible with all models) that allows you to display video streams on load. Thanks to boot-time entrypoints, this can be done on boot, giving a similar impression to the loading animation of a PC or a mobile smartphone. |
| | |
| | Please note that while it's designed to boot into another payload (usually Luma3DS) after running, per design it will not load the second payload alongside itself, but rather sequentially - the time to boot will always be extended by exactly the length of the video. It is also not feasible (though it is possible in theory) to have BAX start loading the HOME Menu while playing the video due to how NATIVE_FIRM handles GPU initialization. |
|
| |
|
| == Important Notes == | | ==Important Notes== |
| * BAX can not be booted from a FIRM partition or an NTRboot cart. Don't even try. | | * BAX can only be booted from the SD card. Attempting to boot from elsewhere (CTRNAND, FIRM0/1 or an NTRBoot cartridge) will only cause problems. |
| * Due to how Horizon/NATIVE_FIRM works, if you reboot from AGB_FIRM (GBA Virtual Console) the save game will not be saved until you reboot back into it again. | | * Because of how NATIVE_FIRM works, if you reboot into the HOME Menu from AGB_FIRM (the GBA Virtual Console) while BAX is installed, the GBA save game will not be saved until you boot AGB_FIRM again. |
| * BAX performs no GPU initialization, only register tweaks and assumes the GPU has already been initialized by the time it boots. Any B9S-compatible loaders should do this, given the proper bit is set in the FIRM (it certainly is in BAX), but it can not realistically provide support for every existing loader out there. | | * BAX performs no GPU initialization, only register tweaks, and assumes the GPU has already been initialized by the time it boots. As a result, only B9S-compatible bootloaders are guaranteed to support BAX - but you should only be using [[3DS:Boot9strap|boot9strap]] or [[3DS:fastboot3DS|fastboot3DS]] anyway, both of which are compatible. |
| | * As BAX loads before [[3DS:Luma3DS|Luma3DS]], it creates an extra 'grace period' before the START/SELECT button menus can open, similar to placing a [[3DS:Splash_screens#Enabling_splash_screens|splash before payloads]]. |
| | * To create animation files for BAX, see [[3DS:BAX/makebax#Creating_.BAX_Animations|here.]] |
|
| |
|
| == Installation == | | ==Installation== |
| | {{info|As having BAX installed under boot9strap will allow programs like Universal Updater to overwrite BAX with Luma, it is recommended to use an alternate setup under [[3DS:fastboot3DS|fastboot3DS]] instead.}} |
| <tabber> | | <tabber> |
| | |
| | |-|I use fastboot3DS= |
| | |
| | <ol> |
| | <li>Download the latest release of BAX from its {{GitLab|Wolfvak/BAX/-/releases|GitLab page}} (The <code>release.zip</code> file)</li> |
| | <li>Insert your console's SD card into your computer</li> |
| | <li>Create a folder named <code>bax</code> on the SD root</li> |
| | <li>Copy <code>BAX.firm</code> from the <code>release.zip</code> and your BAX animation files into the <code>bax</code> folder</li> |
| | <li>Create a file named <code>boot.txt</code> inside the <code>bax</code> folder and put the text '''sdmc:/boot.firm''' inside of it</li> |
| | <li>Boot into the fastboot3DS configuration menu by holding {{B|HOME}} while powering on</li> |
| | <li>Go to <code>Boot setup...</code> and select the first slot, then choose <code>Select [slot 1] firm</code> and pick the SD file <code>sd:/bax/BAX.firm</code></li> |
| | <li>Once selected, ensure <code>Set [slot 1] autoboot</code> is checked and back out to the main menu</li> |
| | <li>To test, go into <code>Boot menu...</code> and select <code>Boot [slot 1]</code>; your animation should load, then the system should load normally</li> |
| | <li>Your SD card layout should now include this:</li> |
| | </ol> |
| | {{Tree list}} |
| | * {{Tree icon|sd}} (root) |
| | ** {{Tree icon|d}} bax |
| | *** {{Tree icon|f}} '''BAX.firm''' (the file in the first boot slot of fastboot3DS) |
| | *** {{Tree icon|f}} '''my_animation_1.bax''' |
| | *** {{Tree icon|f}} '''my_animation_2.bax''' |
| | *** {{Tree icon|f}} '''my_animation_3.bax''' |
| | ** {{Tree icon|f}} '''boot.firm''' (Your existing Luma3DS file) |
| | ** {{Tree icon|f}} '''boot.3dsx''' |
| | {{Tree list/end}} |
|
| |
|
| |-|I use boot9strap= | | |-|I use boot9strap= |
|
| |
|
| {{Info|Following these instructions will move your Luma3DS firmware file to <code>SD:/bax/boot.firm</code>, instead of <code>SD:/boot.firm</code>. Please keep this in mind when updating Luma3DS in the future so you don't accidentally overwrite BAX's FIRM payload.}} | | {{info|text=Following these instructions will move your Luma3DS firmware file to <code>sdmc:/bax/boot.firm</code>, with <code>sdmc:/boot.firm</code> being the BAX payload instead. Please keep this in mind when updating Luma3DS in the future so you don't accidentally overwrite BAX.}} |
|
| |
|
| # Download and the latest release of BAX from its {{GitLab|Wolfvak/BAX/-/releases|GitLab page}} (The <code>release.zip</code> file)
| | <ol> |
| # Insert your console's SD card into your computer
| | <li>Download and the latest release of BAX from its {{GitLab|Wolfvak/BAX/-/releases|GitLab page}} (The <code>release.zip</code> file)</li> |
| # Create a folder named <code>bax</code> on the root your SD card
| | <li>Insert your console's SD card into your computer</li> |
| # Move your existing <code>boot.firm</code> file into <code>SD:/bax/</code>
| | <li>Create a folder named <code>bax</code> on the SD root</li> |
| # Copy <code>BAX.firm</code> from <code>release.zip</code> into the root of your SD card
| | <li>Move your existing <code>boot.firm</code> file into the <code>bax</code> folder</li> |
| # Rename the <code>BAX.firm</code> you copied to <code>boot.firm</code>
| | <li>Copy <code>BAX.firm</code> from <code>release.zip</code> into the root of your SD card</li> |
| # Copy your BAX animation files to <code>SD:/bax/</code>
| | <li>Rename the <code>BAX.firm</code> you copied to <code>boot.firm</code></li> |
| #* For instructions on how to create BAX animations, see [[3DS:BAX/Usage|this page]]
| | <li>Copy your BAX animation files to <code>sdmc:/bax/</code></li> |
| # Your SD card should now look something like this:
| | <li>Your SD card layout should now include this:</li> |
| | </ol> |
| {{Tree list}} | | {{Tree list}} |
| * [[File:Gnome-media-flash.svg|20px|link=]] (root) | | * {{Tree icon|sd}} (root) |
| ** [[File:Icons8 flat opened folder.svg|20px|link=]] bax | | ** {{Tree icon|d}} bax |
| *** [[File:Icons8 flat file.svg|20px|link=]] '''boot.firm''' (Your existing Luma3DS file) | | *** {{Tree icon|f}} '''boot.firm''' (Your existing Luma3DS file) |
| *** [[File:Icons8 flat file.svg|20px|link=]] '''my_animation_1.bax''' | | *** {{Tree icon|f}} '''my_animation_1.bax''' |
| *** [[File:Icons8 flat file.svg|20px|link=]] '''my_animation_2.bax''' | | *** {{Tree icon|f}} '''my_animation_2.bax''' |
| *** [[File:Icons8 flat file.svg|20px|link=]] '''my_animation_3.bax''' | | *** {{Tree icon|f}} '''my_animation_3.bax''' |
| ** [[File:Icons8 flat file.svg|20px|link=]] '''boot.3dsx''' | | ** {{Tree icon|f}} '''boot.3dsx''' |
| ** [[File:Icons8 flat file.svg|20px|link=]] '''boot.firm''' (Used to be named BAX.firm) | | ** {{Tree icon|f}} '''boot.firm''' (Used to be named BAX.firm) |
| {{Tree list/end}} | | {{Tree list/end}} |
|
| |
|
| {{Success|BAX is now installed! It will randomly choose an animation to play at boot, then continue to Luma3DS.}}
| | </tabber> |
| | |
| |-|I use fastboot3DS=
| |
| # Download and the latest release of BAX from its {{GitLab|Wolfvak/BAX/-/releases|GitLab page}} (The <code>release.zip</code> file)
| |
| # Insert your console's SD card into your computer
| |
| WIP
| |
|
| |
|
| </tabber>
| | {{success|text=BAX is now installed! It will choose a random animation to play at boot, then continue to Luma3DS.}} |
|
| |
|
| == Configuration == | | ==Configuration== |
| WIP
| | If you create a text file, <code>sdmc:/bax/boot.txt</code>, that only contains a plaintext file path to a <code>.firm</code> file (such as <code>sdmc:/firm/Luma3DS.firm</code>), then when <code>BAX.firm</code> boots it will boot that file instead of <code>sdmc:/bax/boot.firm</code>. |
(root)
bax
BAX.firm (the file in the first boot slot of fastboot3DS)