BootMii Configuration Editor Wii

BootMii Config Editor
File:Bootmiiconfigurationeditorwii.jpg
General
Author	pembo
Type	Utilities
Version	2.7
License	Freeware
Last Updated	2012/07/04
Links
Download
Website
Source

The BootMii Configuration Editor allows you to modify the BootMii ini file on the SD card to change the settings, without having to bring the SD card over to the PC and edit it.

It also allows you to disable/enable BootMii (via renaming of the bootmii directory to ~bootmii) or switching of implementations should you have more than one installed (e.g. MIKE).

User guide

Once launched from the homebrew channel you can use it to change the following options in the bootmii.ini file:

• Video - NSTC/PAL50/PAL60/PROGRESSIVE.
• Autoboot - Off/System Menu/Homebrew Channel.
• Boot Delay - Time in Seconds from 0 to 10 for how long the BootMii screen shows before autobooting.

Setting Boot Delay to 0 results in the BootMii screen not being shown on startup.

Disabling Autoboot (Setting to off) results in a selection being required on the BootMii screen.

Settings menu

From within the settings menu you can change the following:

• Selected Language.
• Skin - Style of the application.
• Update Check - whether or not to check for (and download) any new versions of the editor on startup.

Note: When the changes are saved, the bootmii.ini file within SD:/bootmii is always recreated with the changed values.

BootMii Active options

Within the application you can also enable or disable bootmii using the BootMii Active option.

• Setting to Enabled will leave your BootMii directory is named /bootmii.
• Setting to disabled will rename /bootmii to /~bootmii therefore disabling bootmii at startup
• Enabling/disabling bootmii will modify the homebrew channel icon. This will display with a green circle when enabled or a red circle when disable.

