Configurable Options

Configurable USB Loader's options explained

This page provides a list of all Configurable USB Loader's options with notes about how to use them. Each entry will be given with the definition from README-CFG.txt which can be found in every .zip version of the loader. This page starts by describing the file types used, then describes the options and finally shows the options used in the sample GAF config. You will also find the Configurable USB Loader Configurator which is a Windows application which helps you set all these values in a GUI and creates the config.txt and theme.txt files needed to configure the loader.

This page was most recently updated with the release of version 51 of Configurable USB Loader.

Description of Files

Global Options (config.txt)

Config.txt is a file which lets you configure many aspects of the Loader. It is generally located in sd:/usb-loader/ and/or sd:/apps/USBLoader/. Wherever it is first found is the base directory used for all other paths. Both config.txt files will be read if you have one in each of the mentioned folders. The rest of this page assumes you have both and thus will use sd:/usb-loader as the base directory.

Theme Options (theme.txt)

Configurable USB Loader allows you to provide separate themes which you can switch between while running the Loader. This is performed via the Global Options Menu. A theme.txt file for each theme is stored in sd:/usb-loader/themes/theme-name/ containing options that describe the given theme. The startup theme is chosen in config.txt with the theme option.

Theme overrides (config.txt)

While all options can appear in config.txt, including theme options, some of them behave differently. If the same option appears in both theme.txt and config.txt, then the file with priority depends on the option. The following options use the value in config.txt as their value:

• hide_header
• hide_hddinfo
• hide_footer
• buttons
• simple
• cover_style
• cover_size
• wcover_size
• cursor
• menu_plus
• gui_text_color
• gui_text_outline
• gui_text_shadow
• gui_text2_color
• gui_text2_outline
• gui_text2_shadow
• gui_title_top

The other theme options will use the value in theme.txt.

Game Settings (settings.cfg)

Settings.cfg is where all the options saved within the loader itself are stored. This is predominantly the favorites and hidden games, along with all the per-game settings. In addition, several options may be saved here when you perform the action to save all settings at the Global Options screen (by pushing 2). If these options are located in settings.cfg, they override the same settings in config.txt. The options that may appear in settings.cfg are:

• theme - Theme to load at startup
• profile - Default profile to load at startup
• device - Default device where games are stored (SD/USB)
• partition - Default partition where games are stored
• gui_style - Initial GUI style at startup
• gui_rows - Inital number of rows for gridflow GUI styles

Background Images

There are four default background images: background.png, background_wide.png, bg_gui.png and bg_gui_wide.png. The loader will first look in the chosen theme directory and then the base directory for these files. The names of these images can be changed using the background_base and background_gui options. Note that if the wide versions are not present, the values of the 4:3 options will be checked as well.

Overlay images

There are four default background images: bg_overlay.png, bg_overlay_w.png, bg_gui_over.png and bg_gui_over_w.png. The loader will only look in the chosen theme directory (or the base directory when no theme is chosen) for these files. Overlay files are an image that is placed over the background image, typically with transparency. This can be used to add the same set of buttons to every background image used, or to automatically add console fading when a transparent console is desired.

Other Images

The GUI has several other images that can be changed by adding files to either the theme or base directories. See the full zip of Configurable USB Loader for examples. The following files are allowed:

Filename	Description
favorite.png	icon that appears on favourites
pointer.png	mouse pointer, the point should be at the centre
hourglass.png	picture displayed while covers load
font.png	allow changes of characters within the font for GUI text
font_uni.png	adds latin Unicode characters to the font set for GUI text
font_clock.png	allow changes of characters within the font for clock text

Options

Options will be described by particular statements upon what you would like to do. The options handled by each section are listed in parentheses for ease of searching. Expand statements that you want to find out more about. For a list of all available options, see the README-CFG.txt file from the latest version of Configurable USB Loader. Options are separated between theme and global options to let you know where you can use them. The usage of the options in question is shown in a box with the default value shown in bold. If you don't want to edit the file yourself, we have created a tool for you

Configurator

