USB Loader GX

Discussion in 'Wii - Backup Loaders' started by cyrex, Apr 19, 2009.

  1. cyrex

    cyrex GBAtemp Regular

    Apr 3, 2009
    Gambia, The
    Team USB Loader GX is proudly presenting:


    :!: ATTENTION :!:
    Google closed its Googlecode service and USBLoaderGX is now hosted on Sourceforge.
    As a result, the automatic update feature can't download files from googlecode anymore and will not detect new version located on the new host (sourceforge).
    The current "USBLoaderGX windows Installer 1.8" is also based on googlecode website and will NOT install the latest version. A new installer might be released one day.

    If you are using a revision older than r1257, you need to update USBLoaderGX manually.


    Download the latest Official version available on our website.
    Extract the file using 7zip or winrar to your device and replace the old files with the new ones.
    If you are using the Full channel which is not maintained anymore, please follow this tutorial to replace it with the forwarder channel.
    We are sorry for the inconvenience.

    There exists different (unofficial) modded versions of the loader. They are listed here for convenience.
    - @fledge68 made a plugin mod, allowing wiiflow plugins to work on USBLoaderGX 1262 : r1262 plugin mod2
    - @GreyWolf released some updates and fixes of 1263 : Greywolf's 1263 mod with latest nintendont settings added
    - @Badablek is maintaining a "tabmod" of latest releases : March 11th 2018 build, 1268+tabmod+nintendont cfg_v8 fix

    Download All-in-one package v3.0 (r1180) (OLD VERSION!)
    Contains the latest official release: The loader r1180, Latest channel and the forwarder v5.1 for wii only. Also contains the "forwarder.dol" for Priiloader.

    Download the loader only (Current official version!)
    Contains standard version of the latest official release only. No other file included, no forwarders, etc.

    Manually download ALL existing versions from 2.0 to latest compiled version (last beta, etc.)

    Download Wii and vWii UNEO Forwarder only
    Targets: device:/apps/usbloader_gx/boot.dol and device:/apps/usbloadergx/boot.dol
    On Wii, the installed channel requires IOS58.

    Note for WiiU users:
    vWii Forwarder link update on 2014-12-05. Please download and install "v5.1 Fix" over your old v5.1 to get USB support from the forwarder.

    WiiU forwarder Channel
    You can install this WiiU channel on WiiU Menu to automatically launch the installed UNEO forwarder on vWii. (you need both)


    This loader is based on the original by Waninkoko (v1.1) with many features of his v1.5. So far SD-support is not implemented for Wii games.
    I hope we can grant most of your wishes and we will try to keep your suggestions in mind. Anyway we are thankfull for all suggestions and bug reports.

    IRC channel on Join #gui-usbloader-chat
    or just use this simple command on your irc client: /server -m -j #gui-usbloader-chat

    Template files and manuals

    • No real manual yet, but we are in the process of writing it on our website's Wiki.
    • The template for the latest theme's files can be found HERE.
    • The template for the latest language's files can be found HERE.
    • You can watch old v1.0 Videotutorials here:

    Boxarts/DVD covers

    • If you wii has internet connection, Boxart and DVD covers can be downloaded directly from the loader. Press "1" button and select the type of cover (Flat or 3D) or the DVD label.
      If you want to download a full offline cover pack, you can go to, these packs are updated every weeks. ( is now


    ([​IMG] = new features since 3.0 r1227)
    • The GUI is completely based on the awesome libwiigui by Tantric
    • Look and feel like the original Wii Menu: Use rumble feature, button sounds, background music, disc slot lights up etc. (you can also turn it off in the settings).
    • Real Wii system menu feeling with our improved System Menu Player with Channels and Banners animation!
    • Use the real Wii font from the console to look even better.
    • Supports Dumping and Launching of GameCube games through Dios Mios Lite v1.2+ (DML), DIOS MIOS, Devolution and Nintendont.
    • Supports Launching of triforce arcade games through Quadforce.
    • Supports multi-disc GameCube games.
    • Supports WiimmFi custom network server. [​IMG]
    • Game information: Reads gameinfos from a xml file in your config folder like publisher, developer, year, rating, genre etc.
    • Wide-screen support: Without any special themes for wide-screen.
    • Alternative dol loading: Supports special dol files needed to launch some games (internal or external dol).
    • Block games from reloading another IOS: No need to use alternative dol booting method (e.g. Metroid Prime Trilogy, Sam&Max or CSI games) (needs cIOS d2x v6+).
    • Loading homebrew and USBLoaderGX settings files from SD or USB (Support up to 8 partitions, FAT32/NTFS/ext2/3/4).
    • Works with AHB access and IOS58. No cIOS required to use the loader and launch GameCube or channels.
    • Supports WiiU virtual Wii mode.
    • Auto-detects and set the correct screen aspect-ratio based on your WiiU video settings. [​IMG]
    • Supports UStealth (modified HDD MBR's signature to prevent WiiU's format message).
    • Supports WiiU pro controller inside USBLoaderGX interface, on both Wii and vWii. [​IMG]
    • Works without a connected HDD to list games from other origins (NAND, EmulatedNand or GameCube).
    • Supports arguments from meta.xml on boot.
    • Global Settings and "per game" settings.
    • Parental control: Read levels for each game via the games database or on user request, locks every menus and buttons one by one.
    • Four different Layouts: Simple Game list, Game Grid, Game Carousel, Channel grid.
    • Display games from multiple origins simultaneously : Wii games, GameCube Games, Channels on Wii, Channels on Emulated NAND.
    • Searching for games via on-screen keyboard.
    • Themes support: Download themes from the loader or create your own.
    • Covers support: Download "normal" covers, 3D covers and disc-images for all the games on your HDD.
    • Custom animated banner download for GameCube games.
    • Language file support (use your native language for the loader).
    • Custom sounds: Direct streaming supports for AIF/MP3/OGG/BNS/WAV.
    • List sorting & Favorites: You can sort the list by playstats, names, favorites ranking and number of players. You also can display your favorites only.
    • Create and sort games by categories. (Tutorial)
    • Update function: Update to the latest revision from inside the GUI (requires internet connection).
    • Playstats: Shows you how many times you played the game.
    • Playlog: Log the game you played to the Wii message board (You need to exit the game to the wii menu).
    • Return to the loader (or any installed channel) when exiting a game to the Wii menu. Needs the UNEO forwarder or the UNLR channel installed. (Works best with cIOSx d2x v4+)
    • Gamer tag compatible, to send the launched game to a dynamic signature creation website, such as Winnertag or DUtag.
    • Compatible with both USB ports (needs Hermes cIOS or d2x v9+).
    • List all games from all partitions and from both USB ports at the same time (needs Hermes cIOS or d2x v9+).
    • Full d2x cIOS support with it's new features (Block IOS Reload, Return To, Sector Sizes > 512b, NAND Emulation).
    • Supports USB3.0 hard drives.
    • Supports hard drives with 4kb sector size for FAT32, NTFS and WBFS. (needs cIOSx d2x v6+)
    • WBFS partition with 4kb sector size allows you to store more than 500 games.
    • Supports NandEmulation to directly store the save games to SD or USB instead of the Wii memory. (needs d2x cIOS v7 alpha or later)
    • Supports Displaying and Launching Channels from NandEmulation!
    • Supports install/uninstall of WAD files to the Emulated NAND, external Wad Managers not needed.
    • Supports Batch install/uninstall of WAD files from a folder to/from EmuNAND. [​IMG]
    • Support Neek2o (Wii and vWii) and channel autobooting. [​IMG]
    Development & Sources

    Please report them in the thread or create a new entry in sourceforge issue manager.
    It's recommended that you first post your issue in this thread:
    - You'll get a faster reply (I don't look at sourceforge very often)
    - It could be a simple issue on your side and not a bug, no need to add a bug report if it's not one.

    To compile USB Loader GX by yourself you need the latest libraries and sources. Extract it to your devkit/libogc folder.
    • Get the current source of the loader here: SOURCE
    • Get the libogc and portlib from 2012 05 06 for Devkit PPC r26 which we used for our v3.0 Here
    • All latest stable released files are available here.
    • All built revisions are available here.

    Changelog from USBLoaderGX v3.0 r1257 to v3.0 r1260:[​IMG]
    Released on 2016-01-09
    New :
    • Added RU/FI/SE cover download if EN is not found on gametdb.
    • Added batch wad (un)install from a folder.
    • Added game type and console name in exported game list.
    • Rename meta.xml to lowercase.
    • Updated game's region detection and use "Region Free" instead of PAL as default value.
    • Set default scroll direction to "system menu" for natural behavior.
    • Force a game's title reload when selecting a different EmuNAND path.
    • Removed Nintendont internal update feature (requires SSL).
    • Changed the wad install menu interface.
    • Reverted HTTP to non SSL revision (r1252).

    Changelog from USBLoaderGX v3.0 r1228 to v3.0 r1256:[​IMG]
    Released on 2015 08 15
    New :
    • Added current version and revision number to boot screen.
    • Added a private server setting to patch games at launch. (Wiimmfi support)
    • Added WiiU pro controller support. (Thanks Airline38)
    • Added a Auto WiiU aspect-ratio fixer based on current WiiU setting.
    • Added a manual WiiU Widescreen switcher in Features menu.
    • Added a prompt to move existing Titles files when editing Titles path. (Greywolf)
    • Added an option to display Multi-disc prompt when launching gamecube games with DM/DML/Nintendont.
    • Added "Update Nintendont" option in features menu.
    • Added Nintendont argument booting method support when auto-booting a game (faster booting, no nincfg.bin file written to device).
    • Added multiple Nintendont missing settings.
    • Added a per-game "Nintendont Loader Path" setting.
    • Added Nintendont controllers folder check (controller.ini has priority)
    • Added a Nintendont setting to choose Nincfg.bin behavior at launch.
    • Added Nintendont Disc launching feature and a prompt to select where MCEmu should be located.
    • Added a warning message if Nintendont debug option is enabled but kenobiwii.bin is missing on Rev < 3.336.
    • Added basic Neek2o support for EmuNAND channels autoboot.
    • Added a prompt to select NAND Dump path if needed.
    • Added SSL support for download. (Thanks Fix94)
    • Added progressWindows support for downloads.
    • Added favorite icons to the Animated banner Game Window. (Thanks to Suloku for the patch!)
    • Added a GUI setting to choose the "favorite icons" layout over the banners.
    • Set default loader mode on fresh install to Wii+Gamecube.
    • Set video width to 694px (instead of 640px) when Wii set to 4:3
    • Added an URL auto-updater function for users with the old GameCube banner URL.
    • Updated custom banner URL. (Thanks Abz)
    • Set default Wii disc dump mode to "Remove update partition" to prevent users reporting SSBB dumping issue.
    • Remove "shutdown to standby" choice on WiiU vWii.
    • Automatically set Loader's IOS setting to 58 if no cIOS is available.
    • Removed unneeded IOS58 patches to libruntimeiospatch.
    • Updated LibFAT to v1.0.13.
    • Updated DIOS MIOS (Lite) detection up to v2.11.
    • Video mode is now forced to PAL60Hz 480i when playing NTSC games on a PAL console with Devolution.
    • Changed Nintendont MCEmu setting to ON by default on new USBLoaderGX installation.
    • Changed prompt type to warning if Nintendont version detection fails.
    • Removed forced Nintendont Maxpad setting on WiiU.
    • Removed forced Nintendont controller.ini check on WiiU.
    • Changed partition detection for DIOS MIOS to allow logical partition located before the first primary partition. (Thanks RCJayce)
    • Changed partition detection for Nintendont to allow logical and primary partitions before the first FAT32 partition.
    • Set default Nintendont MaxPad to 4.
    • Prevent deleted channels to be displayed if tmd still exists.
    • Removed the check for cIOS d2x when selecting emuNAND options.
    • Disabled Theme Downloader Menu access (not enough memory).
    • Updated the Internal USBLoaderGX Update URL to use sourceforge instead of googlecode.
    • Fixed launching DIOS MIOS(Lite) with Ocarina.
    • Fixed video mode behavior when selecting Nintendont "Video mode: auto".
    • Fixed exiting the credit page (press B to exit).
    • Fixed creating missing game save path for EmuNAND channels if "EmuNAND channel path" is different than "EmuNAND save path".
    • Fixed "EmuNAND Channel" setting to use the "EmuNAND Save" setting when set to "Use global".
    • Updated Windows installer to v1.9 to download boot.dol from sourceforge. (Dimok) (never released officially)

    Changelog from USBLoaderGX v3.0 r1180 to v3.0 r1226:
    Released on 2014 05 05
    You can find the complete changelog HERE
    New :
    • Added a Clock size factor (size factor is theme-able and will override user's value if not "1.0" in .them file)
    • Added a new Category filtering engine. (Tutorial)
    • Added support for GameCube games with: DIOS MIOS, Devolution and Nintendont.
    • Added support for triforce games with QuadForce.
    • Added autodetection of installed MIOS.
    • Added support for Yaz0 decompression on banners and system menu resources.
    • Added a Language settings for GameCube games.
    • Added a new option to Game Window setting to display banner animation only on Channels layout, other layouts use Rotating disc.
    • Added new Priiloader 0.8 beta4 compatibility to parental control setting
    • Added banner download from custom URL when GameCube mode is enable. Set the URL manually in the GXGlobal.cfg
    • Added support for exit to Homebrew Channel v1.1.1+ (LULZ)
    • Added possibility to install multi-Discs GameCube games
    • Added a new setting to select GameCube games source and priority: SD, USB, Sd+USB, USB+SD, Auto
    • Added a warning when trying to launch a Wii game with a non-d2x cIOS if EmuNAND is enabled.
    • Added a Harddrive verification to warn the user if the HDD is not correctly setup when launching GameCube games with the selected loader.
    • Added Wifi6 and wifi10 pictures for GameInfo window.
    • Added support for USB devices with modified MBR's signature to prevent WiiU's format message.
    • Added a Dol Video mode patcher in individual Game settings for games which couldn't be forced. (MadWorld, MotoGP08, Mario Party 8, etc.)
      • Region patch = Patches the dol's known video modes to the region selected in "Video mode" setting, but keep interlace/progressive references.
      • ON = Patch all dol's known video modes to the one selected in "Video mode" setting.
      • ALL = Patch all dol's found video mode patterns (even unknown video modes) to the one selected in "Video mode" setting.
    • Added IOS58 + AHB support.
    • Added a Loader's IOS setting.
    • Added LibruntimeIOSPatch to patch IOS58 and Hermes v4.
    • Added a delete prompt if downloaded cheat file is empty.
    • Force all launched homebrew to reload to IOS58 if available.
    • Changed Gecko.c to send logs to wifigecko too (need to be enabled).
    • Added an option to choose if HDD should be mounted on Loader's launch
    • Added support for 302 Redirect HTTP error code
    • Added Auto-edition of meta.xml arguments based on internal user settings.
    • Added support for meta.xml arguments when rebooting the loader.
    • Added a verification for downloaded Ocarina content and delete it if needed (Thanks Airline38)
    • Reworked GUI window for covers download and auto select all choices. Select HQ/LQ/custom/original priority in the GUI settings.
    • Changed default path for GameCube Main Folder to usb1:/games/
    • Ocarina GCT folder can now be placed anywhere for GameCube Games.
    • Added back cIOS rev17-21 support for EmuNAND Channel
    • Updated LibNTFS to 2013-01-13 version
    • Improved Classic Controller and GameCube Controller usage.
    • Changed how video mode is chosen by the loader. "Force PAL" now really uses PAL signal instead of NTSC.
    • Changed the Loader settings and Game settings display. Options are grouped and displayed by Gamecube Loader type.
    • Merged Gamecube Video settings to a single option.
    • Removed Error #002 setting (Always set to Anti)
    Fixes :
    • Fixed tooltip opacity on Home Button and game icons on Channel grid mode.
    • Fixed Banner Grid position X and Y not working in .them file.
    • Fixed grid mode display with 4 games.
    • Fixed unzipping downloaded Theme.
    • Fixed launching GameCube games from disc with official MIOS.
    • Fixed the auto-completion search bug (Thanks to hvy109 for the patch).
    • Prevent Playcount increasing if the game couldn't launch.
    • Fixed launching Korean games (Thanks damysteryman).
    • Fixed progress window not hiding if Wiiload didn't send the file
    • Fixed individual game settings to allow modification of the EmuNAND settings based on the game's IOS instead of global IOS.
    • Fixed USB Initialization when using usbport 1
    • Fixed mounting WBFS partition without a partition table
    • Fixed missing parent folder ".." when browsing a NTFS partition.
    • Prevent Rockband cursor display on GameCube and WiiWare games with "band" in the title
    • Fixed Playlog writing when using Hermes cIOS v4 (untested) (Requires AHB access).
    • Fixed EmuNAND when using cIOS revision 65535
    • Fixed installing games with no_split on NTFS partition if SD Card is inserted (Thanks Dimok)
    • Fixed a crash issue when plugging HDD after launch and mounting WBFS partition for the first time in HDD menu.
    • Fixed gamecube game's list when mounting HDD after launch.
    • Fixed automatic switching to channel mode if no USB device is detected.
    • Fixed Ocarina download from Geckocodes
    Devolution usage:
    • place Loader.bin from devolution sources in "DEVO Loader Folder".
      default folder is sd:/apps/gc_devo/ but you can change it in the loader's settings.
    Nintendont usage:
    • place Loader.dol or boot.dol from Nintendont sources in "Nintendont Loader Folder".
      default folder is sd:/apps/Nintendont/ but you can change it in the loader's settings.

    Changelog for USBLoaderGX 3.0
    Changelog for USBLoaderGX 2.3
    Changelog for USBLoaderGX 2.2
    Changelog for USBLoaderGX 2.1
    Changelog for USBLoaderGX 2.0

    GUI in action

    Last edited by Cyan, Mar 13, 2018 - Reason: updated tabmod, thanks to Badablek :)
  2. DarkCamui

    DarkCamui GBAtemp Fan

    Aug 30, 2005
    Precompiled dol files would be nice for us who can't compile [​IMG]
  3. Scoobyscoobydoo

    Scoobyscoobydoo GBAtemp Regular

    Mar 1, 2009
    Good work, hope this thread keeps updated, and a link to compliled dol's would be nice.

    Thanks for starting this.
  4. Linuks

    Linuks GBAtemp Regular

    Aug 30, 2008
    vettacossx really need to add transparency to his cd covers [​IMG]

    [​IMG] [​IMG]
  5. Scolor

    Scolor GBAtemp Regular

    Nov 7, 2008
    Wow it's amazing.
    I'll wait for a compiled version. [​IMG]

    Does it also have the support for Ocarina and video mode patch?
  6. TheNewMouse

    TheNewMouse Advanced Member

    Apr 19, 2009
    The Other Place
    just open a project in devkit pro and clean then make..

    make sure you set the project folder to the folder of the app's source and your good to go usually.
  7. Linuks

    Linuks GBAtemp Regular

    Aug 30, 2008
  8. Scoobyscoobydoo

    Scoobyscoobydoo GBAtemp Regular

    Mar 1, 2009
    Yeah it has those in the options section.
  9. zidane_genome

    zidane_genome My sword has a +2 bleeding... wanna test it out?

    May 21, 2006
    United States
    There was a fix already out for ExciteTruck... since the SD card is already mounted, that's the crash... from what I've read, you just have to put a simple UnMountSD command in right before the launch title command...

    this is not real code, but just an example..

    unMount SD:
    launchTitle d #d is the disc id of the selected title (RDZE01 for example)
  10. Scoobyscoobydoo

    Scoobyscoobydoo GBAtemp Regular

    Mar 1, 2009
    Thats great , if somone could implement this for both PAL and NTSC.
  11. Scolor

    Scolor GBAtemp Regular

    Nov 7, 2008

    Wow thanks!!!
  12. nindim

    nindim GBAtemp Regular

    Apr 10, 2009
    I would like to see the official discs if possible, in the video it looks like they were all customs.
  13. Chaos Punk

    Chaos Punk GBAtemp Regular

    Apr 19, 2009
    United States
    Bakersfield, CA
    Hey, on the wish list, add native disc loader channel game animations. That's the one I'm really pushing for.
  14. Chaos Punk

    Chaos Punk GBAtemp Regular

    Apr 19, 2009
    United States
    Bakersfield, CA
    Oh, and I have bug and typo. The typo is that when you select go back to Wii Menu, it goes back to the homebrew channel, not the menu, and the bug is when you use a forwarder to get to the app, when you try to exit to the wii menu/homebrew channel, it crashes or just freezes. Oh, and a suggestion, the ability to go back to EITHER the Wii Menu OR the HBC?
  15. Chalky94

    Chalky94 Member

    May 29, 2008
    how do you download the source?
  16. grante

    grante Advanced Member

    Oct 4, 2008
    United States
  17. Chalky94

    Chalky94 Member

    May 29, 2008
    cheers mate
  18. dimok

    dimok GBAtemp Advanced Fan

    Jan 11, 2009
    United States

    This is already in the code. Each time a game is booted the SD is unmounted!!

    The go back to Wii Menu Button goes back to HBC for us. We made it coz it is faster to test the programms instead of going HBC all the time. In a release this will be really back to Wii Menu (its only one line to change).
  19. wii94

    wii94 GBAtemp Regular

    Jul 16, 2008
    where i can download the newst .dol??
    ZoNtendo likes this.
  20. Chaos Punk

    Chaos Punk GBAtemp Regular

    Apr 19, 2009
    United States
    Bakersfield, CA
    So what do we have to do to set up a database? I'll gladly do it as I can't do much else.
    ZoNtendo likes this.