If you wish to use an alternative mini implementation (e.g. MIKE) then you can install this in a directory called /~bootmii/. When the editor starts if /bootmii and /~bootmii exist, the editor will run in 'switch mode' giving you the option to edit bootmii.ini in whichever directory it is found (or a choice if it exists in both) and at startup will give you the option to simply swap the two directories (i.e. /~bootmii becomes /bootmii and vice versa. In switch mode the homebrew icon is changed to an orange circle indicating this.

By default, the application assumes it is running in enabled mode, one running it will assess the mode and update the icon as to what it finds.

FAQ

Q. How do I stop BootMii from showing on startup of the Wii?

Set the boot delay to '0' and the BootMii screen will not show when the Wii starts up.

There is a bug reported in the most recent beta of BootMii which causes a boot delay of 0 to not function as expected. You can use the switch functionality in v2.5 to disable BootMii from starting up.

Alternatively, you could download the latest mini binary for BootMii and replace the version on your SD card with the downloaded file.

Q. Why does my homebrew channel icon change colour?

The icon changes colour to represent the status of the bootmii directory.

• Green - BootMii Active (directory is name /bootmii).
• Red - BootMii Inactive (bootmii directory renamed to /~bootmii)
• Yellow - Bootmii switch mode - both /bootmii and /~bootmii exist on the SD.

Q. How can I change the interface language?

Press the Home button on the Wiimote to open the settings dialog. The language is the first setting.

Push Left/Right to change it and when you've found the language you require, move to the 3rd option on the screen (the one with an empty line above it).

Press A on this, and the language will be changed.

Q. How do I add a new Language?

To add a new translation/language perform the following steps which use French(fr) as an example:

• Open the BCE_MESSAGES.XML file in an editor.
• Add a new language/code to the available langauges section near the top of the file.

e.g. to add french add the following line:

<language description="Francais" code="fr" /> 

to the available section, for example:

<available> 
  <language description="English" code="en" /> 
  <language description="Espanol" code="es" /> 
  <language description="Francais" code="fr" /> 
</available>

For every <entry, add in the french translation using an attribute named the same as the value specified in the code for the langauge (e.g. fr) for example:

<entry code="mm1" en="Video:" es="Modo de Video:" fr="Mode visuel:"/>

Ensure the XML file validates and that you've added a language string for EVERY entry.

Copy/Save to SD card and test. If the application errors with a stack dump, then there will be a problem in the XML, either it's invalid, or you've missed one of the entry elements usually

Q. How do I add a new Skin?

To create a new Skin:

• Open the BCE_SKINS.XML file in an editor.
• Find the <skins element and within this, select and duplicate a skindetail.

  <skindetail id="custom1" name="My Custom Skin"
  consolebgcolor="14" consoletextcolor="17" mainbgcolor="7"
  maintextcolor="0" maintextcolor2="10" maintitlecolor="11"
  maintitlelinecolor="0" mainselectedIndicatorcolor="11"
  mainselectedOptioncolor="15" mainshadow="0" maildecl="7" dialogbgcolor="10"
  dialogtextcolor="17" dialogtextcolor2="17" dialogtitlecolor="17"
  dialogtitlelinecolor="7" dialogselectedIndicatorcolor="11"
  dialogselectedOptioncolor="13" dialogshadow="0" dialogdecl="10" />

Change the id and name. The id must be unique through all the skins.

Modify the numbers for the colours. The following colours/numbers are available to use:

• 0 - BLACK
• 1 - DARK_RED
• 2 - DARK_GREEN
• 3 - DARK_YELLOW
• 4 - DARK_BLUE
• 5 - DARK_MAGENTA
• 6 - DARK_CYAN
• 7 - GRAY
• 10 - DARK_GRAY
• 11 - RED
• 12 - GREEN
• 13 - YELLOW
• 14 - BLUE
• 15 - MAGENTA
• 16 - CYAN
• 17 - WHITE

There are 3 main parts to the skin settings:

• consolebgcolor/consoletextcolor - Background colour of the whole screen and default font colour (currently not used).
• mainxxxxxx:
  • mainbgcolor - Background colour of the main window.
  • maintextcolor - Colour of text in the main window.
  • maintextcolor2 - Colour of secondary text in the main window.
  • maintitlecolor - Colour of window title text.
  • maintitlelinecolor - Colour of the line in the window title .
  • mainselectedIndicatorcolor - Colour of the indicator -> which shows which item you are on.
  • mainselectedOptioncolor - Color of the text of selected item when you select it.
  • mainshadow - shadow colour of the window.
  • maindecl - Colour of the window edge characters (Pipe | and Minus - ) that indicate the window edge. These are used on the monochrome/green screen skins.
• dialogxxxxxx - Same as the main settings, but for secondary windows, e.g. the settings dialog.

Controls

The application is text based and controlled via the Wiimote or GameCube D-Dad.

Up/Down - Move through menu items

Left/Right - to change the options of the current selection

A - Select the save/discard option

Home (Start on GC Pad) - Bring up the settings menu

Media

BootMii Configuration Editor v2.5 (pemboCoUk)

Changelog

Version 2.7

• Updated and compiled against latest libogc (1.8.11) / devkitPPC 26.
• Modified auto-update URL.

Version 2.6

• When BootMii Switch is active, a new option has been added - switch and reboot. This allows you to switch the directories around and reboot the wii immediately.
• USB2.0 Support (via IOS58). Bootmii Config Editor can now launch from a USB drive, however it will still only edit INI files on the SD card. This utilises IOS58 from the HBC channel. If you don't have IOS58 installed, you can install this using the IOS58 Installer.

Version 2.5

• Implementation Of BootMii Switch functionality. Can enable/disable BootMii through the editor by renaming the directory from /bootmii to /~bootmii and vice versa.
• If /bootmii and /~bootmii exist you are given the option to switch the directories allowing you to use an alternate MINI implementation such as MIKE.
• If bootmii.ini exists in both directories you are given the choice of which to edit.
• The homebrew channel icon is swapped depending on the mode to give an indication of the bootmii status. A green circle indicates bootmii is enabled, a red circle indicates bootmii is disabled, and an orange circle indicates you are running in switch mode.
• Several fixes to resolve various minor issues.

Version 2.4

• Automatic download/updating of application when a new version is released.
• Additional option in the settings menu (accessed via the 'home' button). This option allows to enable/disable the automatic update/version checking and is particularly useful if you run this on a wii without an internet connection.
• Settings File paths are now resolved from the argv/argc parameters when supplied from the loader (N.B. the homebrew channel does provide these). If not supplied then a default location of 'SD:/apps/Bootmii_cfg_ed‘ is assumed.

Version 2.3

• Changes Skin/language dynamically as you move between the options.
• Monochrome/Green Skin improved by a new skin option in the skins XML file: maindecl and dialogdecl. These values allow for the display of a textual border around the monochrome/green screen skins constructed using the Pipe(|) and Minus (-) character.
• Further changes to resolve the reported sporadic crashes whilst changing language/skins from the settings menu.

Version 2.2

• Additional Languages, Dutch, Finnish and German. Thank you to the following people for providing new translations:
  • Dutch/Nederlands – MarioWaza.
  • Finnish/Suomi – JaniN.
  • German/Deutsch – Helsionium.
• Addition of 2 new skins, Monochrome and Green Screen.
• Correction of the update version checking.
• Resolved pointer corruption issue that resulted in sporadic crashes.
• Separation of XML Files into 3 different files to make it easier to add new languages/skins.

Version 2.1

• English, French, Italian Portuguese and Spanish languages available to select from within the settings menu. Thank you to the following people who have provided translations:
  • French - Vlad.
  • Italian - Raiden.
  • Portuguese - zedascouves.
  • Spanish - Mokona Modoki/Comepiedras.
• Adjustments to the text positioning to cope with some of the longer words that the new translations bring.
• Game cube controller compatible:
  • Use the D-Pad to move through the options.
  • 'A' to select a menu option.
  • 'Start' to bring up the settings menu.
• Boot Delay extended. It can now be changed from 0 up to 10 seconds.
• 576i/480i detection and adjustment. Vertical positioning is adjusted slightly depending on which video mode is selected and the height of the screen.
• Wiimote vibration. Wiimote vibrates when you enter the start menu.
• BootMii Configuration Editor Logo always shows in bottom right corner.
• Wii Power Button now turns off wii without having to hold for 5 seconds.
• Wii Reset Button now resets the console.
• Power button on wiimote now powers down the wii.

Version 2.0

• Settings Dialog to change editor settings. This can be accessed by pressing the 'HOME' button. The settings are persisted to the languages file, so if you change the language/skin, whenever you load BootMii Configuration Editor, your selected options will be the default.
• Internationalisation Supported (Currently English & Spanish Langauges available). Further languages can be added by editing the bce_messages.xml file. See the readme.txt for details of how to do this.
  • Please be careful if you do edit the XML file. A corrupt/non well-formed XML file will result in a Crash of the Wii and will dump the stack to the screen.
  • Ensure you take a backup of the original before attempting to make any custom changes.
  • Currently you can only use characters in the standard ASCII character set, e.g. [0-9] [a-z] [A-Z] Some punctuation characters may also cause issue. It is recommended that you do not use characters with any accents/umlauts/etc as this will cause an issue.
  • If you do create a translation for a new language please let me know and I'll then include it in the next release.
• Skins/Colour Change. The application can now be presented in a number of look & feels. Initially the following skins are available:
  • Windows - Windows Installer/DOS like look/feel with a blue background and grey windows.
  • Console - Black background, white text with other colour text to highlight options/selections.
  • Inverse Console - White background, black text with other colour text to highlight options/selections.

Custom Skins can be added by editing the bce_messages.xml file. See the readme.txt for instructions on how to do this.

• Online version Checking. When the Editor is loaded, it performs a check to see if the version running is the latest available version. If a newer version is available, then a message is shown for a few seconds during startup to indicate this. This online checking can be disabled if you do not wish BootMii Configuration Editor to check for a new version or do not have the wii networked. If you wish to disable this check, see the instructions in the readme.txt
  • Please be careful if you do edit the XML file. A corrupt/non well-formed XML file will result in a Crash of the Wii and will dump the stack to the screen.
  • Ensure you take a backup of the original before attempting to make any custom changes.

Version 1.1

• Resolved a bug that caused a code dump if the bootmii directory did not exist. The bootmii directory is checked for existence on startup and the user is prevent from making changes if the directory does not exist.
• Improved Look & Feel.

Version 1.0

• Added OFF option to autoboot. Setting Autoboot to off will disable the delay timer setting in the configuration editor, as this serves no purpose with autoboot disabled. Setting of OFF has the effect of making the Wii sit in the bootmii menu screen until you select the system menu or homebrew channel option from the bootmii menu using either a gamecube controller, or the power/reset buttons on the front of the console.

Version 0.1b

• Initial release.

Credits

• Everyone responsible for BootMii.
• Teknecal for his guides which helped immensely when starting wii development.
• cwstjdenobs for the original BootMiiSwitch idea.

To the following people for providing translation:

• French - Vlad.
• Italian - Raiden.
• Portuguese - zedascouves.
• Spanish - Mokona Modoki/Comepiedras.
• Dutch/Nederlands – MarioWaza.
• Finnish/Suomi – JaniN.
• German/Deutsch – Helsionium.

External links

• Author's website - http://www.pembo.co.uk/development/bootmii-configuration-editor/
• GBAtemp - https://gbatemp.net/threads/bootmii-configuration-editor.162137/
• GitHub - https://github.com/dpembo/bootmiiconfigurationeditor