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.
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
Apple code, unmodified, in PowerPC user mode
Drivers
Display, disks, CDs and floppies, EthernetBuilt in, in the device tree
System helpers
Guest enhancements, 3D engine, OpenGL, Pippin libraryOffered 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 treemacOS 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.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.
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.
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.