The Configurable USB Loader Configurator allows you to set all options and write theme.txt and config.txt out to files. Use the information below to work out which values you want and simply set them in the Configurator. Here's a look at the main interface and console wizard for theme generation from v50:

Installation

The Configurator is a Windows Application and the latest version, v52.4, can be downloaded here. Check the files link at the bottom of the page for older releases.

Just unzip the zip and run CfgLoaderConfigurator.exe to use the app.

Sample button images can be found here.

Configurator is now mostly convertible into other languages. You can change the tooltips for all controls and text for buttons and so on. This simply needs the inclusion of five files in the same directory as the executable. Sample versions of those files, including instructions within the files themselves, can be found here.

A Spanish translation has been created by PabloACZ of GBAtemp and Emudesc, the latest version of which can be found here.

If you are using a Mac or Linux, you should be able to run the same application using Mono (v2.4.2 or later). Please use the discuss link at the bottom of this page if you have problems

Theme Options (theme.txt and/or config.txt)

Tweaking the look of the menu mode

I want to change the menu's background image to a different filename. (background, wbackground, background_base, wbackground_base)

background = background.png
wbackground = background_wide.png
background_base = background.png
wbackground_base = background_wide.png

Change these to the appropriate filename. A path can also be used. If no path is given, the theme directory will be searched, followed by the base directory. The [w]background_base options have been available since v41 and allow further customisability of the background. They support image sizes wider than 640*480 (height must still be 480). These larger images are cropped to the correct size in 4:3 mode or stretched to fill the screen in 16:9 mode. In addition, the overlay files mentioned earlier will be placed over these background images.

Use the non-base options for backwards compatibility with v40 of Configurable USB Loader and below. You should put the base options after the non-base version to ensure correct operation.

I want to change the menu layout to one of the pre-defined layouts. (layout)

layout = original, original2, small, medium, large, large2, large3, ultimate1, ultimate2, ultimate3, kosaic

Choose a default pre-defined layouts for console and covers. Changing this option affects almost all other theme options.

I want to choose what sort of covers display in the menu and GUI flow modes. (covers, cover_style)

covers = 1, 0
cover_style = standard, 3d, disc

Turn covers display off with covers=0. Set the type of cover to display, either flat cover, 3d cover or disc art. This option also affects covers_size.

I want to change the position or size of covers on the menu screen. (covers_coords, wcovers_coords, covers_size, wcovers_size)

covers_coords = x,y
wcovers_coords = x,y
covers_size = width, height
wcovers_size = width, height

X and y are the coordinates of the top-left corner of the covers. Width and height are the size in pixels.

I want to change the position or size of the games-listing console on the menu screen. (console_coords, wconsole_coords)

console_coords = x,y,width,height
wconsole_coords = x,y,width,height

Provide coordinates of the top left corner (x, y) and size (width, height) for the console (text box).

I want to change the colors of the console text and background. (colors, console_color, color_header, color_selected_fg, color_selected_bg, color_inactive, color_footer, color_help)

colors = dark, bright, mono

Sets default values for dark, bright or monochromatic (black and white) color sets .

console_color = foreground,background

Choose colors for the foreground game list text and background of the console. Valid values are 0-15 matching the EGA colors shown here.

color_header = 0-15
color_selected_fg = 0-15
color_selected_bg = 0-15
color_inactive = 0-15
color_footer = 0-15
color_help = 0-15

These options set specific header, footer, the 'selected game bar' and help text to different EGA colors

I want to make the console background transparent so I can see the image behind the text. (console_transparent)

console_transparent = 0, 1

Set the console transparent to 1 to not draw the background for the console box. If the color_selected_bg is the same as the background color set in console_color, then it is also not shown.

I don't want some of the menu information to display, such as the header or footer. (hide_header, hide_hddinfo, hide_footer, simple)

hide_header = 0,1
hide_hddinfo = 0,1
hide_footer = 0,1
simple = 0,1

