In memory of Ben “bushing” Byer, who passed away on Monday, February 8th, 2016.

Difference between revisions of "Preloader"

From WiiBrew
Jump to navigation Jump to search
m (:))
(Moved the “what is Preloader” section to the top)
 
(77 intermediate revisions by 35 users not shown)
Line 1: Line 1:
{{Infobox homebrewapp
+
{{Redundant|Priiloader}}
| title      = Preloader
+
{{Infobox homebrew
| desc        =
+
| title      = preloader
| type        = Utilities
+
| type        = system tool
| author      = [[User:Crediar|Crediar]]
+
| author      = [[User:Crediar|crediar]]
| display     =  
+
| version     = 0.30 (Final)
| version    = 0.29
+
| download = http://chaoshq.de/~crediar/preloaderv0.29-cred.rar (0.29)
| download    = [http://crediar.no-ip.com/preloaderv0.29-cred.rar download]
+
| source      = http://crediar.no-ip.com/preloaderv0.30-src.rar
| source      = No
 
 
| peripherals = {{Wiimote4}}
 
| peripherals = {{Wiimote4}}
| dangerous  = 1
 
| fakesigns  = 1
 
 
}}
 
}}
 +
{{Modifies NAND}}
 +
 +
Preloader is an application which places itself before the System Menu. Its main feature is to directly boot the Homebrew Channel or a file you can install from a FAT device. Preloader is also able to apply memory patches to the system menu to remove limitations or other things.
 +
 +
Since Preloader places itself before the System Menu any problems that would cause
 +
the System Menu to fail are not causing your whole Wii to stop working.
 +
 +
If autoboot is enabled and you want to access Preloader's menu simply hold RESET
 +
while powering the Wii on.
 +
 +
== Special Thanks ==
 +
Many thanks to ajd4096 who donated me an USBGecko!
  
 
First of all I want to thank 'zouzzz zzzuoz', AlexLH, GizmoTheGreen and SquidMan.
 
First of all I want to thank 'zouzzz zzzuoz', AlexLH, GizmoTheGreen and SquidMan.
+
 
 
Thanks to svpe for the ES_DIVerfiy patch.
 
Thanks to svpe for the ES_DIVerfiy patch.
  
 +
Thanks to marcan for the stub code (stub.S)
  
== IMPORTANT NOTE ==
+
== Note on release ==
When the installer finds IOS60 it will patch the ES_DIVerfiy function,
+
Since there is still a high demand for preloader and I don't really want to work on
so preloader can load the system menu with IOS60.
+
it anymore I thought it would be the best to release the source.
 +
Source is released under GNU GPL 2.
  
 +
== Warning ==
  
== WARNING ==
+
PLEASE READ THE WHOLE README BEFORE RUNNING THE INSTALLER.
SINCE THIS TOOL CHANGES THE WAY THE WII WORKS IN A WAY IT WAS NEVER INTENDED TO,
 
THERE IS A RISK OF BRICKING YOUR CONSOLE.  
 
  
I'VE DONE EVERYTHING I CAN TO ASSURE THAT NOTHING WILL BRICK.
+
THIS TOOL MODIFIES THE NORMAL BEHAVIOR OF THE WII SYSTEM AND THEREFORE CAN CAUSE UNEXPECTED PROBLEMS.
BUT THIS IS STILL NO GUARANTEE!!
 
THE AUTHOR CAN NOT BE HELD RESPONSIBLE FOR ANY DAMAGE IT MIGHT CAUSE!
 
YOU ACCEPT THAT YOU INSTALL THIS ON YOUR OWN RISK!
 
  
== What is preloader and what the hell does it do ==
+
IT IS HIGHLY RECOMMENDED TO INSTALL PRELOADER ONLY ON A WII WITH UNMODIFIED IOSs!!
preloader is a small application which places itself before the system menu.
 
  
It's main feature is to directly boot the Homebrew Channel or a file you can install
+
YOU AGREE THAT YOU INSTALL THIS TOOL ON YOUR OWN RISK, THE AUTHOR CAN NOT BE HELD
from a FAT device.
 
  
preloader is also able to apply memory patches the system menu to remove limitations
+
RESPONSIBLE FOR ANY DAMAGES CAUSED BY EITHER USING OR INSTALLING THIS TOOL.
or other things.
 
  
Since preloader places itself before the system menu any problems that would cause
+
==Note on compiling ==
the system menu to fail are not causing your whole wii to stop working.
+
Code has been tested on the latest devkitPro with devkitPPC and should compile fine.
  
If autoboot is enabled and you want to access preloader's menu simply hold RESET
+
Before you can compile anything you need to place a certs.bin into the data directory.
while powering the wii on.
 
  
 
== Hacks ==
 
== Hacks ==
To install additional System Menu patches, simply copy the "hacks.ini" file
+
To install additional System Menu patches, simply copy the "[[/hacks|hacks.ini]]" file
included with preloader into the root of your SD card.
+
included with preloader into the root of your SD card. (Ensure you are using the correct hacks.ini for your Wii's region.)
 
   
 
   
Then,boot into preloader's settings, and chose to enable or disable the patches
+
Then, boot into Preloader's settings, and chose to enable or disable the patches
 
in the Hack Settings menu.  
 
in the Hack Settings menu.  
  
Line 60: Line 63:
 
and should explain itself.
 
and should explain itself.
  
 
+
== Uninstall ==
== Uninstall==
 
 
The simplest and safest way to remove preloader is to reinstall the System Menu
 
The simplest and safest way to remove preloader is to reinstall the System Menu
using AnyRegion Changer or a WAD installer.
+
using [[AnyRegion Changer]] or a WAD installer.
  
 
+
== Greetings ==
==Greetings ==
 
 
(in random order)
 
(in random order)
 
there are way to many people to greet and before I forget
 
there are way to many people to greet and before I forget
 
some I just don't list any :P
 
some I just don't list any :P
 
+
*devkitPro
devkitPro
+
*Team Twiizers
Team Twiizers
+
*todXXX the sanctuary!
 
+
*playground
#todXXX the sanctuary!
+
*wiidev (both of them!)
#playground
+
*dsidev
#wiidev (both of them!)
+
*gamingexposed
#dsidev
 
  
 
== Changelog ==
 
== Changelog ==
0.29:
+
'''0.30:'''
    -added a feature to load the system menu with any IOS version you want.
+
*added SDHC support
    -The installer includes an IOS patcher which when found patches IOS60 so preloader can fully work with system menu 4.0
+
*added a new option to the "return to" setting; "return to: autoboot"
    -Moved some text around for better visibility on 4:3 screens
+
*fixed a bug where enabled autoboot overwrote the "return to preloader" setting
    -fixed a bug which let the disc endlessly spin when wc24 was enabled and the wii got turned off
+
*removed netcode, online update check, online update code.
    -fixed a bug which broke system menu loading when the system got formated
 
 
 
0.28:
 
    -rewrote the hacks parser, it's more solid now and detects syntax errors much better
 
    -added a new font
 
    -optimized the menu layout
 
    -you can now add unlimited offsets/value in one hack entry
 
    -added beta version related code  
 
    -added a setting which allows to always turn you Wii off even when standby is enabled
 
    -fixed that when shutting down from the System Menu, the Wii always got powered down instead of using the set shutdownmode.  
 
    -fixed a bug which prevented updating to a non beta version during beta testing
 
    -fixed a bug in the System Menu hacks scrolling code
 
  
0.27
+
'''0.29:'''
    -added a setting to stop the disc when autoboot is disabled
+
*added a feature to load the system menu with any IOS version you want.
    -added a setting to return to preloader when Wii titles are using the switch off state
+
*The installer includes an IOS patcher which when found patches IOS60 so Preloader can fully work with [[System Menu 4.0]]
    -added a setting to show beta updates
+
*Moved some text around for better visibility on 16:9 screens
    -added a setting to disable lighting the drive slot on an error
+
*fixed a bug which let the disc endlessly spin when wc24 was enabled and the Wii got turned off
    -added one message to make the online update not look frozen
+
*fixed a bug which broke System Menu loading when the system got formatted
    -errors when parsing the hacks.ini now show the line
 
    -preloader now regards the shutdownmode (OFF/Standby)
 
    -fixed that under certain circumstances hacks from another version were applied
 
    -fixed a settings related bug  
 
  
0.26:
+
'''0.28:'''
    -added elf-loading (able to load white-linux!)
+
*rewrote the hacks parser, it's more solid now and detects syntax errors much better
    -added an option to load preloader or the System Menu when the return-to state is used.
+
*added a new font
    -made the hacks list scrollable, allowing an unlimited amount of hacks
+
*optimized the menu layout
    -rewrote the installer
+
*you can now add unlimited offsets/value in one hack entry
    -added some interface improvements
+
*added beta version related code
    -fixed the online update
+
*added a setting which allows to always turn you Wii off even when standby is enabled
    -fixed returning to the System Menu, which loaded preloader instead
+
*fixed that when shutting down from the System Menu, the Wii always got powered down instead of using the set shutdown mode.
    -fixed shutting down from System Menu, which loaded preloader instead  
+
*fixed a bug which prevented updating to a non beta version during beta testing
    -fixed a bug in the "Install/Load File" menu that allowed users to move out of the list
+
*fixed a bug in the System Menu hacks scrolling code
    -fixed System Menu loading for all System Menu versions
 
    -fixed the stuck-systemmenuhack-option bug
 
    -fixed the bug that when a nunchuck was connected the System Menu wouldn't load
 
    -fixed a bug which caused the Wii to freeze when power was pressed
 
    -fixed a bug where only the first Wiimote was powered down when the Wii got turned off
 
  
 +
'''0.27:'''
 +
*added a setting to stop the disc when autoboot is disabled
 +
*added a setting to return to Preloader when Wii titles are using the switch off state
 +
*added a setting to show beta updates
 +
*added a setting to disable lighting the drive slot on an error
 +
*added one message to make the online update not look frozen
 +
*errors when parsing the hacks.ini now show the line
 +
*Preloader now regards the shutdown mode (OFF/Standby)
 +
*fixed that under certain circumstances hacks from another version were applied
 +
*fixed a settings related bug
  
 +
'''0.26:'''
 +
*added elf-loading (able to load white-linux!)
 +
*added an option to load Preloader or the System Menu when the return-to state is used.
 +
*made the hacks list scrollable, allowing an unlimited amount of hacks
 +
*rewrote the installer
 +
*added some interface improvements
 +
*fixed the online update
 +
*fixed returning to the System Menu, which loaded preloader instead
 +
*fixed shutting down from System Menu, which loaded preloader instead
 +
*fixed a bug in the "Install/Load File" menu that allowed users to move out of the list
 +
*fixed System Menu loading for all System Menu versions
 +
*fixed the stuck-systemmenuhack-option bug
 +
*fixed the bug that when a Nunchuk was connected the System Menu wouldn't load
 +
*fixed a bug which caused the Wii to freeze when power was pressed
 +
*fixed a bug where only the first Wiimote was powered down when the Wii got turned off
  
[[Category:Software|Preloader|Homebrew]]
+
== Third party modifications ==
 +
* [[/Priiloader|Priiloader]]

Latest revision as of 19:31, 14 April 2021

preloader
General
Author(s)crediar
TypeSystem tool
Version0.30 (Final)
Links
(0.29) Download
Source
Peripherals
Wiimote4.svg
NOTICE
ModifiesConsole.png
This homebrew application makes permanent changes to the Wii's NAND, thus, this application should be used with caution.

It is recommended to have a NAND backup with either BootMii as boot2 or Priiloader with BootMii as IOS installed before proceeding with the usage of this application.

Preloader is an application which places itself before the System Menu. Its main feature is to directly boot the Homebrew Channel or a file you can install from a FAT device. Preloader is also able to apply memory patches to the system menu to remove limitations or other things.

Since Preloader places itself before the System Menu any problems that would cause the System Menu to fail are not causing your whole Wii to stop working.

If autoboot is enabled and you want to access Preloader's menu simply hold RESET while powering the Wii on.

Special Thanks

Many thanks to ajd4096 who donated me an USBGecko!

First of all I want to thank 'zouzzz zzzuoz', AlexLH, GizmoTheGreen and SquidMan.

Thanks to svpe for the ES_DIVerfiy patch.

Thanks to marcan for the stub code (stub.S)

Note on release

Since there is still a high demand for preloader and I don't really want to work on it anymore I thought it would be the best to release the source. Source is released under GNU GPL 2.

Warning

PLEASE READ THE WHOLE README BEFORE RUNNING THE INSTALLER.

THIS TOOL MODIFIES THE NORMAL BEHAVIOR OF THE WII SYSTEM AND THEREFORE CAN CAUSE UNEXPECTED PROBLEMS.

IT IS HIGHLY RECOMMENDED TO INSTALL PRELOADER ONLY ON A WII WITH UNMODIFIED IOSs!!

YOU AGREE THAT YOU INSTALL THIS TOOL ON YOUR OWN RISK, THE AUTHOR CAN NOT BE HELD

RESPONSIBLE FOR ANY DAMAGES CAUSED BY EITHER USING OR INSTALLING THIS TOOL.

Note on compiling

Code has been tested on the latest devkitPro with devkitPPC and should compile fine.

Before you can compile anything you need to place a certs.bin into the data directory.

Hacks

To install additional System Menu patches, simply copy the "hacks.ini" file included with preloader into the root of your SD card. (Ensure you are using the correct hacks.ini for your Wii's region.)

Then, boot into Preloader's settings, and chose to enable or disable the patches in the Hack Settings menu.

Once applied, your patches are placed in NAND, so feel free to erase the file on your SD card.

The format for adding additional hacks, or patches, to your hacks.ini file is simple and should explain itself.

Uninstall

The simplest and safest way to remove preloader is to reinstall the System Menu using AnyRegion Changer or a WAD installer.

Greetings

(in random order) there are way to many people to greet and before I forget some I just don't list any :P

  • devkitPro
  • Team Twiizers
  • todXXX the sanctuary!
  • playground
  • wiidev (both of them!)
  • dsidev
  • gamingexposed

Changelog

0.30:

  • added SDHC support
  • added a new option to the "return to" setting; "return to: autoboot"
  • fixed a bug where enabled autoboot overwrote the "return to preloader" setting
  • removed netcode, online update check, online update code.

0.29:

  • added a feature to load the system menu with any IOS version you want.
  • The installer includes an IOS patcher which when found patches IOS60 so Preloader can fully work with System Menu 4.0
  • Moved some text around for better visibility on 16:9 screens
  • fixed a bug which let the disc endlessly spin when wc24 was enabled and the Wii got turned off
  • fixed a bug which broke System Menu loading when the system got formatted

0.28:

  • rewrote the hacks parser, it's more solid now and detects syntax errors much better
  • added a new font
  • optimized the menu layout
  • you can now add unlimited offsets/value in one hack entry
  • added beta version related code
  • added a setting which allows to always turn you Wii off even when standby is enabled
  • fixed that when shutting down from the System Menu, the Wii always got powered down instead of using the set shutdown mode.
  • fixed a bug which prevented updating to a non beta version during beta testing
  • fixed a bug in the System Menu hacks scrolling code

0.27:

  • added a setting to stop the disc when autoboot is disabled
  • added a setting to return to Preloader when Wii titles are using the switch off state
  • added a setting to show beta updates
  • added a setting to disable lighting the drive slot on an error
  • added one message to make the online update not look frozen
  • errors when parsing the hacks.ini now show the line
  • Preloader now regards the shutdown mode (OFF/Standby)
  • fixed that under certain circumstances hacks from another version were applied
  • fixed a settings related bug

0.26:

  • added elf-loading (able to load white-linux!)
  • added an option to load Preloader or the System Menu when the return-to state is used.
  • made the hacks list scrollable, allowing an unlimited amount of hacks
  • rewrote the installer
  • added some interface improvements
  • fixed the online update
  • fixed returning to the System Menu, which loaded preloader instead
  • fixed shutting down from System Menu, which loaded preloader instead
  • fixed a bug in the "Install/Load File" menu that allowed users to move out of the list
  • fixed System Menu loading for all System Menu versions
  • fixed the stuck-systemmenuhack-option bug
  • fixed the bug that when a Nunchuk was connected the System Menu wouldn't load
  • fixed a bug which caused the Wii to freeze when power was pressed
  • fixed a bug where only the first Wiimote was powered down when the Wii got turned off

Third party modifications