Dr. Clipper

We need some new forwarders for Cfg (and the other USB Loaders could likely benefit too). HBC now supports command line options by including them within meta.xml in the same directory as boot.dol. Using that, we could get the same functionality that was previously only possible via having two Cfg types (the plain and -222 releases).

We'd like to kill off the need for the -222 releases and go back to a single version, but that needs new forwarders that read meta.xml and feed Cfg the correct argument string. The format is easy to parse, so it shouldn't be too hard to code, and it gives us a lot of benefits. The arguments appear in meta.xml like this:

<arguments>
<arg>ios=222-mload</arg>
</arguments>

The forwarder would then just need to launch Cfg with "sd:/apps/USBLoader/boot.dol ios=222-mload" as if were the command line. If further arguments appeared within the <arguments></arguments> block, they just get listed in the argv arguments the same way. In this manner, both HBC and the forwarder will launch Cfg the same way, so it doesn't matter how the user set things up.

If we can get some forwarders that support this feature, even if it's just one forwarder, that'd be great. It'll makes things so much simpler to still be able to have the benefit of the -222 launching without the double releases of each Cfg version.

Please indicate if you plan to work on this in the thread, and if more information is needed, we're happy to help.

This thread can be used to find the latest translation files for Configurable USB Loader and the Configurator in your language.

Translators: feel free to make new posts when you make a new version, but also edit your original post to store the latest version as well, or use a Google Docs link (instructions here) so that the link to the file never changes. That way, the links in this top post won't become stale.

All translation links:

Click a contributor's name to see their translation. Where there are multiple contributors for a language, check each to find the latest available version.

Cfg Loader:
English template
Italian translation by Cambric
Dutch translation by tj_cool and wiiuser2
Spanish translation by TyRaNtM
German translation by Geridian, WiiNero, FIX94 and TheRealVisitor
French translation by Jabe
Brazilian Portuguese translation by mangojambo, leonleao and tarcis
European Portuguese translation by pplucky
Simplified Chinese translation by kavid, happycipher and clamis
Traditional Chinese translation nhlay
Japanese translation by hosigumayuugi
Korean translations by sarangx and cheeries4u
Greek Translation by xxdimixx
Danish Translation by Fox888
Turkish Translation by tuzruhu
Norwegian translation by Stigmatic

Configurator:
English defaults
Spanish translation by PabloACZ
French translation by orwel
Dutch translation by wiiuser2
Italian translation by wiixale
Japanese translation by hosigumayuugi
German translation by FIX94

Configurable USB Loader Translation Files

Usage:

The translation files come as a single file called <language>.lang where <language> can be any string. The file must be saved using UTF-8 format (this can be done in Notepad). These files should be stored in the languages subdirectory of the base directory of Cfg (typically sd:/usb-loade/languages/). The file that will be used is set by the "translation" option in config.txt. Hence, perform the following actions to install a new language for Cfg:

1. Download <language>.lang from the links below.
2. Add "translation=<language>" to config.txt

Translating:

Note that for translations with special characters (see the image below for the non-special characters), you need to add load_unifont=1 into config.txt.


To make your own translation, download the English template, change the file name to <your_language>.lang, then edit the msg_str lines.

Translations come in the form:



In this case, you would replace the text "Additional config:" with whatever is in msgstr.

"\n" is used within some strings to represent a new line. "%" followed by a string of characters and numbers represents a variable that will be filled in at runtime, like a game's name or ID. You can put this % string anywhere within your replacement, but you cannot change the order of % strings very easily.

Character Set:
There are two sets of characters in Cfg. The first set consists of the Latin sets of characters with a few extra characters like ★ for "Captain ★ Rainbow". This set is fixed in the console views, but you can change the look of the GUI characters by adding a font_uni.png file to the base directory (or theme). The font_uni.png file can be generated from any font with the Configurator and this font can be of any size. These characters can be seen in the following image (displayed in the Cfg console font):