Set the hide_* options to turn off the header text, hard disk drive info and footer text respectively. Setting simple to 1 will turn off both hddinfo and footer (although it only controls hide_footer in -fat versions). Note that simple is also a global option, so it has different operation if it appears in config.txt.

I want to change the look of text markers such as the cursor or [+] in menu mode. (cursor, menu_plus)

cursor = "»", " ", "->", …
menu_plus = "[+] ", …

Change the display of the cursor or [+] symbols. Both options require quotes surrounding the necessary string. The cursor must be two characters (including spaces) and menu_plus can be between 1-4 characters.

Tweaking the look of the GUI mode

I want to change the GUI's background image to a different filename. (background_gui, wbackground_gui)

background_gui = bg_gui.png
wbackground_gui = bg_gui_wide.png

Change these to the appropriate filename. A path can also be used. If no path is given, the theme directory will be searched, followed by the base directory. These options support image sizes of 640*480 or wider (height must still be 480). Larger images are cropped to the correct size in 4:3 mode or stretched to fill the screen in 16:9 mode. In addition, the overlay files mentioned earlier will be placed over these background images.

I want to change the text color, shadows and outline in the GUI mode. (gui_text_color, gui_text_outline, gui_text_shadow, gui_text2_color, gui_text2_outline, gui_text2_shadow,)

gui_text_color = black, white, RRGGBBAA
gui_text_outline = 00, black, white, RRGGBBAA, AA
gui_text_shadow = 00, black, white, RRGGBBAA, AA
gui_text2_color = black, white, RRGGBBAA
gui_text2_outline = FF, black, white, RRGGBBAA, AA
gui_text2_shadow = 00, black, white, RRGGBBAA, AA

The gui_text_* options affect gridflow GUI modes (grid, flow, flow-z). The gui_text2_* options affect the coverflow modes (coverflow3d, coverflow2d, frontrow, vertical, carousel).

Set the gui_text_color to black, white, or an 8 character hexadecimal representation of the colour where RR = red, GG = green, BB = blue and AA = alpha (transparency). The outline and shadow of the text can be set to be a fully selectable hex colour, like the main one. If only a 2 character code is given (AA) then the colour of the shadow and outline will be white if the main colour is dark and black if the main colour is bright.

I want to change the position of the GUI text. (gui_title_top)

gui_title_top = 0,1

0 is below the covers, 1 is above.

Control

I want to use different buttons to access the GUI or options. (buttons)

buttons= options_1, options_B, original

Options_B will switch controls so that B selects options and 1 switches between the menu and GUI. Original does not feature controls for the GUI.

Global Options (config.txt only)

General look and feel

I want to set a default theme at startup. (theme)

theme= Theme_Name

Theme_Name should be the name of a subdirectory in the themes folder, e.g., GAF. The corresponding theme.txt will be utilised when starting. If no theme is given, the theme options in config.txt are used.

I want to have different sets of favorites for different users or genres of games. (profile, profile_names)

profile_names = default, name1, name2, …

List your profile names with this option. The order of the list is the order of the profiles in the profile selection menu. Profile names can be separated by either commas or spaces.

profile = profile_name

Set this option to one of the names in the profile_names option to choose the default profile to load at startup. If not set, or set to an invalid value, the first profile in the profile_names list will be loaded.

I want to play music. (music)

music = sd:/usb-loader, 1, 0, filename, path

You can turn off music with 0. Using 1 will play music.mp3. You can specify your own filename for music (in .mp3 or .mod format), with or without a path. If you specify a path without a filename, then the loader will randomly select any of the .mp3 or .mod files (note that the default value is a path).

I want to force the screen aspect to 16:9 or 4:3. (widescreen)

widescreen = auto, 0, 1

Auto will use the Wii's setting to determine which mode to use, although you can force one or the other.

I want to start in favorites mode. (start_favorites)

start_favorites = 0, 1

Games marked as favorites will be the only ones to show. You can still switch to seeing all games.

Tweaking the menu mode

I want to be able to see markers for favorite games and other features in the console menu. (console_mark_page, console_mark_favorite, console_mark_saved)

console_mark_page = 0, 1
console_mark_favorite = 0, 1
console_mark_saved = 0, 1

Page adds a plus mark to the bottom of games lists that continue. Favorite prefixes games marked as favourites with a star. Saved marks games that have saved options with a hash.

I want to choose how far the cursor moves when pushing left/right in the menu. (cursor_jump)

cursor_jump = 0,1,2,3…

If set to 0, the Left/Right burrons on the D-pad will go to the next page of games. Setting a different number provides a fixed jump amount of that number (e.g., 10 to move 10 games at a time). D-pad Up/Down will always move one at a time.

Tweaking the GUI mode

I want to make the console start in GUI mode or disable the GUI entirely. (gui)

gui = 1, 0, start

Setting gui to start will make the Loader launch the GUI immediately while setting it to 0 will stop it from coming up at all.

I want to change the transition effect between the GUI and menu. (gui_transition)

gui_transition = scroll, fade

This one's pretty self explanatory.

I want to change the default GUI mode that is set at startup. (gui_style, gui_rows)

gui_style = grid, flow, flow-z, coverflow3d, coverflow2d, frontrow, vertical, carousel
gui_rows = 1, 2, 3, 4

Grid, flow and flow-z have multiple lines, settable by gui_rows, and use cover_style type covers. The others are all coverflow modes with a single row and use full covers.

I want to force one GUI mode so that I can't accidentally change it. (gui_lock)

gui_lock = 0,1

Setting this option disables the actions of the up/down D-pad buttons to change GUI mode.

I want to change the anti-aliasing level in the coverflow GUI modes. (gui_antialias)

gui_antialias = 0, 1, 2, 3, 4

The higher the number, the more antialiasing will be performed. Antialiasing will reduce jagged edges by a large degree at a small cost of processing time.

I want to change the mode the clock displays in on the GUI. (clock_style)

clock_style = 24, 12, 12am, 0

Choose 24 hour time, 12 hour time, 12 hour time with am/pm indicator or turn the clock off respectively.

Covers

I want to change the URLs used to download covers. (cover_url, cover_url_3d, cover_url_disc, cover_url_full, download_cc_pal)

cover_url = URL
cover_url =+ Additional_URL/s
cover_url_3d = URL
cover_url_3d =+ Additional_URL/s
cover_url_disc = URL
cover_url_disc =+ Additional_URL/s
cover_url_full = URL
cover_url_full =+ Additional_URL/s
download_cc_pal = AUTO, EN, FR, DE, ES, IT, NL, PO, AU, …

The URLs for each cover_style will be searched in order. If the cover is not found at the first link, the next will be tried and so on. There are some tags that can be used within URLs to expand to various game specific values:

TAG	Expansion
{REGION}	Expands to pal, ntsc or ntscj based on the 4th character of the game ID
{WIDTH}	Expands to the current cover width value
{HEIGHT}	Expands to the current cover height value
{ID3}, {ID4}, {ID6}	Expands to the 3, 4 or 6 digit ID of the game
{ID}	Tries {ID6}, {ID4}, and {ID3} in sequence
{PUB}	Expands to the 2 character publisher code from the ID (the last two characters)
{CC}	Expands to EN, US or JA based on the 4th character of the game ID. PAL games will also try the value of download_cc_pal first.

Thus, if you prefer your PAL covers to be shown in French, use "download_cc_pal = FR". Or if you prefer Australian covers, use "download_cc_pal = AU". In the case that the cover site does not have covers from your chosen country, the EN cover will be tried automatically. If you leave this option at the default (AUTO), your console's region will be checked to attempt to determine your location. These options will not affect US, Japanese or Korean games, which maintain their own region.

If you want to download covers from another region if they don't exist in the region of the game, then replace {CC} with the appropriate value and {ID6} with {ID3}E{PUB} where E is the region code of the wanted game. For example, to automatically download NTSC 2D covers from WiiTDB when the local region covers do not exist, you could have the following two links in order:
cover_url = http://wiitdb.com/wiitdb/artwork/cover/{CC}/{ID6}.png
cover_url = http://wiitdb.com/wiitdb/artwork/cover/US/{ID3}E{PUB}.png

