Welcome to

Blue

Run classic Mac OS on arbitrary hardware by replacing the bottom of the OS instead of emulating a whole Power Mac.

For macOS and Linux, on AArch64 (Apple silicon) and x86_64.

How It Works

On a real Power Mac only the NanoKernel runs in supervisor mode. The 68k emulator, the Toolbox, applications and drivers all run in PowerPC user mode and reach the kernel through a small interface.

Blue runs all of that Apple code unmodified, as the guest, and supplies everything below the interface as an ordinary program on the host.

Where Mac OS looks to the machine for drivers, Blue puts its own in the device tree, as a Mac’s firmware would. They’re thin: the work is done on the host. The system helpers work the same way. Once the Finder is up, Blue offers to install them, then restarts Mac OS: guest enhancements that make the screen follow the window and share the clipboard, a 3D engine, OpenGL, and a library for Pippin titles.

Guest

Mac OS

68k apps and Toolbox code Apple’s 68k emulator, from the ROM PowerPC apps, Toolbox and drivers

Apple code, unmodified, in PowerPC user mode

Drivers

Display, disks, CDs and floppies, Ethernet

Built in, in the device tree

System helpers

Guest enhancements, 3D engine, OpenGL, Pippin library

Offered once the Finder is up, installed in Extensions

NanoKernel interface

kernel calls (twi, and sc on v2), exceptions, interrupts

Host calls

from Blue’s drivers and helpers

Host

Blue

CPU PowerPC JIT and interpreter Kernel Memory, interrupts, Multiprocessing Services Devices An iMac’s: ADB, timers, display interrupt, sound, Ethernet, USB, NVRAM Drivers Display, disks, CDs and floppies, Ethernet, 3D, OpenGL Loader ROM and its parcels, tables, device tree

macOS or Linux

SDL2 Window, input, sound and clipboard OpenGL 3D on the GPU (over Metal on Apple silicon) libslirp Network: NAT and DHCP Files Disk, CD and floppy images, a shared folder, NVRAM

Status

13 items
Mac OS 8.5–9.2.2 Working: 8.5–9.0.4 on the NanoKernel v1 interface, 9.1–9.2.2 on v2, with its Multiprocessing Services.
Display In a window or full screen, with a Platinum menu (F12); with the guest tools, the screen follows the window’s size, at a scale suited to the display’s pixel density. A hardware cursor, and the iMac’s 60 Hz display interrupt.
Sound Output through an AWACS chip, as in the iMac, with CD audio.
Keyboard & Mouse Over ADB.
Clipboard Text shared with the host both ways, with the guest tools.
Disks, CDs and floppies Disk, CD (also .cue/.bin with audio tracks) and floppy images; drop one on the window, or Insert… from the menu. Discs stay in through a restart, and Startup Disk picks the startup disk.
Shared folders A folder of yours appears as a disk in Mac OS; its changes go back to the folder when Mac OS shuts down.
Networking Built-in Ethernet (BMac+, as in the iMac) working, through the host’s connection. Needs libslirp.
QuickDraw 3D & RAVE Working, through a RAVE engine games see as an ATI Rage 128. Drawn with OpenGL on the host’s GPU (over Metal on Apple silicon), or in software.
OpenGL Working, through Blue’s own OpenGL libraries, drawn the same way.
Pippin titles Many Bandai Pippin discs run, with Blue’s own Pippin library in place of the console’s.
CPU PowerPC G3 (750) equivalent. JIT on Apple silicon, ARM64 (AArch64) Linux and x86_64 (Intel from 2013, AMD from 2015; older processors interpret). Fast start speeds through startup timeouts. Supports napping.
AltiVec Not yet.

Get Started

Blue doesn’t include any Apple software. You’ll need an image of a Mac OS CD from 8.5 to 9.2.2. Blue starts the “Mac OS ROM” file from the CD or the installed disk, as an iMac’s firmware does.

Download

macOS 11 or later: drag Blue to Applications. It isn’t notarized: the first time, right-click it and choose Open, or on macOS 15 and later click Open Anyway in System Settings › Privacy & Security. Linux: chmod +x the AppImage; without FUSE, add --appimage-extract-and-run. Blue runs from the command line for now; a launcher is coming. Or build it with make (then it’s build/blue). The JIT runs on AArch64 and on x86_64 processors with x86-64-v3 (Intel’s Haswell and AMD’s Excavator on); older x86_64 processors interpret.

Install Mac OS

# macOS
/Applications/Blue.app/Contents/MacOS/blue disk create hd.img 2G "Macintosh HD"
/Applications/Blue.app/Contents/MacOS/blue boot --disk hd.img --cdrom 85.iso --nvram blue.nvram
# Linux (or Blue-aarch64.AppImage)
./Blue-x86_64.AppImage disk create hd.img 2G "Macintosh HD"
./Blue-x86_64.AppImage boot --disk hd.img --cdrom 85.iso --nvram blue.nvram

In the installer’s Options, turn off “Update Apple Hard Disk Drivers”. A 9.2.2 CD that restores an image with Apple Software Restore instead needs the new disk chosen as its destination.

Start up

# macOS
/Applications/Blue.app/Contents/MacOS/blue boot --disk hd.img --nvram blue.nvram
# Linux
./Blue-x86_64.AppImage boot --disk hd.img --nvram blue.nvram

Once the Finder is up, Blue offers to install its guest tools (the screen follows the window, the clipboard is shared, the 3D engine and OpenGL), then restarts Mac OS. To put in a CD or floppy, drop its image on the window, or use Insert… in Blue’s menu (F12); --share DIR shows a folder of yours as a disk in Mac OS.

Thanks

Blue stands on other people’s careful work:

  • Elliot Nunn’s reverse engineering of the Power Mac ROM: NanoKernel, powermac-rom (NanoKernel 2, its tasks and Multiprocessing Services) and tbxi. Blue’s kernel is its own code, written to what these document.
  • QEMU and OpenBIOS, which run Apple’s own NanoKernel 2, for Blue’s to be checked against; and QEMU’s libslirp for networking.
  • SheepShaver and Basilisk II, which showed long ago that classic Mac OS can run on a host kernel.
  • Mesa and SGI’s OpenGL Utility library, for OpenGL.
  • SDL, Dear ImGui and Robin Casady’s ChicagoFLF, after Susan Kare’s Chicago, for the window.
  • Apple’s own documentation: Inside Macintosh, the technotes and developer notes, and Darwin’s headers.