Difference between revisions of "Preloader"

From WiiBrew
Jump to navigation Jump to search
m (Idiot-proofing.)
(Moved the “what is Preloader” section to the top)
 
(51 intermediate revisions by 24 users not shown)
Line 1: Line 1:
 +
{{Redundant|Priiloader}}
 
{{Infobox homebrew
 
{{Infobox homebrew
| title      = Preloader
+
| title      = preloader
 
| type        = system tool
 
| type        = system tool
| author      = [[User:Crediar|Crediar]]
+
| author      = [[User:Crediar|crediar]]
 
| version    = 0.30 (Final)
 
| version    = 0.30 (Final)
| download   = http://chaoshq.de/~crediar/preloaderv0.29-cred.rar Preloader 0.29
+
| download = http://chaoshq.de/~crediar/preloaderv0.29-cred.rar (0.29)
 +
| source      = http://crediar.no-ip.com/preloaderv0.30-src.rar
 
| peripherals = {{Wiimote4}}
 
| peripherals = {{Wiimote4}}
 
}}
 
}}
 +
{{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.
  
{{Modifies NAND}}
+
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.
  
== WARNINGS ==
+
Thanks to marcan for the stub code (stub.S)
On April 1st, Preloader 0.29 bricks your Wii only for April 1st. If you keep pressing A, you can get past it. So don't freak out and try to repair it.
 
  
THIS TOOL CHANGES THE WAY THE WII WORKS IN A WAY IT WAS NEVER INTENDED TO, SO THERE IS A RISK OF BRICKING YOUR CONSOLE. ALL MEASURES WERE TAKEN TO HELP ASSURE THAT NOTHING WILL BRICK.
+
== 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.
  
THIS IS STILL NO GUARANTEE!! THE AUTHOR CAN NOT BE HELD RESPONSIBLE FOR ANY DAMAGE IT MIGHT CAUSE!
+
== Warning ==
YOU ARE INSTALLING THIS AT YOUR OWN RISK!
 
  
== IMPORTANT NOTES ==
+
PLEASE READ THE WHOLE README BEFORE RUNNING THE INSTALLER.
* Preloader 0.29 will be the last version - there won't be any new versions.
 
* When the installer finds IOS60 it will patch in the ES_DIVerfiy function, so Preloader can load the System Menu with IOS60.
 
  
== What is Preloader and what the hell does it do? ==
+
THIS TOOL MODIFIES THE NORMAL BEHAVIOR OF THE WII SYSTEM AND THEREFORE CAN CAUSE UNEXPECTED PROBLEMS.
Preloader is a small 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 the system menu to remove limitations
 
or other things.
 
  
Since Preloader places itself before the System Menu any problems that would cause
+
IT IS HIGHLY RECOMMENDED TO INSTALL PRELOADER ONLY ON A WII WITH UNMODIFIED IOSs!!
the System Menu to fail are not causing your whole Wii to stop working.
+
 
 +
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.
  
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 ==
Line 50: Line 64:
  
 
== Uninstall ==
 
== Uninstall ==
The simplest and safest way to remove Preloader is to reinstall the System Menu using [[AnyRegion Changer]] or a WAD installer. You can also use restoremii with the Bootmii app to reinstall your backup of your system menu, if you had Bootmii installed before Preloader was installed.
+
The simplest and safest way to remove preloader is to reinstall the System Menu
 +
using [[AnyRegion Changer]] or a WAD installer.
  
 
== Greetings ==
 
== Greetings ==
Line 62: Line 77:
 
*wiidev (both of them!)
 
*wiidev (both of them!)
 
*dsidev
 
*dsidev
 +
*gamingexposed
  
 
== Changelog ==
 
== Changelog ==
0.30:
+
'''0.30:'''
    -added SDHC support
+
*added SDHC support
    -added a new option to the "return to" setting: "return to: autoboot"
+
*added a new option to the "return to" setting; "return to: autoboot"
    -changed FAT code to only mount/read from SD
+
*fixed a bug where enabled autoboot overwrote the "return to preloader" setting
    -fixed a bug where enabled autoboot overwrote the "return to preloader" setting
+
*removed netcode, online update check, online update code.
    -removed netcode, online update check, online update code
+
 
    -The installer now get the IOS version the System menu uses from its TMD and if the version is 60 or higher applies the ES_DIVerify patch
+
'''0.29:'''
0.29:
+
*added a feature to load the system menu with any IOS version you want.
    -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]]
    -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
    -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 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
    -fixed a bug which broke System Menu loading when the system got formatted
 
  
0.28:  
+
'''0.28:'''
    -rewrote the hacks parser, it's more solid now and detects syntax errors much better
+
*rewrote the hacks parser, it's more solid now and detects syntax errors much better
    -added a new font
+
*added a new font
    -optimized the menu layout  
+
*optimized the menu layout
    -you can now add unlimited offsets/value in one hack entry  
+
*you can now add unlimited offsets/value in one hack entry
    -added beta version related code  
+
*added beta version related code
    -added a setting which allows to always turn you Wii off even when standby is enabled  
+
*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 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 which prevented updating to a non beta version during beta testing
    -fixed a bug in the System Menu hacks scrolling code  
+
*fixed a bug in the System Menu hacks scrolling code
  
0.27
+
'''0.27:'''
    -added a setting to stop the disc when autoboot is disabled  
+
*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 return to Preloader when Wii titles are using the switch off state
    -added a setting to show beta updates  
+
*added a setting to show beta updates
    -added a setting to disable lighting the drive slot on an error  
+
*added a setting to disable lighting the drive slot on an error
    -added one message to make the online update not look frozen  
+
*added one message to make the online update not look frozen
    -errors when parsing the hacks.ini now show the line  
+
*errors when parsing the hacks.ini now show the line
    -Preloader now regards the shutdown mode (OFF/Standby)  
+
*Preloader now regards the shutdown mode (OFF/Standby)
    -fixed that under certain circumstances hacks from another version were applied  
+
*fixed that under certain circumstances hacks from another version were applied
    -fixed a settings related bug  
+
*fixed a settings related bug
  
0.26:
+
'''0.26:'''
    -added elf-loading (able to load white-linux!)  
+
*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.  
+
*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  
+
*made the hacks list scrollable, allowing an unlimited amount of hacks
    -rewrote the installer  
+
*rewrote the installer
    -added some interface improvements  
+
*added some interface improvements
    -fixed the online update  
+
*fixed the online update
    -fixed returning to the System Menu, which loaded preloader instead  
+
*fixed returning to the System Menu, which loaded preloader instead
    -fixed shutting down from 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 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 System Menu loading for all System Menu versions
    -fixed the stuck-systemmenuhack-option bug  
+
*fixed the stuck-systemmenuhack-option bug
    -fixed the bug that when a Nunchuk was connected the System Menu wouldn't load  
+
*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 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
+
*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
ModifiesNAND.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