The default URL options are as follows:

cover_url = http://wiitdb.com/wiitdb/artwork/cover/{CC}/{ID6}.png
cover_url =+ http://boxart.rowdyruff.net/flat/{ID6}.png
cover_url =+ http://www.muntrue.nl/covers/ALL/160/225/boxart/{ID6}.png
cover_url_3d = http://wiitdb.com/wiitdb/artwork/cover3D/{CC}/{ID6}.png
cover_url_3d =+ http://boxart.rowdyruff.net/3d/{ID6}.png
cover_url_3d =+ http://www.muntrue.nl/covers/ALL/160/225/3D/{ID6}.png
cover_url_disc = http://wiitdb.com/wiitdb/artwork/disc/{CC}/{ID6}.png
cover_url_disc =+ http://boxart.rowdyruff.net/fulldisc/{ID6}.png
cover_url_disc =+ http://www.muntrue.nl/covers/ALL/160/160/disc/{ID6}.png
cover_url_full = http://wiitdb.com/wiitdb/artwork/coverfull/{CC}/{ID6}.png
cover_url_full =+ http://www.muntrue.nl/covers/ALL/512/340/fullcover/{ID6}.png

I want to only download specific cover styles, not all at once. (download_all_styles)

download_all_styles = 1, 0

By default, all cover styles (flat, 3d, disc art and full) will be downloaded for each game. Change this setting to 0 to only download the cover that is currently set by cover_style.

I want to change the path where images are saved. (covers_path, covers_path_2d, covers_path_3d, covers_path_disc, covers_path_full)

covers_path = sd:/usb-loader/covers
covers_path_2d = covers_path
covers_path_3d = covers_path/3d
covers_path_disc = covers_path/disc
covers_path_full = covers_path/full

Covers_path changes all paths (as shown), or you can set each separately.

I want to choose how many characters my downloaded images have in the filename. (download_id_len)

download_id_len = 4, 6

The Loader will detect either type of file, regardless of this setting, but newly downloaded images will be saved in the selected format. Prior to v45b, the default value of this option was 4.

Child/idiot proofing

I want to only push A once to start games, avoiding the menu. (confirm_start)

confirm_start = 1, 0

Set this to 0 to avoid being asked to confirm starting the game. Options can still be changed using the 1 button from the game list/GUI if disable_options=0. Note that banner sounds play on the confirmation page, so if you want to hear them, then set this option to 1 and ensure it appears after the simple option if present.

I want to remove features and/or make the Loader child proof. (simple, confirm_start, disable_remove, disable_install, disable_options, disable format)

simple = 0, 1
confirm_start = 1, 0
disable_remove = 0,1
disable_install = 0,1
disable_options = 0,1
disable_format = 0,1

Setting simple=1 will change all disable_* options and hide_hddinfo and hide_footer to 1 and confirm_start to 0.

The disable options disable various features of the loader and are self-explanatory. See the previous section for a description of confirm_start. Note that banner sounds play on the confirmation page, so if you want to use simple and still hear them, then set confirm_start to 1 after setting simple=1.

Also see the next statement about hiding games from the kids to find out how to turn these options back on again via password.

I want to hide particular games from the kids or enable disabled features via password. (admin_unlock, unlock_password, hide_game)

admin_unlock = 0, 1
unlock_password = BUDAH12

When this setting is enabled, it will allow all screens normally locked by the simple or disable_* settings to be unlocked via a "secret" wiimote button combination. This also gives access to the Hide Game option on the option menu, which allows you to select games that will be hidden when admin mode is switched off. To access the unlock screen, hold the 1 button down for 5-10 seconds and an "Enter Code:" prompt will appear. Press the wiimote buttons in the order specified by the unlock_password to unlock. To set the lock back on with the original settings intact, hold the 1 button for 5-10 seconds again.