And here are the characters themseves so that you can copy and paste them if you like:

�☺☻♥♦♣♠•◘○◙♂♀♪♫☼►◄↕‼¶§▬↨↑↓→←∟↔▲▼
!"#$%&'()*+,-./0123456789:;<=>?
@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_
`abcdefghijklmnopqrstuvwxyz{|}~
αβΓπΣσµτΦΘΩδ∞φε∩★€ ™
 ¡¢£¤¥¦§¨©ª«¬­®¯°±²³´µ¶·¸¹º»¼½¾¿
ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖ×ØÙÚÛÜÝÞß
àáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿ
ĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğ
ĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹĺĻļĽľĿ
ŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞş
ŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵŶŷŸŹźŻżŽžſ
ƀƁƂƃƄƅƆƇƈƉƊƋƌƍƎƏƐƑƒƓƔƕƖƗƘƙƚƛƜƝƞƟ
ƠơƢƣƤƥƦƧƨƩƪƫƬƭƮƯưƱƲƳƴƵƶƷƸƹƺƻƼƽƾƿ
ǀǁǂǃDŽDždžLJLjljNJNjnjǍǎǏǐǑǒǓǔǕǖǗǘǙǚǛǜǝǞǟ
ǠǡǢǣǤǥǦǧǨǩǪǫǬǭǮǯǰDZDzdzǴǵǶǷǸǹǺǻǼǽǾǿ

The remainder of the Unicode font set is encoded in the file unifont.dat. This file changes the look of the font in both the console and the GUI. The Configurator can generate this file from an existing font. The characters that appear here must be of the size 8*16 or 16*16, but they are scaled to the size of the GUI font when used in the GUI. To use this font, you must add "load_unifont=1" to your config.txt

Links:

See "All translation links" section above.

Configurator Translation Files

Usage:

The translation files come as a set of files with the .cdb (Configurator DataBase) extension, typically zipped. Simply unzip the files and store them without changing their names in the same directory as the Configurator executable.

Translating:

To make your own translation, download the sample cdbs, then edit them.

Translations come in three forms. An example control looks like:



The first string is the control name and must not be changed. The second string (after the |) is the tootltip that will appear when you hover the mouse over the control. The third is the text that appears on the control. To perform a translation, replace the second and third strings. Note: the third string is optional. Not all controls have text.

Another form of translation is for certain strings in the Configurator and looks like:



In this case, the listed string (indicated via number) will be translated by replacing the text within the quotes. {0} and other numbers will be replaced by text and the replacement hint will usually be given via comment (starting with '#').

The third form of translation is for the menus in the main Configurator form and they look like:



This is similar to the strings format, but with the addition of the & character before keyboard shortcuts into the menu (accessed by the Alt key). The & character is not printed, but will make the following character underlined when accessing the menu via the keyboard (Alt-F will select the file menu for example). Feel free to set the shortcut letter to whatever you like, but try to ensure all translations in each menu have unique shortcuts.

Within any translation, the '\' character will be replaced with a new line, allowing you to space out your tooltips and strings nicely and so on.

Further instructions are located in configurator.cdb within the sample cdbs zip.

Links:

See "All translation links" section above.

Intro

So, due to my love for Configurable USB Loader and having a little spare time, I decided to create an often requested application that allows you to configure all of Configurable USB Loaders many options in a GUI. Here's how it looks:




And here's all the major screens, click them to see them full size:


If you were previously scared off by the official README_CFG.txt, then this application is for you.

Features

• Load/Save any valid option values to/from config.txt and theme.txt
• Load/Save any valid option values to/from settings.cfg
• Load/Save your gameplay statistics to/from playstats.txt (read/write settings.cfg to do so)
• GUI Menu Wizard
• Cover downloading wizard for those without online Wiis
• Manage profiles for different lists of favorites
• All options have descriptive tool tips to help you understand what they are for
• Collate all necessary files into the one directory for easy setup on the SD card
• Create your own background files from any image
• Create your own background overlay including transparent boxes to display the games
• Create a gui font file from any font already installed on your PC
• Visualise the console screen and set text colours as well as console and cover coordinates and size
• Language options allow translators to translate the options and tool tips

Download

One of the latest versions, for v68 of Configurable USB Loader, is available here. Just unzip the executable and run it. However, check the end of the thread for even more recent versions. It is best to place the executable into your Cfg Loader base directory (typically, SD:/usb-loader).

If you are using windows, you require .Net Framework 2.0 from Microsoft to use the application. You probably already have it, but if you get errors at startup, then install .Net Framework from here.

If you aren't using Windows, you can use Mono to run this application. This should work fine for Mac OSX and Linux people. EeZeEpEe provides the following notes for perople using Mac OSX:


And Xiino provides the following notes for Ubuntu Linux as discovered by Lupo96 on another forum:



If you don't currently use Configurable USB Loader, instructions to install it are available through this tutorial, which also details all the necessary applications needed to get homebrew running on your Wii in the first place.

Instructions

Find out about config.txt and theme.txt by reading my tutorial page or looking at README-CFG.txt (included with every full release of Configurable). Configurator is pretty straight forward with the instructions at the top left. Basically, just load your input files, change whatever options you want and then save them back. Each option has a check box, name and a choice of possible values in that order. If the check box is checked, the option will be saved with the specified value to the appropriate files when you use the buttons down below. If you uncheck a box, it will return to its default value and will not be written out. If you don't know what an option does, hover the mouse over it for 2 seconds and a tooltip will show up to tell you its meaning. Most of the possible values for the options also have tooltips that indicate what it means to select that value.

The overlay wizards allow you to create your own overlay images and resizes background images to the appropriate size. With this, you can take any desktop background an turn it into a Configurable USB Loader theme in just a minute or two.

The console wizards allow you to see a mock-up of the menu view to see what your screen will look like. It also allows you to change the colour, size and coordinate options and copy those values back to the main window when you are done. You can get additional instructions for it via the "Instructions" button.

The installation wizard gathers all the necessary files from around your drive and stores them in the correct directory structure, ready to be copied to your SD or USB card directly (or write them directly to the card/drive with the app if you like).

The installation wizard also can be used to create font images from any font installed on your PC.

Translation
Configurator supports alterations of almost all of the text for all tool tips and button text and so on. Text file databases for performing the translations are available here. Just put them in the same directory as the executable and they will be loaded in on startup. Instructions can be found within the configurator.cdb file within the zip.

An example of how the loader looks after translation can be seen in PabloACZ's Spanish translation (available in the resources section below):



Resources

These resources might come in handy when using the Configurator:

console font:
FixedSys Excelsior 3.01 - Install this font if the console wizard text looks funny.

milcoi's button images:
buttons layer with white text
Buttons layer with black text
buttons-layer-black-no-shadow
buttons-layer-black-no-shadow-small
buttons-layer-white-no-shadow
buttons-layer-white-no-shadow-small
Original Wii buttons (.png) + smaller version 30px + Wii font

language databases:
Sample English language version
Spanish translation by PabloACZ
French translation by orwel
Dutch translation by wiiuser2
Italian translation by wiixale
Japanese translation by hosigumayuugi

Feedback

Please point out any trouble you have or bugs you find in this thread. There's bound to be a few still left in there with Configurable's over 100 options.

Planned Features
The following is on the To-do list:

• Tool tips to describe what each option value means
• Menu screen mock-up to demonstrate console size
• Mouse drag and drop for console and cover edges in cover wizard (rubber banding)
• Ability to resize the console mock-up to emulate widescreen stretch (overlay wizard does this job for now)
• Fixing up issues with Tab Stops and Tabbing
• File Collation Wizard to gather files and put them in the correct directory structure
  

Archived Versions

List of all released versions of the Configurator: