Welcome to pimac.net

A classic Macintosh on a Raspberry Pi

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.

Stock Images

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:

  • HDMI — for TVs and monitors. Plug in, flash, boot.
  • Waveshare 2.8″ DPI LCD — preconfigured for that panel (including its touchscreen), ready to go with no editing. The classic "Mac Clock on the desk" build.
ForImageReleasedSize
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

After flashing

  1. Flash with Raspberry Pi Imager ("Use custom") or balenaEtcher, onto an 8 GB or larger card. Skip the Imager's OS customisation step — the image manages its own users and WiFi.
  2. For WiFi: open 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.
  3. Boot the Pi. The first boot takes a few extra minutes: the filesystem grows to fill the card and the compressed Mac OS 8 system disk is unpacked (progress appears on the boot screen), with one automatic reboot along the way.
About the SD Card Builder

1. Compose

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.

2. Bake

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.

3. Flash and boot

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.