Note that if you set admin_unlock to 0, the loader will always operate in locked mode. There will not be a way to unlock it.

The unlock password can be up to 10 characters long and is mapped to Wiimote buttons as follows:

D-Pad Up:     U
D-Pad Down:   D
D-Pad Right:  R
D-Pad Left:   L
B button:     B
A Button:     A
Minus button: M
Plus button:  P
Home button:  H
1 button:     1
2 button:     2

hide_game = 0, GAMEID1, GAMEID2, …

Listing games here is equivalent to locking them in the loader, except that you cannot change the value of the hide_game option within the loader. GAMEIDs should be in the 4 character form.

I want to reorder some games by preference. (pref_game)

pref_game = 0, GAMEID1, GAMEID2, …

List the games to be listed before the others. GAMEIDs should be in the 4 character form.

Game loading

I want to use a specific IOS as default. (ios)

ios = 249, 222-yal, 222-mload, 223-yal, 223-mload, 250

Mload options are for Hermes' IOS222/223, Yal options are for kwiirk's

I want to force the video mode for import games or to get 480p. (video, video_patch)

video = game, system, patch, pal50, pal60, ntsc
video_patch = 0, 1, all

Set screen video format to force. Very important for import games. Try 'system' if 'game' doesn't work.
video_patch=all is primarily useful for games that should display in 480p but don't (e.g., Metroid Prime Trilogy). You would be best off setting this value only on those games that need it within the loader rather than setting it here, though.

I want the games to default to a specified language. (language)

language = console, japanese, english, german, french, spanish, italian, dutch, s.chinese, t.chinese, korean

Force the language the games try to use.

I want to use the VIDTV patch to get Japanese text displaying. (vidtv)

vidtv = 0, 1

Required by some games, especially Japanese games to get fonts working.

I want to use the country patch. (country_patch)

country_patch = 0, 1

Country Patch for better compatibility with some games

I am getting 002 errors and want them to stop. (fix_002)

fix_002 = 0, 1

Anti 002 Fix for use with IOS249 revisions 9, 10, 12 and 13b.

I want to block IOS reloading for compatibility with certain games. (block_ios_reload)

block_ios_reload = 0, 1

Required by some games, but only works with ios: 222-mload, 223-mload

I want to use the alt .dol method on all games. (alt_dol)

alt_dol = 0, 1

You almost certainly don't want to use this option. The per-game option is much easier.

I want to make all my games use cheats by default. (ocarina)

ocarina = 0, 1

Are you really sure you want to do this?

I want to disable the New Super Mario Bros. Wii Patch. (disable_nsmb_patch)

disable_nsmb_patch = 0, 1

Disables the NSMB patch so that you can use it patched in another way, such as WIP or BCA.

Storage

I want to choose which partition is used at startup. (partition)

partition = WBFS1, …, WBFS4, FAT1, …, FAT9, NTFS1, …, NTFS9, ask

This chooses which WBFS, FAT or NTFS partition is chosen at startup. If you choose ask, the loader will ask you which to use.

I want to choose where the files split on FAT partitions. (fat_split_size)

fat_split_size = 4, 2

The files ripped by the loader will be split at a size of XGB-32kB where X is the value of the option.

I want to choose whether games use directories on FAT partitions. (fat_install_dir)

fat_install_dir = 0, 1, 2

When 0, files install directly into the wbfs directory (fat:/wbfs/GAMEID.wbfs). When 1, each game has it's own directory starting with the ID (fat:/wbfs/GAMEID_Title/GAMEID.wbfs). When 2, the directory names start with the title instead (fat:/wbfs/Title [GAMEID]/GAMEID.wbfs).

I want to choose the device (SD/USB) where the loader installs and looks for games. (device)

device = ask, usb, sdhc

You can force the loader to use a USB drive or SD cards when searching for games, or let it ask you.

I want to choose whether to rip the update partitions in games or not. (install_partitions)

install_partitions = all, only_game, 1:1

The all value installs the update partitions with the game. No game currently require these other partitions to be present, but this may change. 1:1 will not remove any data and will install a full copy of the disc, taking much more space than usual.

