Noureddine RAMDI / wiiMac: booting PowerPC Mac OS X on Nintendo Wii hardware

Created Mon, 04 May 2026 10:12:30 +0000 Modified Sat, 23 May 2026 20:41:27 +0000
796 Words
github-stars powerpc bootloader macosx wii reverse-engineering kernel-patching

bryankeller/wiiMac

Booting Mac OS X on a Nintendo Wii sounds like a hack from the depths of retro computing, but wiiMac makes it a reality. This project tackles the hardware abstraction challenge by reverse-engineering the Wii’s unique PowerPC Broadway CPU and Hollywood chipset to create a bootloader that tricks Mac OS X into running on non-Apple hardware.

wiiMac bootloader: bridging Mac OS X and Wii hardware

wiiMac is a bootloader written in C that allows PowerPC versions of Mac OS X (from 10.0 Cheetah through 10.5 Leopard) to boot natively on Nintendo Wii consoles. The Wii’s CPU, Broadway, is a PowerPC processor, which aligns with the architecture expected by these older Mac OS versions. However, the hardware differences are significant, requiring deep modifications.

The project depends on a soft-modded Wii with BootMii installed as boot2 or IOS, serving as the initial bootloader environment. wiiMac then takes control to initialize hardware, configure video modes (covering NTSC and PAL variants), and properly pass boot arguments to Mac OS X.

A notable architectural detail is the use of two SD cards: one holds the BootMii bootloader chain and wiiMac files, while the second contains an Apple Partition Map (APM) formatted HFS+ volume with Mac OS X system files, installer, and support files. These support files include patched kernels and custom IOKit drivers tailored to translate Wii hardware calls into ones Mac OS X expects.

Under the hood, the patched mach_kernel bridges the XNU kernel’s hardware expectations with the Wii’s actual hardware topology. The custom IOKit drivers emulate or stub out missing hardware components, enabling the operating system to run despite the non-standard environment.

technical strengths and tradeoffs: low-level hardware adaptation and kernel patching

The standout technical achievement is the reverse engineering of the Wii’s Hollywood chipset and Broadway CPU to build drivers that fool Mac OS X into treating the Wii like a PowerPC Mac. This involves patching the XNU kernel to support the Wii’s hardware idiosyncrasies and handling video output differences via custom video mode configuration.

The bootloader’s codebase is written in C, focusing on minimal dependencies and direct hardware manipulation. The code quality is pragmatic and focused on the core challenge rather than polish — which is typical for projects dealing with bootloaders and hardware abstraction layers.

Tradeoffs are clear: wiiMac does not support Wi-Fi, Bluetooth, optical drives, hardware-accelerated graphics, or audio. These omissions are understandable given the Wii’s hardware and the complexity of fully emulating a PowerPC Mac environment. The project is a proof-of-concept rather than a ready-to-use daily driver.

The reliance on two SD cards and specific partition schemes (MBR for BootMii, APM for Mac OS X system) adds complexity to the setup and limits convenience. However, an advanced user could consolidate to a single SD card with careful manual partitioning.

quick start: setting up wiiMac on your Wii

Prerequisites

  • A Wii with an SD card slot (excluding Wii Mini)
  • The Wii must be soft-modded with BootMii installed as boot2 or IOS
  • One MBR-formatted SD card with FAT32 partition containing BootMii files (/bootmii/ppcboot.elf and /bootmii/armboot.bin)
  • A second SD card (minimum 4 GB) for Mac OS X system files

SD card setup

BootMii SD card

  1. Download the latest release of wiiMac
  2. Copy the entire wiiMac folder (with wiiMac.elf and config.txt) to the root of your BootMii SD card
  3. Verify the directory structure:
/
└── bootmii
    ├── ppcboot.elf
    └── armboot.bin
└── wiiMac
    ├── wiiMac.elf
    └── config.txt
  1. Edit /wiiMac/config.txt to set the correct video_mode for your Wii (options: ntscp, ntsci, pal60, pal50)

Mac OS X system SD card

Prepare a second SD card with three partitions:

  • Destination partition for Mac OS X installation
  • Installer partition from which Mac OS X will boot for installation
  • Support partition holding patched kernel and drivers

Partitioning instructions vary by host OS and are detailed in the repository’s documentation.

Advanced note

It is possible to use a single SD card with a hybrid partition scheme combining MBR and APM, but this requires manual partitioning with tools like fdisk.

verdict: a niche but impressive hardware porting effort

wiiMac is not for the casual user or anyone looking for a daily-use Mac OS X on Wii experience. It’s a technically demanding project aimed at enthusiasts interested in low-level hardware porting, bootloader development, and PowerPC-era Mac OS internals.

The project’s codebase and documentation offer valuable insights into reverse engineering, kernel patching, and cross-platform OS adaptation. Despite its limitations — no wireless, audio, or GPU acceleration — the effort to bring Mac OS X to such an unconventional platform is a testament to the depth of understanding and creativity of its author.

If you’re into retro computing, hardware abstraction challenges, or PowerPC internals, wiiMac is worth exploring. For practical use, though, it remains a proof-of-concept rather than a polished solution.

→ GitHub Repo: bryankeller/wiiMac ⭐ 626 · C