RPi-Mac turns a Raspberry Pi Zero 2 W into a classic 68k Macintosh. Flash an SD card, power on, and the Pi boots straight into a Quadra-class Mac — grey checkerboard, Happy Mac, desktop. No visible Linux anywhere.
Grab a ready-made image below — there is one for HDMI screens and one preconfigured for the Waveshare 2.8″ DPI LCD — or use the SD Card Builder to compose your own: pick the Mac OS disk images and install CDs you want on the card, choose your display, and bake in your WiFi settings, so the Mac is on the network the first time it boots.
Every image boots Mac OS 8.1, with a System 7.5 disk included on the card (install it any time from the Mac's web control panel) and a System 7.5.3 install CD attached for recovery. Pick the flavour that matches your screen — that is the only difference between them:
| For | Image | Released | Size | |
|---|---|---|---|---|
| HDMI display | image_2026-06-17-RPi-Mac.img.xz |
2026-06-17 | 1.0 GB | Download bmap |
| Waveshare 2.8″ DPI LCD | image_2026-06-17-RPi-Mac-Waveshare.img.xz |
2026-06-17 | 1.0 GB | Download bmap |
| HDMI display | image_2026-06-15-RPi-Mac.img.xz |
2026-06-15 | 1.2 GB | Download bmap |
| Waveshare 2.8″ DPI LCD | image_2026-06-15-RPi-Mac-Waveshare.img.xz |
2026-06-15 | 1.2 GB | Download bmap |
| HDMI display | image_2026-06-13-RPi-Mac.img.xz |
2026-06-13 | 964.9 MB | Download bmap |
| Waveshare 2.8″ DPI LCD | image_2026-06-13-RPi-Mac-Waveshare.img.xz |
2026-06-13 | 964.3 MB | Download bmap |
| HDMI display | image_2026-06-12-RPi-Mac.img.xz |
2026-06-12 | 964.5 MB | Download bmap |
| Waveshare 2.8″ DPI LCD | image_2026-06-12-RPi-Mac-Waveshare.img.xz |
2026-06-12 | 963.9 MB | Download bmap |
mac.txt on the
bootfs partition (visible from any computer) and fill in
WIFI_SSID / WIFI_PASS. The stock images
ship without WiFi configured — use the
SD Card Builder instead if you want
it baked in. Display and rotation can be changed in the same file.Choose from 2 Mac OS disk images, 2 CD-ROM images and 1 ROM in the library, add blank disks to install onto, and enter the WiFi network the Pi should join.
This server assembles a personalised SD card image: your picks are
written into the system image and your settings into
mac.txt, then everything is compressed for download.
It takes a few minutes.
Download the finished .img.xz, flash it like any other
image, insert the card into a Pi Zero 2 W and power on. The Mac
appears on your WiFi with a web control panel at
http://rpimac.local/.
Custom images contain the WiFi password you enter, so download links are private and builds are deleted from the server after 24 hours.