From eea1fe12c83dff97c50e3a2302e38bfe9947e783 Mon Sep 17 00:00:00 2001 From: nitraiolo <99681490+nitraiolo@users.noreply.github.com> Date: Sun, 8 Sep 2024 15:54:54 +0200 Subject: [PATCH] Create README-CFG.md --- README-CFG.md | 1169 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1169 insertions(+) create mode 100644 README-CFG.md diff --git a/README-CFG.md b/README-CFG.md new file mode 100644 index 0000000..3d8c50d --- /dev/null +++ b/README-CFG.md @@ -0,0 +1,1169 @@ +# Configurable SD/USB Loader v70r78.11 MOD patched + +![enter image description here](http://cfgusbloader.ntd.homelinux.org/images/USB.png) + +by oggzee, usptactical, gannon, Dr. Clipper, R2-D2199, FIX94, airline38, + Howard, NiTRo THe DeMoN + +This version of the loader allows you to customize numerous options +to better suit your preferences. + + Based on Wanikoko SD/USB Loader 1.5, Kwiirk Yal & cios 222, + Hermes uLoader 1.6 & cios 222/223+mload + many others (Sorg, nIxx, + fishears, usptactical, 56Killer, WiiShizzza, hungyip84, Narolez, ...) + +## Official Site +http://cfgusbloader.ntd.homelinux.org/ + +## Features + + - SDHC and USB HDD device support + - GUI (Grid / Coverflow) and Console mode (switchable at runtime) + - Background Music (.mp3 or .mod) + - Themes (switchable at runtime) + - Themes Browser + - Widescreen (auto-detect) + - Transparency (covers and console) + - Cover images download + - Cover styles: 2d, 3d, disc and full + - Automatic resize of covers + - Renaming game titles (using titles.txt, custom-titles.txt and/or wiitdb.zip) + - Per game configuration of Video mode, Language, Ocarina cheating + - Light up DVD slot when install finishes, optional eject + - Childproof and parental guidance + - USB HDD with multiple partitions supported + (WBFS for games and FAT for config, covers and other resources) + - UStealth MBR supported + - SDHC with multiple partitions supported + (WBFS for games and FAT for resources...) + - Custom IOS selection for better compatibility with USB drives and other USB devices. + - cIOS supported: + davebaol d2x (recommended) + waninkoko 247, 248, 249, 250 251 & 252 + Hermes 222, 223 & 224 (mload) + kwiirk 222 & 223 (yal) + - Banner sounds + - Saving game play time to Wii's play log + - Multiple WBFS partitions support + - Loading games from a FAT or NTFS partition + (cIOS 222/223 rev4+ or cIOS 249 rev18+ required) + - Supported game disc file formats: .wbfs and .iso + - Configurable + + +For latest news, questions and suggestions head over here: +http://gbatemp.net/index.php?showtopic=147638 + + +## Installation: + +Copy the contents of "inSDroot" to the root of your SD card. +This will add the USB Loader to your homebew channel. +You can also install a a channel forwarder to start the loader directly +from the system menu. +(Note: alternatively, a USB FAT partition can be used +to store configuration and covers) + +## Useful links: + +Step-by-step installation instructions for Wii Homebrew and Cfg: +http://gwht.wikidot.com + +The forwarder can be downloaded from here: +http://gbatemp.net/index.php?showtopic=147638&st=5745&p=2420653&#entry2420653 +And installed with the WAD Manager. + +Game cover images can be downloaded from here: +http://wiitdb.com + +Updated titles.txt can found here: +http://wiitdb.com/titles.txt + + +## Default File locations: + + config file: sd:/usb-loader/config.txt + settings file: sd:/usb-loader/settings.cfg + background image:sd:/usb-loader/background.png + covers: + 2d: sd:/usb-loader/covers/2d/*.png + 3d: sd:/usb-loader/covers/3d/*.png + disc: sd:/usb-loader/covers/disc/*.png + full (and HQ): sd:/usb-loader/covers/full/*.png + cache: sd:/usb-loader/covers/cache/*.ccc + titles file: sd:/usb-loader/titles.txt + themes: sd:/usb-loader/themes/THEME_NAME/theme.txt + theme preview: sd:/usp-loader/themes/*.jpg + + ocarina cheat codes are searched in: + sd:/usb-loader/codes/*.gct + sd:/data/gecko/codes/*.gct + sd:/codes/*.gct + ocarina TXT cheat codes use the locations: + Downloaded to: sd:/usb-loader/codes/*.txt + Saved .gct to: sd:/usb-loader/codes/*.gct + + wiitdb: sd:/usb-loader/wiitdb.zip + play history: sd:/usb-loader/playstats.txt + + .wip files: sd:/usb-loader/GAMEID.wip + .bca files: sd:/usb-loader/GAMEID.bca + .wdm files: sd:/usb-loader/GAMEID.wdm + + nand Immage usb:/nand + + Games on FAT/NTFS + : usb:/wbfs/GAMEID.wbfs + or: usb:/wbfs/TITLE [GAMEID].wbfs + or: usb:/wbfs/GAMEID_TITLE/GAMEID.wbfs + or: usb:/wbfs/TITLE [GAMEID]/GAMEID.wbfs + (or sd:/ instead of usb:/) + +These are default locations, background and covers are configurable. +If config file is not found in sd:/usb-loader, then it is searched +in: sd:/apps/USBLoader/config.txt (or whichever directory is used to +start from homebrew channel) and if found, the base path is set to +that location. + +Besides the global config file sd:/usb-loader/config.txt, also +the config.txt in the apps directory is used, which by default is: +sd:/apps/USBLoader/config.txt but depends from where the loader +has been started from the homebrew channel. + +Another way to specify a config file is by using the wiiload +utility from a PC, which allows additional arguments: +C:\> wiiload usbloader.dol config21.txt +which will load sd:/usb-loader/config21.txt +And you can also pass config options directly: +C:\> wiiload usbloader.dol video=ntsc + +So you can have different configurations depending on where it +is started from. This can be useful so you can configure the +loader started from forwarder to be simple/childproff, while +if started from homebrew channel to include the installation and +removal options. +To achieve this, copy sd:/apps/USBLoader/ to sd:/apps/USBLoader_admin +and then set simple=1 in sd:/apps/USBLoader/config.txt and edit (or delete) +sd:/apps/USBLoader_admin/meta.xml to show a different name. + + +## USB FAT for config and covers: + +SD card is first searched for config.txt, if not found then USB HDD +with a FAT partition is mounted as usb:/ and searched, for config.txt. +in that case, all the paths mentioned above will be searched +on usb:/ instead of sd:/ +Advantage of using USB FAT for config and covers is faster loading of +covers. (Usually USB HDD devices are faster than SD cards) +If you want to load the application from SD card but use USB for config +and covers, then copy everything in inSDroot to your USB FAT partition, +but only the inSDroot/apps directory to SD card and +delete sd:/apps/USBLoader/config.txt and sd:/usb-loader/config.txt. + +Note: To create 2 partitions on SD or USB thumb drives you have to use +special tools like gparted: http://gparted.sourceforge.net/ +Create 2 primary partitions, format both as FAT32 and then inside the loader +re-format the SECOND partition to WBFS. Suggested partitions size if 200MB +for config & covers and the rest for WBFS. + +Note: If you have problems accessing the fat partition make sure it is +marked 'active' in the windows partition editor (or if you use gparted, +mark the partition with the 'boot' flag) + +Limitations: +- USB FAT is mounted only if config.txt is not found on SD. + + +Themes: +------- + +Another way to customize the loader is by using Themes. +A theme is defined by creating a config file in the location: +sd:/usb-loader/themes/THEME_NAME/theme.txt +And the background images: +sd:/usb-loader/themes/THEME_NAME/background.png +sd:/usb-loader/themes/THEME_NAME/background_wide.png + +The options that can be used in theme.txt are described below, +basically only options that define the looks are accepted, everything else +is ignored in theme.txt. Background image (background.png or specified with +background option) for a theme will be searched first in the theme +directory (sd:/usb-loader/themes/THEME_NAME/) and if not found +it will be searched in the base directory (sd:/usb-loader/) + +Other themable gui resources: + favorite.png + pointer.png + hourglass.png + font_uni.png (new type 512 letters unicode) + font.png (old type 128 letters ascii) + font_clock.png + window.png, page.png + button.png, radio.png, checkbox.png +Same search method as for the background image applies to these files. +There are some example files in: usb-loader/resources, but note that the program +does not search in that location, they need to be copied to the base or theme +directory to be used. + +Background overlay support: +additional images can be supplied that will be overlaid over the background: + - bg_overlay.png or bg_overlay_w.png for console background + - bg_gui_over.png or bg_gui_over_w.png for gui background +If *_w.png variant is not found then the normal is used. +If a theme is used then the overlay files are searched only in theme directories, +not in base directories. + +Auto-scaling of background image: +Since version 41 background width can be larger than 640 and will be either + - scaled if widescreen + - cropped if not widescreen +down to 640x480. Note: height must still be 480. + +GUI buttons, icons and windows theme images: +button images: button.png, radio.png, checkbox.png +window images: window.png, page.png +States: button images can contain a single button image +or multiple images for different states: +- normal, flash, hover, press, press hover, inactive +Any number of buttons can be present, if some are missing then +the normal state + coloring and effects are used to generate the missing state. +A button width:height must be 2:1, so that the number of states can be +calculated: num = height * 2 / width +Scaling: a button is divided to 3 areas horizontally: 1/4 1/2 1/4 the first +and last are scale proportionally while the middle is streched as much as required. +Round buttons only use the first and last parts. +Similarily a window image is divided also to 3 areas vertically and same rules apply. +The image width and height must be divisible by 4. + + +GUI Mode: +--------- + +By default console mode is started. +To switch to GUI mode, press B in main screen. +While in GUI mode, the following buttons are used by default (they can be remapped): + + button A : start selected game + button B : return to console mode + button LEFT/RIGHT (Grid): previous/next page + button LEFT/RIGHT (Coverflow) : rotate to next cover - hold down for fast rotate. + button UP/Down (Grid) : switch number of rows (1-3) + button UP (Coverflow) : flip center cover to its back/front + button DOWN : change gui styles (grid -> flow -> flow-z -> coverflow 3d -> etc) + button 1, +, - : options, install, remove + button 2: favorites game list + button HOME : exit + +The background image in GUI mode can be changed with the file: + + sd:/usb-loader/themes/Theme_Name/bg_gui.png or + sd:/usb-loader/bg_gui.png + + +## Downloading covers + +Covers can be downloaded for all games at once or on a per-game basis. +To download the covers for all games go to Global Options screen, move +to "" and press button RIGHT or LEFT. +There is a difference between LEFT and RIGHT buttons: +- button RIGHT will download all MISSING covers. +- button LEFT will download ALL covers, even the ones that are already present. +To download the covers for the current selected game, go to Game Options screen, +move to "Cover Image:" option and press RIGHT or LEFT. The same difference between +RIGHT and LEFT buttons apply here as with download all covers. +The way how the covers are downloaded can be further customized with config options +download_* and url_*. See the documentation on these options below in the Config file section. + +## Parental Control and Unlocking Admin Functionality + +If the loader is configured with restricted functionality it can be unlocked +with a password - a "secret" wiimote button combination. Restricted functionality +means any of the options: "simple" or "disable_*" or "hide_game" are set, which is +usually used for "Parental Control". + +When admin mode is unlocked it will allow you to access all the previously +locked functionality. In addition: when unlocked, any games that are hidden +with the hide_game option will be displayed. + +To access the unlock screen, hold the 1 button down for 5 seconds and the screen +will appear. After you see the text "Enter Code:", press the wiimote buttons +in the correct order. If you were successful, the word SUCCESS will appear +on the screen. Otherwise the word LOCKED! will appear. The unlock screen has a 30 +second timeout limit so if an incorrect (or no) password is entered, it will +automatically lock. To set the lock back on with the original settings intact, hold +the 1 button for 5 seconds and the lock will automatically turn on. When the loader +is started, the lock will always be enabled. + +This functionality is controlled by the option: admin_unlock = [1], 0. +By default it is enabled. To disable the ability to unlock admin mode set +the option to: admin_unlock = 0 + +The default admin unlock password is: BUDAH12 +To change it, use the config option: unlock_password = [BUDAH12] +The password length is limited to 10 characters. Do NOT use quotes around the +password - just type what you want it to be. E.g. unlock_password = 12UDAB +The following are the button to letter mappings for the password: + + 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 + +To hide certain games, use the the Game Options screen and toggle the "Hide Game" +setting. This allows you to set which games are hidden when the admin mode is LOCKED. +In order to see this option, admin_unlock must be enabled (which it is by default) AND +the admin mode must be in an unlocked state! +- **NOTE**: this functionality completely replaces the hide_game option in config.txt, + but they CAN be used together. Any games currently listed in hide_game will be + shown when unlocked, but will ALWAYS be marked as hidden by default in Game Options + and cannot be changed to unhidden unless they are removed from config.txt +- **NOTE 2**: An easy way to convert all your games in hide_game to this new functionality + is to start the loader with your hide_game still in config.txt and then go into + Game Options in any game (you may have to unlock admin lock first) and change + something and save it. All your hide_game entries will automatically be saved. + Then you can remove the hide_game entry completely from config.txt. + + +## Various Controllers Button Mapping: +There are 17 possible buttons, listed here with the controller mappings. + + ----------------------------------------------------------- + BUTTON WIIMOTE CLASSIC GC GUITAR NUNCHUK + ----------------------------------------------------------- + UP UP UP UP STRUM UP + RIGHT RIGHT RIGHT RIGHT NONE + DOWN DOWN DOWN DOWN STRUM DOWN + LEFT LEFT LEFT LEFT NONE + - - - - + + + + + + A A A A GREEN + B B B B RED + HOME HOME HOME START + 1 1 + 2 2 + X X X BLUE + Y Y Y YELLOW + Z ZL/ZR Z ORANGE Z + C C + L L L + R R R + +The actions of these buttons can be changed via the button_* options. + +## Title Rename + +To rename a game title, edit the file in sd:/usb-loader/titles.txt +or sd:/usb-loader/custom-titles.txt +Format is: + + GAMEID = Game Title + +Example: + + RSPP = Wii Sports + + + +## Config file: + + # lines starting with # are comments + # default values are in [ ] + # + # There are 2 categories of options: Global and Theme + # Theme options (theme.txt) only affect the looks, everything else is ignored + # Global options (config.txt) will accept all options, including theme options. + # + # + # Theme options: + # ============== + # + # background = [background.png] + # wbackground = [background_wide.png] + # file to use for the background image. + # file can be an absolute path (like sd:/somedir/myimage.png) + # if the specified background is not an absolute path it is searched + # in theme directory (sd:/usb-loader/themes/THEME_NAME/) + # and in default directory (sd:/usb-loader) + # + # background_base = [background.png] + # wbackground_base = [background_wide.png] + # base background image over which the bg_overlay* files are overlaid. + # actually this option is the same as normal background option + # the only difference is that it is understood by versions that + # support overlaid background, which makes it possible to create + # forward and backward compatible themes + # + # background_gui = [bg_gui.png] + # wbackground_gui = [bg_gui_wide.png] + # gui mode background file. + # + # layout = original2 original small medium large large2 [large3], + # ultimate1 ultimate2 ultimate3 kosaic + # original: 6 lines (wanikoko 1.0-1.1) + # original2: 12 lines (wanikoko 1.2-1.5) + # small: 9 lines (same background as original) + # medium: 17 lines + # large: 21 lines (nixx) + # large2: 21 lines (usptactical) + # large3: 21 lines (oggzee) + # ultimate1: 12 lines (WiiShizza) + # ultimate2: 12 lines (jservs7 / hungyip84) + # ultimate3: 12 lines (WiiShizza - cover on right) + # + # + # covers = [1], 0 + # (enable/disable covers) + # + # console_coords = x,y,width,height + # wconsole_coords = x,y,w,h (widescreen) + # + # console_color = foreground,background + # (color values: 0-15) + # Dark: 0=black, 1=red, 2=green, 3=yellow, 4=blue, 5=purple, 6=cyan, 7=bright grey + # Bright: 8=grey, 9=red, 10=green, 11=yellow, 12=blue, 13=purple, 14=cyan, 15=white + # see: http://www.silverpoint.com/leo/color/c-16.gif (0 at top to 15 at bottom) + # + # covers_coords = x,y + # wcovers_coords = x,y (widescreen) + # + # hide_header = [0],1 + # hide_hddinfo = 0,[1] + # hide_footer = [0],1 + # These options control the look of main menu. + # + # simple = [0], 1 + # Using the simple option in a theme will only affect the hide_footer option + # it will not change the disable_* options. Use the simple option in the + # global config.txt to change the disable_* options as well. + # + # colors = [dark], bright, mono + # will select a prefedines set of colors for a dark or bright background + # or normal 2 color text if mono is specified + # + # color_header, color_selected_fg, color_selected_bg, + # color_inactive, color_footer, color_help + # Will set individual text colors. Values are 0-15 + # + # cover_style = [standard], 3d, disc + # Support for 3d covers and disc covers + # This option selects which cover_url and cover_path is used + # + # console_transparent = [0], 1 + # Enable transparent console. + # + # covers_size = width, height + # default: covers_size = 160, 225 + # If the loaded image is if different size, it will be to the size specified. + # + # wcovers_size = width, height + # default: wcovers_size = 130, 225 + # used for widescreen setting. If not set it will use the covers_size + # and properly scaling it to widescreen size. + # + # cursor = ">>" + # Changes cursor shape, at max 2 characters are used. Can be empty. + # If you want spaces, so that the menu is not shifted use quotes + # like this: cursor = " " + # + # menu_plus = "[+] " + # Changes the [+] mark in the main, options and start menu. + # At max 4 characters are used. + # + # gui_text_color = [black], white, RRGGBBAA + # Set the text color in GUI mode + # Note: to use a color other than a black or white, it has to be + # represented as a HEX value with the following components: RRGGBBAA + # RR=red, GG=green, BB=blue, AA=alpha + # Example: red = FF0000FF, blue = 00FF00FF, yellow = 00FFFFFF + # + # gui_text_outline = [FF], AA, RRGGBBAA, black, white + # gui_text_shadow = [00], AA, RRGGBBAA, black, white + # Outline and shadow color for text in GUI mode + # If only alpha is specified, it will set the outline / shadow + # color to black or white depending if text color is bright or dark. + # + # gui_text2_color = [white], black, RRGGBBAA + # gui_text2_outline = [FF], AA, RRGGBBAA, black, white + # gui_text2_shadow = [00], AA, RRGGBBAA, black, white + # Text colors for coverflow modes, where background is darker + # + # gui_title_top = [0], 1 + # If 1, gui text appears above covers. If 0, below. + # + # coverflow_reflection = color_top, color_bottom + # color is hex rgba, 0,0 will disable reflections + # default: coverflow_reflection = 666666FF, AAAAAA33 + # + # gui_cover_area = x, y, w, h + # default: gui_cover_area = 20, 24, 600, 408 + # minimum accepted w, h: 480, 320 + # enabling debug will draw the area rectangle + # + # gui_title_area = x, y, w, h + # default: 0,0,0,0 meaning, position depends on gui_title_top + # min w, h: 320, 10 note: h is not yet used + # + # gui_clock_pos = x, y + # default: -1,-1 meaning, title position is used + # clock position, if set clock is displayed all the time + # + # gui_page_pos = x, y + # default: -1,-1 meaning, title position is used + # specifies the page indicator position + # + # preview_coords = x,y,width,height + # wpreview_coords = x,y,width,height (widescreen) + # Settings for the Theme Preview image. + # If X and/or Y is set to -1, the Cover X and/or Y position is used. + # Either W or H (or both) should be set to zero to maintain the correct + # aspect ratios. If both are set to zero, the Cover width is used and the + # height is scaled accordingly. + # + # home = [reboot], exit, hbc, screenshot, priiloader, wii_menu, + # , + # What to do when an exit button (typically home) is pressed in the menus + # Also changes the operation of button_H in the gui and game list. + # is a 4 letter magic word for Priiloader + # is a 4 letter channel ID in upper case to launch + # If home=screenshot then home has to be held for 1 second to make a screenshot + # otherwise it will exit to HBC + # + # buttons=[options_1], options_B, original + # (change button controls layout in the gui and game list.) + # + # The button layout "options_1" is: + # button B - GUI mode + # button 1 - options menu + # + # The button layout "options_B" is: + # button B - options menu + # button 1 - GUI mode + # + # The button layout "original" is obsolete, but is: + # button 1 - options menu + # button B - nothing + # + # button_B = [gui], , , + # button_- = [main_menu], , , + # button_+ = [install], , , + # button_H = [reboot], , , + # button_1 = [options], , , + # button_2 = [favorites], , , + # button_X = A, B, 1, [2], H, -, +, , , + # button_Y = A, B, [1], 2, H, -, +, , , + # button_Z = A, [B], 1, 2, H, -, +, , , + # button_C = [A], B, 1, 2, H, -, +, , , + # button_L = A, B, 1, 2, H, [-], +, , , + # button_R = A, B, 1, 2, H, -, [+], , , + # These buttons can be mapped to any of the following actions in the game list and gui: + # nothing # does nothing + # options # access game options + # gui # switch to/from GUI + # reboot # reboot to system menu + # exit # exit to launching app + # hbc # exit to HBC + # screenshot # take a screenshot + # install # install a game + # remove # remove a game + # main_menu # access main menu + # global_ops # access global options menu + # favorites # toggle favorites view + # boot_game # boot a game from the drive + # boot_disc # boot a game from disc + # theme # switch to next theme + # profile # switch to next profile + # unlock # access the unlock password dialog immediately + # sort # switch to next sort + # filter # access filter menu + # priiloader # access Priiloader via magic word Daco + # wii_menu # get Priiloader to launch Wii Menu via magic word Pune + # # is a 4 letter magic word for Priiloader + # # is a 4 letter channel ID in upper case to launch + # X, Y, Z, C, L & R can also be optionally targetted to emulate one of the buttons + # on the Wiimote (A, B, 1, 2, -, +, Home). This emulation will function everywhere. + # + # button_cancel = [B], + # Set which button(s) will act as the back button in menus + # Valid button values in the list are: + # B, 1, 2, -, M, Minus, +, P, Plus, H, Home, X, Y, Z, C, L, R + # + # button_exit = [Home], + # Set which button(s) will perform the 'home' action in menus + # Valid button values in the list are: + # B, 1, 2, -, M, Minus, +, P, Plus, H, Home, X, Y, Z, C, L, R + # + # button_other = [1], + # Set which button(s) will perform the other or alternate action in menus + # This covers switching between options and global options, choosing to + # download BCA during install, choosing to ignore meta.xml during upgrade etc. + # Valid button values in the list are: + # B, 1, 2, -, M, Minus, +, P, Plus, H, Home, X, Y, Z, C, L, R + # + # button_save = [2], + # Set which button(s) will perform the save action in menus + # Valid button values in the list are: + # B, 1, 2, -, M, Minus, +, P, Plus, H, Home, X, Y, Z, C, L, R + # + # gui_window_color_base = RRGGBBAA default: FFFFFF80 + # gui_window_color_popup = RRGGBBAA default: FFFFFFB0 + # + # gui_text_color_menu = COLOR / OUTLINE / SHADOW + # gui_text_color_info = COLOR / OUTLINE / SHADOW + # gui_text_color_title = COLOR / OUTLINE / SHADOW + # gui_text_color_button = COLOR / OUTLINE / SHADOW + # gui_text_color_radio = COLOR / OUTLINE / SHADOW + # gui_text_color_checkbox = COLOR / OUTLINE / SHADOW + # default: + # gui_text_color_menu = white / A0 / 44444444 + # gui_text_color_info = white / A0 + # each component can be "black", "white" or RRGGBBAA + # OUTLINE and SHADOW are optional + # Setting gui_text_color_menu will set all the colors except info + # Setting gui_text_color_button will also set radio and checkbox + # + # gui_button_NAME = X, Y, W, H, TextColor, image.png, Type, HoverZoom + # NAME can be: main settings quit style view sort filter favorites jump + # TextColor is same format as gui_text_color_menu + # (Seting TextColor to 0 will disable text on the button in case icons are used) + # Type: button or icon + # HoverZoom: 0-50 in % + # Paramteres after coordinates are optional. Default values: + # gui_button_NAME = X, Y, W, H, white/A0/44444444, button.png, button, 10 + # + # gui_bar = 0, [1], top, bottom + # Will disable / enable gui bar or enable only top or bottom. + # + # Global options: + # =============== + # + # gui = 0, 1, 2, 3, [4], start + # gui = 0 : GUI disabled + # gui = 1 : GUI enabled, GUI Menu disabled, start in console mode + # gui = 2 : GUI enabled, GUI Menu disabled, start in GUI mode + # gui = 3 : GUI Menu enabled, start in console mode + # gui = 4 : GUI Menu enabled, start in GUI mode + # gui = start : same as gui = 4 + # + # gui_transition = [scroll], fade + # Set GUI transition effect between console and gui mode + # + # gui_style = [grid], flow, flow-z, coverflow3d, coverflow2d, frontrow, vertical, carousel + # Set the default GUI style + # + # gui_rows = [2] (Valid values: 1-4) + # Set the default number of rows in GUI mode + # + # gui_lock = [0], 1 + # Disable changing gui style with button up/down + # + # gui_antialias = [4] {0-4} + # Tune coverflow mode antialias level + # + # gui_pointer_scroll = 0, [1] + # disable/enable pointer scrolling of the game list + # + # theme = Theme_Name + # Load a specified theme from sd:/usb-loader/themes/Theme_Name/theme.txt + # Note: a theme resets all theme related options, so if you want to override + # any theme option, do that in the lines after the 'theme =' option. + # + # covers_path = [sd:/usb-loader/covers] + # Changing covers_path will change all covers_path_* like this: + # covers_path_2d = covers_path/2d + # covers_path_3d = covers_path/3d + # covers_path_disc = covers_path/disc + # covers_path_full = covers_path/full + # If you need fine controll on the 2d/3d/disc/full paths use the + # covers_path_* options after covers_path. + # + # URL options: + # URL can contain any of the following tags which are then replaced + # with proper values: {REGION}, {WIDTH}, {HEIGHT}, {ID3}, {ID4}, {ID6}, {ID}, {CC}, {PUB} + # {ID} will find automatically the correct ID by trying ID6, ID4 and ID3 + # Note: {WIDTH} and {HEIGHT} don't work well if download_all_styles is enabled + # {PUB} os the last two digits of the ID and can be used to get covers from other + # regions. E.g., replace {ID6} with {ID3}P{PUB} to look for PAL covers. + # + # Multiple URLS can be specified for cover_url_* options + # They can be in the same line separated with space, example: + # cover_url = http://site1.com/{ID}.png http://site2.org/{ID}.png + # Or in multiple lines using =+ to add instead of =, example: + # cover_url = http://site1.com/{ID}.png + # cover_url =+ http://site2.org/{ID}.png + # cover_url =+ http://site3.net/{ID}.png + # + # Normal 4:3 mode aspect ratio url options: + # cover_url = URL (url for standard 2d flat covers) + # cover_url_3d = URL (url for 3d covers) + # cover_url_disc = URL (url for disc covers) + # cover_url_full = URL (url for full covers) + # cover_url_hq = URL (url for HQ full covers) + # + # defaults: + # + # cover_url = http://wiitdb.com/wiitdb/artwork/cover/{CC}/{ID6}.png + # + # cover_url_3d = http://wiitdb.com/wiitdb/artwork/cover3D/{CC}/{ID6}.png + # + # cover_url_disc = + # cover_url_disc =+ http://wiitdb.com/wiitdb/artwork/disc/{CC}/{ID6}.png + # cover_url_disc =+ http://wiitdb.com/wiitdb/artwork/disccustom/{CC}/{ID6}.png + # + # cover_url_full = http://wiitdb.com/wiitdb/artwork/coverfull/{CC}/{ID6}.png + # + # cover_url_hq = http://wiitdb.com/wiitdb/artwork/coverfullHQ/{CC}/{ID6}.png + # + # download_id_len = 4, [6] + # Specifies the downloaded cover ID length for the saved file name + # + # download_all_styles = [1], 0 + # Download all cover styles (flat,3d,disc), or just the current style + # + # download_cc_pal = [AUTO], EN, FR, DE, AU, ... + # The code is used as a replacement for {CC} tag for PAL regions. + # If AUTO is specified, then the code is set depending on the console + # country - if Australia: AU, Brasil: PT else, console language is used. + # If image is not found with the specified cc code, download is + # retried with EN code. + # + # titles_url = http://wiitdb.com/titles.txt?LANG={DBL} + # Url for updating titles.txt + # + # device = [ask], usb, sdhc + # Specifies which device to use when starting the loader + # + # partition = [auto], ask, WBFS1, ...WBFS4, FAT1, ...FAT9, NTFS1, ...NTFS9 + # Specifies which partition to use when starting the loader + # Note: the -222 version defaults to FAT1 instead. + # + # simple = [0], 1 + # (enable/disable simple/childsafe mode) + # setting simple=1 will change all disable_xxx options and + # hide_footer to 1 and confirm_start to 0. + # setting simple=0 will do the opposite. + # any of the disable_xxx, hide_xxx and confirm_start options can be set individually. + # + # confirm_start = [1], 0 + # Specifies if confirmation is required when starting a game + # + # disable_remove = [0],1 + # disable_install = [0],1 + # disable_options = [0],1 + # disable_format = [0],1 + # fine permissions control + # + # admin_unlock = [1], 0. + # If enabled it will allow unlock admin mode, so you will be able to access + # all the settings screens that simple or disable_* options disabled. + # + # unlock_password = [BUDAH12] + # Set the password for admin unlock + # + # install_partitions = [only_game], all, 1:1, iso + # controls which partitions from DVD are installed to HDD + # - 1:1 disable scrubbing, except for the last 256kb which are stil scrubbed + # because of a wbfs limitation: the wbfs block size not aligned to wii disc size + # - iso: On NTFS it creates an exact dump to an iso file + # On WBFS/FAT it will behave same as 1:1 + # + # fat_split_size = [4], 2, 0 + # Selects if the split is at 4: 4gb-32kb or 2: 2gb-32kb + # or 0: no splits - ntfs only + # + # fat_install_dir = [1], 0, 2, 3 + # Select install filename layout on fat: + # fat_install_dir = 0 /wbfs/GAMEID.wbfs + # fat_install_dir = 1 /wbfs/GAMEID_TITLE/GAMEID.wbfs + # fat_install_dir = 2 /wbfs/TITLE [GAMEID]/GAMEID.wbfs + # fat_install_dir = 3 /wbfs/TITLE [GAMEID].wbfs + # fs_install_layout is an alias for fat_install_dir + # + # ntfs_write = [0], 1, norecover + # 0 will disable and 1 will enable ntfs write support + # norecover will enable write but prevent mounting an uncleanly unmounted fs + # in case recovery on the PC is preferred. + # + # music = [1], 0, filename, PATH + # Play background music (only one option has to be specified) + # Examples: + # music = 1 + # (which is default) will randomly play all .mp3 or .mod + # files (whichever are found first) in sd:/usb-loader dir + # music = sd:/usb-loader/my_music.mp3 + # Plays my_music.mp3. The file name can be specified + # relative to sd:/usb-loader or an absolute pathname. + # music = sd:/music + # Will randomly play all .mp3 or .mod files in that folder. + # music = 0 + # Will disable music + # + # widescreen = [auto], 0, 1 + # * If widescreen is enabled (or autodetected) then the following options are used: + # - wbackground + # - wbackground_base + # - wbackground_gui + # - wconsole_coords + # - wcovers_coords + # - wcovers_size + # * when in widescreen mode, cover images will be searched first by + # the name GAMEID_wide.png and if not found then by GAMEID.png and + # will be resized properly. + # * some layouts will specify widescreen cooridinates automatically + # like: large3 and ultimate3, so there is no need to specify them manually, + # if one of these layouts are used. + # + # hide_game = [0], GAMEID1, GAMEID2, ... + # Hide games from list (can be used for parental control) + # Multiple games can be specified in one line separated by comma "," + # or each game in a separate hide_game = GAMEID line. + # setting hide_game = 0 will reset the hide list. + # GAMEID is a 4 letter game ID. + # Example: hide_game = RZZP, RDCP + # + # pref_game = [0], GAMEID1, GAMEID2, ... + # Preffered games, to be shown first in the list. + # Syntax is same as with hide_game. + # Example: pref_game = RHAP, RSSP + # + # confirm_ocarina = [0], 1 + # Specifies if confirmation is required when ocarina is enabled + # and codes have been found + # + # cursor_jump = [0] or N + # Sets how much moves left/right (if 0 do a end page / next page jump) + # + # start_favorites = [0], 1 + # Start with the favorites game list + # + # clock_style = [24], 12, 12am, 0 + # Set clock style, 0 will disable clock + # + # sort_ignore = [A,An,The], ... + # Which starting words to ignore when sorting titles + # Separate words via commas, do not incude the square brackets + # Set sort_ignore = 0 for old sort method - to not ignore anything + # + # debug = [0], 1, 8 + # Display some diagnostic messages when started + # Benchmark mode with debug = 8 and start or install a game + # + # debug_gecko = [0],1,2,3 + # write debug info to usb gecko (1=debug,2=console,3=both) + # + # profile_names = [default], name2, name3,... + # Profiles - aka multiple favorite groups + # (max profiles:10, max profile name length: 16) + # Profiles can be added, removed and reordered with this option. + # But if you want to rename it, you will need to change the profile + # name also in settings.cfg otherwise it will be considered as a new + # name and the old one will be forgotten next time you save settings. + # Profiles can be switched in the global options screen. Changing a + # game favorite setting is done as usual in the game options screen. + # + # profile = name + # will specify the default profile to use + # saving global settings will also save which profile is used + # + # profile_start_favorites = {[0], 1} ... + # specifies when each profile is switched to if favorites should be enabled or disabled. + # profile_start_favorites 0 1 1 1 1 1 1 1 1 1 + # + # db_url = [http://wiitdb.com/wiitdb.zip?LANG={DBL}] + # URL to download database from. + # + # db_language = [AUTO], EN, JA, German, etc + # Language to use for the {DBL} tag. If invalid or not able to be + # displayed by the loader this will default to English. + # Both country codes (EN) and languages (English) are valid. + # + # db_show_info = [1], 0 + # Show info loaded from the database. + # + # db_ignore_titles = [0], 1 + # Set this to ignore titles from the database when naming games. + # + # write_playstats = [1], 0 + # Write to the play history file. + # + # sort = [title-asc], etc + # Change the default sorting method. Default is Title Ascending. + # + # Valid sort options: + # "title" => Title + # "players" => Number of Players + # "online_players"=> Number of Online Players + # "publisher" => Publisher + # "developer" => Developer + # "release" => Release Date + # "play_count" => Play Count + # "install" => Install Date + # (This will only work with FAT or NTFS drives) + # "play_date => Last Play Date + # + # To use ascending add "-asc" to the option. + # ie: sort = players-asc + # + # To use descending add "-desc" to the option. + # ie: sort = players-desc + # + # translation = [AUTO], EN, custom, etc. + # Current auto values: JA, EN, DE, FR, ES, IT, NL, ZH, ZH, KO + # Any filename is supported as long as a corresponding translation + # file exists. Translation files currently exist for DE, DK, ES, FI, FR, + # GR, IT, JA, KO, NL, NO, PT_BR, PT_PT, TR, ZH_CN, ZH_CN-clamis, ZH_TW + # + # load_unifont = [0], 1 + # Specifies if unifont.dat should be loaded or not. unifont.dat contains + # all the unicode characters, required for ASIAN language support so that + # translation or wiitdb info shows up correctly. + # load_unifont automaticly switches to 1 if translation starts with JA, KO or ZH + # or if db_language is JA, KO, ZH + # Note: the LATIN unicode set is already embedded into the loader, + # so to display German, French, Spanish, etc... unifont.dat is not needed + # + # wiird = [0], 1, 2 + # 1 = enable debugger + # 2 = enable debugger and pause start + # + # select = [previous], start, middle, end, most, least, random + # Selects which game is picked by default on startup. + # The new default is the previous game played (to get old + # operation, set select=start). + # 'start', 'middle' and 'end' refer to position in the list. + # 'most' and 'least' refer to number of plays (in Cfg). + # 'random' selects a different game each time. + # + # adult_themes = [0], 1 + # determines if adult themes can be downloaded + # + # theme_previews = [1], 0 + # determines if the theme preview images should be downloaded and displayed + # + # return_to_channel = [0], auto, JODI, FDCL, ... + # Games will return to the selected channel ID + # e.g., JODI for HBC or a forwarder channel like FDCL or DCFG + # to reload Cfg. + # 0 is the default Wii Menu operation + # auto: will try to detect the channel id from where the loader was started. + # (although some forwarders are not auto detected properly, + # but the official one by FIX94 is) + # + # disable_nsmb_patch = [0],1 + # disable_pop_patch = [0],1 + # disable_dvd_patch = 0,[1] + # Optionally disable patches performed by the loader. + # + # nsmb = New Super Mario Bros. + # pop = Prince of Persia: The Forgotten Sands + # dvd = disc check patch for Hermes. + # + # PoP requires that you disable the dvd patch + # Set an option to 1 to disable (i.e., not patch) + # + # gamercard_url = URL + # gamercard_key = key + # These options work like the cover_url options + # and support the =+ operator to add multiple sites/keys. + # Keys and URLs are matched up in respective order. + # + # If you set a key in the list to 0, or leave out trailing keys, the + # respective sites from the URLs will not be tried. + # + # The tags {KEY} and {ID6} can be used in the URLs. + # + # Defaults are for WiinnerTag, NCard and DUTag in that order, but with blank keys: + # gamercard_url = http://www.wiinnertag.com/wiinnertag_scripts/update_sign.php?key={KEY}&game_id={ID6} + # gamercard_url =+ http://www.messageboardchampion.com/ncard/API/?cmd=tdbupdate&key={KEY}&game={ID6} + # gamercard_url =+ http://tag.darkumbra.net/{KEY}.update={ID6} + # gamercard_key = 0 0 0 + # + # intro = 0, 1, [2], 3 + # intro=0 : black - only allowed when direct game launching + # intro=1 : black bg with program name (small) + # intro=2 : color image [default] + # intro=3 : grey image + # This option only works if set in meta.xml + # + # nand_emu_path = [usb:/nand] + # sets the path whare a nand image is located. It must be a fat drive. + # + # save_filter = [0], 1 + # enables games filters persistance on a per profile basis. + # + # custom_private_server = [wiimmfi.de], STRING + # custom WFC server. Max len 14. + # + # nintendont_config_mode = [file],arg + # file = parameters are passed to nintendont rewriting nintendont config file + # arg = parameters are passed to nintendont via command line argument + # + # update_nintendont = [0],1 + # enables nintendont update with other plugins. + # + # Game Compatibility Options: + # =========================== + # + # These options can be set in the global config.txt + # The options can be set also per-game from inside the loader + # options screen and will be saved to settings.cfg + # + # video = [auto], game, system, pal50, pal60, ntsc + # (auto is same as game) + # + # language = [console], japanese, english, german, french, spanish, + # italian, dutch, s.chinese, t.chinese, korean + # + # video_patch = [0], 1, all, sneek, sneek+all + # 'video_patch = 1': This will patch NTSC -> PAL modes if console is PAL + # and PAL -> NTSC modes if console is NTSC + # This will not change interlaced / progressive mode + # 'video_patch = all' will force all modes to the selected video mode. + # This will also force progressive / interlaced mode, depending on what + # is configured in wii settings. This can be used for example to force + # progressive mode if the game will otherwise use interlaced mode (MPT) + # + # vidtv = [0], 1 + # Required by some games (Japanese,...) + # + # country_patch = [0], 1 + # Country Patch for better compatibility with some games + # + # fix_002 = [0], 1 + # This is the Anti 002 fix. It is not needed for new cIOSes (IOS249 rev14+) + # + # ios = 247, 248, [249], 222-mload, 223-mload, 224-mload, 222-yal, 223-yal, 250 + # Select Custom IOS + # Note: 222-yal is for kwiirk's cIOS + # Note: 222-mload is for Hermes's cIOS and is the default for the -222 version + # Note: a few seconds of delay when starting a game with custom ios is expected. + # + # block_ios_reload = 0, 1, [auto] + # Required by some games, works with d2x cios and in a limited way for hermes cios + # 0: disabled, 1: enabled, auto: enable if cios is d2x and ver >= 5 + # + # alt_dol = [0], 1, sd, disc + # Alternative .dol loading option (from NeoGamma by WiiPower) + # If set to 1 or sd it will load the .dol from + # the loader base dir + GAMEID.dol (4 letter ID) + # [ sd:/usb-loader/GAMEID.dol ] + # If set to disc it will prompt with a list of .dols on the wbfs iso image + # + # ocarina = [0], 1 + # enable/disable ocarina - cheating engine + # + # hooktype = nohooks, [vbi], wiipad, gcpad, gxdraw, gxflush, ossleep, axframe + # specify ocarina hook type + # + # write_playlog = [0], 1, 2, 3 + # Write gameplay stats to the Wii message board log. + # This option won't work when the Wii Menu is skipped before + # starting Cfg (e.g., using Priiloader or BootMii autoboot). + # 0 = off, do not write to the Wii Message Board log. + # 1 = on, set title based on the value of the language option unless + # the title in that language is blank where it then uses the + # English title or the Japanese title (whichever is valid). + # 2 = on, set title to the Japanese title. + # 3 = on, set title to the English title. + # In the per-game menu, these options show up as "Off", "On", + # "Japanese Title" and "English Title" respectively. + # + # clear_patches = [0],1,all + # When on (1) return_to_channel and the dvd check are disabled + # When 'all', then all .dol patches are disabled + # + # mem_card_emu = [0], 1, 2 + # Emulation GC memory card: + # 0 = disabled + # 1 = enabled with separate memory card per game + # 2 = enabled with shared memory card + # + # mem_card_size = [0], 1, 2, 3, 4, 5 + # Emulated GC memory card size: + # 0 = 59 blocks (512KB) + # 1 = 123 blocks (1MB) + # 2 = 251 blocks (2MB) + # 3 = 507 blocks (4MB) + # 4 = 1019 blocks (8MB) + # 5 = 2043 blocks (16MB) + # + # private_server = [0],1,2,3 + # Nintendo Wi-Fi Connection (WFC) patching: + # 0 = Off + # 1 = NoSSL only + # 2 = wiimmfi.de + # 3 = Custom string from "custom_private_server" + # + # Profile Options: + # ================ + # + # The options can be set per-profile from inside the loader + # and will be saved to settings.cfg + # + # profile_filter = [all], online, unplayed, genre(*), features(*), controller(*), gamecube, wii, channel, duplicate, game_type(*), search(*) + # (*) = requires extra options + # + # profile_filter_genre = action, adventure, fighting, music, platformer, puzzle, racing, role-playing, shooter, simulation, sports, strategy, arcade, baseball, basketball, bike_racing, billiards, board_game, bowling, boxing, business_simulation, cards, chess, coaching, compilation, construction_simulation, cooking, cricket, dance, darts, drawing, educational, exercise, first-person_shooter, fishing, fitness, flight_simulation, football, futuristic_racing, golf, health, hidden_object, hockey, hunting, karaoke, kart_racing, life_simulation, management_simulation, martial_arts, motorcycle_racing, off-road_racing, party, petanque, pinball, poker, rail_shooter, rhythm, rugby, sim_racing, skateboarding, ski, snowboarding, soccer, stealth_action, surfing, survival_horror, table_tennis, tennis, third-person_shooter, train_simulation, trivia, truck_racing, virtual_pet, volleyball, watercraft_racing, wrestling + # + # profile_filter_feature = online, download, score, nintendods + # + # profile_filter_controller = wiimote, nunchuk, motionplus, gamecube, nintendods, classiccontroller, wheel, zapper, balanceboard, microphone, guitar, drums, camera, dancepad, infinitybase, keyboard, portalofpower, skateboard, totalbodytracking, turntable, udraw, wiispeak, vitalitysensor + # + # profile_filter_gametype = wii, gamecube, all_channels, wiiware, vc_nes, vc_snes, vc_n64, vc_sms, vc_md, vc_pce, vc_neogeo, vc_arcade, vc_c64, wii_channels, fwd_emu + # + # profile_search_field = title, synopsis, developer, publisher, id6, region, rating, players, online_players, play_count, synopsis_len, covers_available + # + # profile_search_string = STRING + # Max len 100 chars. + # + +## Config file sample: + + # USBLoader config + # lines starting with # are comments + # see README-CFG.txt for help on options + # theme + theme = GreyMatter + # gui + gui = start + gui_transition = fade + gui_style = flow + gui_rows = 2 + # device + device = usb + ntfs_write = 1 + # language related options: + # translation = XX + # db_language = XX + # this is required for asian languages: + # load_unifont = 1 + # NAND Emulation (wiiware/VC) + nand_emu_path = usb:/nand + # Return to loader + return_to_channel = UCXF + # Multiple profile filter config + profile_names = sample1, sample2 + save_filter = 1 + # GC memory card emulation + mem_card_emu = 1 + mem_card_size = 2 + # Nintendont + nintendont_config_mode = arg + update_nintendont = 1 + +## Sample titles.txt file: + + RFNP = Wii Fit + RHAP = Wii Play + RSPP = Wii Sports + RMGP = Super Mario Galaxy + +## Changelog: + +See ChangeLog.txt