Overview
cydintosh runs a Macintosh Plus emulator on small ESP32 display boards. It is a fork of likeablob/cydintosh.
This fork adds repeatable board profiles, browser-flashable artefacts and hardware bring-up for CYD2USB and the Sunton ESP32-8048S043C. The emulator combines umac with the Musashi 68000 core; users supply a Mac Plus ROM v3 and a bootable HFS disk image.
How it works
A board profile selects display, touch, memory and storage settings. The ESP32-S3 profile loads a patched Mac ROM from flash and mounts the guest disk from LittleFS before starting the 68000 runtime.
The emulated 480×800 Macintosh framebuffer is rotated onto the 800×480 RGB panel. GT911 touch input enters through the board profile; ROM, firmware and filesystem images are packaged for serial or browser flashing.
Features
Macintosh Plus runtime
Uses umac and Musashi with board-specific ROM patching and emulated RAM configuration.
Validated ESP32-S3 profile
The ESP32-8048S043C profile detects 8MB octal PSRAM and GT911 touch, and boots System 6 with After Dark 2 from a 1.44MB HFS image.
CYD build profiles
Retains a legacy ESP32-2432S028/CYD2USB build and an experimental rotated 512×384 profile.
Browser flasher
Builds bootloader, partition, firmware, LittleFS and complete flash images for Web Serial deployment.
Board-specific storage
The validated ESP32-S3 profile mounts its guest disk read-only because the current Sony write path is not reliable enough for desktop metadata writes.
Optional networking
Wi-Fi setup is skipped when credentials are absent; emulator boot does not depend on network access.
Architecture
Posts
2026-07-31
Emulation
2026-07-20
The M5Stack Tab5