v2026.04.02/emulators/minivmac.yml

emulator: Mini vMac
type: libretro
core_classification: community_fork
source: "https://github.com/libretro/libretro-minivmac"
upstream: "https://www.gryphel.com/c/minivmac/"
profiled_date: "2026-03-24"
core_version: "36.04"
display_name: "Mac II (minivmac)"
cores: [minivmac]
systems: [macintosh-ii]

# Libretro port of Mini vMac 36.04, hardcoded for Mac II emulation
# (CurEmMd = kEmMd_II). 68020 CPU, FPU, ADB, VIA2, ASC. 640x480, 8-bit color.
# The VidROM is generated in memory by Vid_Init(), not loaded from a file.

# ROM loading order in LoadMacRom (OSGLUERETRO.c:774):
#   1. <system_dir>/MacIIx.ROM
#   2. <system_dir>/MacII.ROM
#   3. --rom command line arg
#   4. ~/.gryphel/mnvm_rom/MacII.ROM
#   5. app parent directory
#   6. current directory

# The libretro port does NOT call ROM_IsValid() (unlike upstream backends),
# so no checksum validation occurs. ROM_Init() patches the Mac's own boot
# ROM check (DisableRomCheck = 1, ROMEMDEV.c:279).

files:
  - name: "MacII.ROM"
    path: "MacII.ROM"
    required: true
    size: 262144
    validation: [size]
    source_ref: "minivmac/cfg/CNFGRAPI.h:32, minivmac/src/OSGLUERETRO.c:781"
    note: >
      Macintosh II ROM image (256 KB). Hardcoded as RomFileName. The core
      reads exactly kROM_Size (262144) bytes via filestream_read.

  - name: "MacIIx.ROM"
    path: "MacIIx.ROM"
    required: false
    size: 262144
    validation: [size]
    source_ref: "minivmac/src/OSGLUERETRO.c:778"
    note: >
      Macintosh IIx ROM image (256 KB). Tried first in the loading sequence.
      If present, takes priority over MacII.ROM.

notes:
  emulation_target: >
    Configured for Macintosh II (kEmMd_II). 68020 CPU, FPU, ADB, VIA2, ASC
    sound. Screen: 640x480, 8-bit color depth.
  info_discrepancy: >
    .info declares firmware_count=1 (MacII.ROM only). The code also tries
    MacIIx.ROM first (OSGLUERETRO.c:778).