Priiloader: a Wii bootloader that fixes banner bricks and applies system menu patches

Priiloader runs before the System Menu, which is the whole trick

Priiloader is an application loaded prior to the Wii System Menu, and that placement explains both what it can repair and what it cannot. The project describes itself as a heavily modified version of Preloader 0.30, created by DacoTaco and BadUncle. Because it executes before the System Menu is touched, a broken menu does not stop it from loading, so it can fix certain kinds of bricks that leave the System Menu in a broken state, with a banner brick named as the example. It can also add patches to the System Menu, such as update blockers or Wiimmfi patches. The word heavily modified is doing real work in that description, and the changelog against the Preloader base reads like a fork that diverged for years rather than a small patch set. It is written in C++, it builds with a plain Makefile across several subdirectories, and the source tree separates the loader, the bootloader tool, OpenDolBoot and the installer.

The hard boundary is a bricked System Menu IOS

There is one warning in the documentation that matters more than any feature list, and it is worth reading carefully before anything else. Priiloader will not save your Wii if the System Menu IOS has been damaged. The note points at the IOS history page to check which IOS that is on your console, and it names IOS80 on firmware 4.3. Priiloader lives at a layer below the System Menu, so if the code it would have to patch is the code that is broken, there is nothing for it to work with. The logic holds in both directions and is the reason the tool exists at all: Priiloader can rescue damage that breaks the menu but leaves the lower IOS intact, and it is powerless against damage to the IOS that the menu runs on. If you are reading this while staring at a black screen with no homebrew access, this project is not the tool for your problem and the linked IOS history reference is the place to start instead.

Installing it needs a boot path to homebrew and nothing else exotic

The installation requirement is stated in one line and it is simpler than most Wii homebrew tools. All you need is a way of booting homebrew, with the Homebrew Channel recommended. If your Homebrew Channel is version 1.0.7 or above, you need no patched IOS at all. If it is older, a patched IOS36 is required, although the recommendation is simply to update the Homebrew Channel instead. Priiloader itself needs no hacked IOS, and the documentation goes further and recommends using unpatched IOS. The project also ships its own installer, described in the changelog as phpgeek's, so the install path is bundled rather than something you have to fetch separately, and online updating was re-added after being dropped in the base version. The whole point of the layering is that this is a component you can install without already having a working hack infrastructure in place.

Hacks are matched by offset or by hash, which decides whether they survive an update

The hack system is the part of the design with a real engineering trade-off. Hacks can be added either with their offset or with a hash value, and the hash route is described as allowing version-agnostic patches. That distinction determines whether your patch keeps working. An offset is a fixed address in the System Menu, so it is precise but it breaks when the menu changes, which is exactly what happens across a Wii system update. A hash identifies the code by what it looks like rather than where it sits, so it can survive a rebuild of the same menu version and fail loudly when the code changes shape. The repository keeps this knowledge in separate documents: a FAQ, a document about how hacks work, and a list of the available hacks. The presence of a dedicated hack list and a discussion thread for testing and hack creation suggests the practical work here is maintaining patches against a moving target rather than shipping new features.

What changed since Preloader 0.30, including the DVD spin bug

The changelog in the project documentation is the best description of the fork's current shape, and several entries are worth pulling out. vWii and Wii Mini support were added, which matters because those consoles run different hardware and shipped later. A Bootmii IOS booting option was added to the menu and to autoboot, described as handy for restoring or for sneaking. Support for all Homebrew Channel title IDs was added, the need for ES_Diverify was removed, and an HBC stub loading mechanism was added. Online updating was re-added, along with the old black theme and the project's own installer. There are also smaller fixes with a specific cause, such as the DVD spin bug, which the changelog attributes to ios not closing the DVD drive, and a boot check that lets some apps reboot or launch the System Menu while forcing Priiloader to show up first. A password can be required at boot, and HBC and WiiWare and Virtual Console titles can be started from the loader.

Building from source across four make targets

The repository builds with GNU Make and a top level target that delegates into four subdirectories, so a full build is a single make invocation in the root.

all:
	$(MAKE) -C ./src/loader
	$(MAKE) -C ./tools/bootloader
	$(MAKE) -C ./tools/OpenDolBoot	
	$(MAKE) -C ./src/priiloader
	$(MAKE) -C ./src/Installer

The subdirectory names tell you what gets produced: the loader itself, a bootloader tool, OpenDolBoot, the Priiloader application and the installer. The tree also holds a docs directory with the FAQ and hack documentation, a tools directory, an Images directory for the artwork, and a .vscode directory with a code-workspace file, which tells you the development environment is Visual Studio Code with a C++ toolchain. There is no package manager, no dependency lock file and no test target in the Makefile, which is a fair reflection of the domain: this is code that runs on a 2006 games console, so the meaningful verification is on hardware rather than in an automated harness.

Releases lag the commits, and the licence is GPL-2.0

The maintenance picture has two halves that do not match. The last push to the repository was on 2026-10-12, so work is still landing, but the published releases are old. The tags are 0.10.0 from 2023-09-09, 0.10.0-RC3 from 2023-07-19 and 0.9.1 from 2021-04-03, with the 0.10.0 release carrying the name Version Kappa. If you are following the source rather than a release, expect a different codebase from the one most guides describe, and expect no published binary for whatever is in the tree today. The project is GPL-2.0, so distributing a modified build carries the same source disclosure obligation as any GPL work, and the codebase itself is a community fork of an earlier GPL-era homebrew project. Support is also community-run rather than institutional. The developer is reachable on efnet in the priiloader and wiidev channels and on GitHub, and the project accepts donations through ko-fi. For a tool whose whole purpose is recovering damaged consoles, that support channel being a chat channel rather than a ticket queue is worth factoring into your decision.

Editorial conclusion

Priiloader fits a Wii owner whose System Menu is broken in a way that leaves the console bootable into homebrew, since that is exactly the damage this loader can repair, and it fits an owner who wants patches such as update blockers or Wiimmfi patches applied at boot without touching the System Menu each time. It does not fit a console whose System Menu IOS itself is damaged, because the project is explicit that Priiloader will not save a Wii in that case and you need another recovery path. Before installing it, confirm you can boot homebrew at all, with Homebrew Channel 1.0.7 or above needing no patched IOS, and read the FAQ and hack documentation linked from the repository rather than assuming a hack applies to your IOS version.

Frequently asked questions

Official sources

1. DacoTaco/priiloader on GitHub
2. Issues
3. License: GPL-2.0
4. README
5. Releases