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 (fixed change log split entry)
(Moved the “what is Preloader” section to the top)
 
(89 intermediate revisions by 37 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.27
+
| download = http://chaoshq.de/~crediar/preloaderv0.29-cred.rar (0.29)
| download    = [http://crediar.no-ip.com/preloaderv0.27-cred.rar]
+
| source      = http://crediar.no-ip.com/preloaderv0.30-src.rar
| source      = No
+
| peripherals = {{Wiimote4}}
| peripherals = {{Wiimote1}}
 
| dangerous  = 1
 
| fakesigns  = 0
 
 
}}
 
}}
 +
{{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.
  
== WARNING ==
+
Thanks to marcan for the stub code (stub.S)
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.
+
 
+
== Note on release ==
I'VE DONE EVERYTHING I CAN TO ASSURE THAT NOTHING WILL BRICK.
+
Since there is still a high demand for preloader and I don't really want to work on
BUT THIS IS STILL NO GUARANTEE!!
+
it anymore I thought it would be the best to release the source.
THE AUTHOR CAN NOT BE HELD RESPONSIBLE FOR ANY DAMAGE IT MIGHT CAUSE!
+
Source is released under GNU GPL 2.
YOU ACCEPT THAT YOU INSTALL THIS ON YOUR OWN RISK!
+
 
 +
== 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!!
  
== Changelog ==
+
YOU AGREE THAT YOU INSTALL THIS TOOL ON YOUR OWN RISK, THE AUTHOR CAN NOT BE HELD
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 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 shutdownmode (OFF/Standby)
 
* fixed that under certain circumstances hacks from another version were applied
 
* fixed a setting related bug
 
  
0.26:
+
RESPONSIBLE FOR ANY DAMAGES CAUSED BY EITHER USING OR INSTALLING THIS TOOL.
  
* added elf-loading (able to load white-linux!)
+
==Note on compiling ==
* added an option to load preloader or the systemmenu when the return-to state is used.
+
Code has been tested on the latest devkitPro with devkitPPC and should compile fine.
* made the systemmenu-hacklist scrollable allowing an unlimited amount of hacks
 
* rewrote the installer
 
* some interface improvements
 
* fixed the online update
 
* fixed return to systemmenu, which loaded preloader instead
 
* fixed shutting down from systemmenu, which loaded preloader instead
 
* fixed a bug in the "Install/Load File" menu that allowed to move out of the list
 
* fixed systemmenu loading for all systemmenu versions
 
* fixed the stuck-systemmenuhack-option bug
 
* fixed the bug that when a nunchuck was connected the systemmenu 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
 
  
== Notes ==
+
Before you can compile anything you need to place a certs.bin into the data directory.
Preloader 'replaces' the systemmenu (it's not really replaced, its main.dol is just
 
renamed) with a simple loader which allows you to automatically load the HBC,
 
a .dol/.elf you can install from SD or the systemmenu.
 
To overwrite the autobooting simply hold RESET on bootup.
 
It also allows you to use simple patches on the systemmenu.
 
Modifying the installer can lead to a brick. *cough* comex *cough*
 
  
 
== Hacks ==
 
== Hacks ==
Simply place the supplied hacks.ini in the root of the SD and enter the settings
+
To install additional System Menu patches, simply copy the "[[/hacks|hacks.ini]]" file
and then the hack settings to select the once you want to use.
+
included with preloader into the root of your SD card. (Ensure you are using the correct hacks.ini for your Wii's region.)
Once save settings is selected the hacks.ini is copied to the NAND and it's no longer
+
necessary to keep the file on the SD card.
+
Then, boot into Preloader's settings, and chose to enable or disable the patches
The format is very simple and should not require any explanation.
+
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 ==
 
== Uninstall ==
The simpliest and safest way to uninstall preloader is to reinstall the Systemmenu
+
The simplest and safest way to remove preloader is to reinstall the System Menu
using AnyRegionChanger(enter hardlump, see wiibrew.org) or a wad installer.
+
using [[AnyRegion Changer]] or a WAD installer.
  
 
== Greetings ==
 
== Greetings ==
Line 76: Line 71:
 
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
 +
*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
  
devkitPro
+
'''0.28:'''
Team Twiizers
+
*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
  
#todXXX the sanctuary!
+
'''0.27:'''
#playground
+
*added a setting to stop the disc when autoboot is disabled
#wiidev (both of them!)
+
*added a setting to return to Preloader when Wii titles are using the switch off state
#dsidev
+
*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