Titles and database info

I want to change the way titles are sorted. (sort, sort_ignore)

sort = title, players, online_players, publisher, developer, release, play_count, play_date, install, title-asc, title-desc, etc.
sort_ignore = A,An,The

The startup sort method can be any of the listed types in either ascending (-asc suffix) or descending (-desc suffix) mode. If a suffix is not provided, ascending sort is assumed.

sort_ignore provides a comma separated list of terms that should be ignored at the start of game names in title sorts. E.g., with the default option, "The Legend of Zelda: Twilight Princess" will be sorted as if it were "Legend of Zelda: Twilight Princess". Set to blank or "0" to do a purely alphabetical sort.

I want to change where titles.txt is downloaded from. (titles_url)

titles_url = http://wiitdb.com/titles.txt?LANG={CC}

Set the URL for titles.txt. CC will use your Wii's type and download_cc_pal to download the correct language.

I want to change the language of the game info database. (db_language)

db_language = AUTO, EN, English, FR, French, ES, Spanish, …

Choose your language via two character code or full language name. AUTO will use the country setting on the Wii to automatically detet your language.

I want to change where wiitdb.zip (the game info database) is downloaded from. (db_url)

db_url = http://wiitdb.com/wiitdb.zip?LANG={DBL}

Set the URL for wiitdb.zip. DBL will use your Wii's type and db_language to download the correct language.

I want to change whether the console menu shows database info. (db_show_info)

db_show_info = 0, 1

Turn database info in the console menu on or off. This uses two lines of space in the console.

I want to change whether play statistics are recorded by the loader (write_playstats)

write_playstats = 0, 1

When on, playstats are written to playstats.txt in the base directory.

Others

I want to change how the loader exits when I push Home. (home)

home = reboot, exit, screenshot, hbc

Choose whether the console is rebooted, the loader exits to the calling application (typically the Homebrew Channel) or whether it launches the Homebrew Channel directly.

See the next section for the screenshot option.

I want to take screenshots. (home)

home = reboot, exit, screenshot

Set home=screenshot and the first time you push the Home button, a screenshot will be saved in sd:/usb_loader/ as screenshot1.png or the next available number up to 99 if the file already exists. If you push the Home button twice in a row, the Loader will exit on the second push (after saving a screenshot).

See the previous section for the other values of this option.

I want to choose whether Ocarina cheats require confirmation. (confirm_ocarina)

confirm_ocarina = 0, 1

Self-explanatory

I want to see debug information. (debug)

debug = 0, 1, 8

Debug information includes paths where files are being searched for and other data. 1 provides default debug data. 8 will benchmark a game's read speed instead of actually playing the game.

GAF's config.txt and theme .txt

The config.txt provided in the sample GAF config is listed below:

theme = GAF
device = usb
gui = start
gui_style = coverflow3d

This simply sets the device to default to the USB drive and starts in GUI mode with the GAF theme selected using the coverflow3d layout as default.

The theme.txt provided in the sample GAF config is listed below:

background = backgroundGAF.png
wbackground = backgroundGAF_wide.png
layout = large3
covers = 1
cover_style = 3d
console_transparent = 1

This sets a default large3 template layout with transparent custom background and 3d covers.

The locations of files contained in the sample GAF config and their descriptions are listed below:

Filename	Description
apps/USBLoader/config.txt	Global options file
USB-Loader/config.txt	Copy of global options file
USB-Loader/themes/GAF/theme.txt	Theme options file
USB-Loader/themes/GAF/backgroundGAF.png	Menu background image for 4:3
USB-Loader/themes/GAF/backgroundGAF_wide.png	Menu background image for 16:9
USB-Loader/themes/GAF/bg_gui.png	GUI background image for 4:3
USB-Loader/themes/GAF/bg_gui_wide.png	GUI background image for 16:9
USB-Loader/themes/GAF/pointer.png	Change mouse pointer in GUI mode

Bibliography

1. full source reference