Hacking USB Loader GX

[admin]

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.

Downloads
_______________________________________________________​

Note : for the most recent and full featured version, get Blackb0x mod below.

For the latest "official" but outdated version, click on the next link:

Download the latest Official/outdated 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
- @Badablek is maintaining a "tabmod" of latest releases : December 20th 2018 build, r1271+tabmod
- @blackb0x modded 1272 (Current official version!) : Adds new features, fix cheatcode download, got nintendont update back, fix channel patching, homebrew launching, among other changes! be sure to try it until it's officially merged (or if you prefer to keep that version)


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 (Latest/outdated official release! - PLEASE USE BlackB0x mod instead)
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 irc.abjects.net. Join #gui-usbloader-chat
or just use this simple command on your irc client: /server -m irc.abjects.net -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 gametdb.com, these packs are updated every weeks. (Wiitdb.com is now Gametdb.com)

Features
_______________________________________________________

(

= 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.
  
  
• 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.
  
  
• 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.
  
  
• 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.
  
  
• Support Neek2o (Wii and vWii) and channel autobooting.
  
  

Development & Sources
_______________________________________________________

Buglist:
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.


Source:
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.

Changelogs
_______________________________________________________


Changelog from USBLoaderGX v3.0 r1257 to v3.0 r1260:

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.

Changes:

• 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.

Fixes:

• Reverted HTTP to non SSL revision (r1252).

Changelog from USBLoaderGX v3.0 r1228 to v3.0 r1256:

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.

Changes:

• 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.

fixes:

• 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".

Other:

• 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)

Changes:

• 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.

GUI in action
_______________________________________________________

​