libretro/emulators/winuae.yml

emulator: WinUAE
type: standalone
core_classification: other
source: "https://github.com/tonioni/WinUAE"
source_commit: "17a26fa8e65e40cf4fbe33ffbdfa420a355a813d"
profiled_date: "2026-10-20"
core_version: "6.1.0 beta 19"
display_name: "Commodore - Amiga (WinUAE)"
cores:
  - winuae
systems:
  - commodore-amiga
  - commodore-cd32
  - commodore-cdtv
mode: standalone
found_by: content

notes: |
  Amiga emulator for Windows by Toni Wilen. The Kickstart is the file named by
  kickstart_rom_file in the configuration. When it is absent the loader tries
  roms/kick.rom, kick.rom, ../shared/rom/kick.rom and ../System/rom/kick.rom
  under the data path, then guesses from the scanned ROM list
  (memory.cpp:2038-2071). When nothing loads it reports the missing ROM and
  boots the built-in AROS replacement (memory.cpp:3058-3063). Loaded ROMs are
  matched against the ROM table only to name them and check the CPU they need.
  An unknown ROM is still used (memory.cpp:3064-3101).

  The ROM list is built by scanning KickstartPath and the default ROM paths
  when no DetectedROMs list exists yet. Every file below 10000000 bytes
  whose extension is rom, bin, adf, key, a500, a600, a1200, a3000, a4000,
  cd32 or U followed by a digit is identified against the ROM table, whatever
  the rest of its name (od-win32/win32.cpp:5385-5404,
  od-win32/win32gui.cpp:1747-1772, od-win32/win32gui.cpp:1829-1876,
  od-win32/win32gui.cpp:1974-2105). The guess step takes a scanned ROM whose
  file name matches the configured one (rommgr.cpp:2428-2461). The Kickstart entries below are named after other
  profiles' names for the same dumps: the code opens none of those names.
  kickstart_ext_rom_file is opened as given, and a missing extended ROM
  only raises a notice (memory.cpp:1833-1849). The machine then starts on
  the Kickstart alone with nothing mapped in place of the extended ROM, and
  the AROS replacement is used only when the Kickstart itself is missing
  (memory.cpp:3055-3063). The CD drivers and CD boot code are resident
  modules of the extended ROMs: cdstrap, cd.device and cdfs.library in the
  CD32 ROM, cdtv.device, cdfs.library and cdstrap in the CDTV ROM. The CD32
  and CDTV Kickstarts carry none. The CD32 quickstart model and the base
  CDTV model have no floppy drive (cfgfile.cpp:9374-9378, 9404-9405), and
  both ask for the extended ROM (cfgfile.cpp:9389-9394, 9413-9422), so
  without it no CD is read or booted.

  CDTV and A600/A1200 internal devices are enabled with :ENABLED, which needs
  no ROM file. Cloanto encrypted ROMs are decoded with rom.key, searched in the
  configured key path, the ROM path, roms/, the data path, ../shared/rom/ and
  next to the Kickstart file (rommgr.cpp:1459-1535). Without it an encrypted
  ROM fails to load (rommgr.cpp:1724-1732).

files:
  - name: "kick.rom"
    path: "roms/kick.rom"
    load_from: data_dir
    found_by: name
    system: commodore-amiga
    required: false
    hle_fallback: true
    note: "Opened when the configured Kickstart is missing: roms/kick.rom, kick.rom, ../shared/rom/kick.rom and ../System/rom/kick.rom under the WinUAE data path, in that order."
    source_ref: "memory.cpp:2038-2071"

  - name: "amiga-os-130.rom"
    system: commodore-amiga
    required: true
    hle_fallback: true
    size: 262144
    crc32: "c4f0f55f"
    sha1: "891e9a547772fe0c6c19b610baf8bc4ea7fcb785"
    note: "KS ROM v1.3 (A500, A1000, A2000), 315093-02."
    source_ref: "rommgr.cpp:150-151"

  - name: "amiga-os-204.rom"
    system: commodore-amiga
    required: false
    hle_fallback: true
    size: 524288
    crc32: "c3bdb240"
    sha1: "c5839f5cb98a7a8947065c3ed2f14f5f42e334a1"
    note: "KS ROM v2.04 (A500+)."
    source_ref: "rommgr.cpp:158-159"

  - name: "amiga-os-310-a600.rom"
    system: commodore-amiga
    required: false
    hle_fallback: true
    size: 524288
    crc32: "fc24ae0d"
    sha1: "3b7f1493b27e212830f989f26ca76c02049f09ca"
    note: "KS ROM v3.1 r40.63 (A500, A600, A2000)."
    source_ref: "rommgr.cpp:183-184"

  - name: "amiga-os-310-a1200.rom"
    system: commodore-amiga
    required: true
    hle_fallback: true
    size: 524288
    crc32: "1483a091"
    sha1: "e21545723fe8374e91342617604f1b3d703094f1"
    note: "KS ROM v3.1 r40.68 (A1200)."
    source_ref: "rommgr.cpp:185-186"

  - name: "amiga-os-310-a4000.rom"
    system: commodore-amiga
    required: true
    hle_fallback: true
    size: 524288
    crc32: "d6bae334"
    sha1: "5fe04842d04a489720f0f4bb0e46948199406f49"
    note: "KS ROM v3.1 r40.68 (A4000)."
    source_ref: "rommgr.cpp:195-196"

  - name: "amiga-os-310-cd32.rom"
    system: commodore-cd32
    required: true
    hle_fallback: true
    size: 524288
    crc32: "1e62d4a5"
    sha1: "3525be8887f79b5929e017b42380a79edfee542d"
    note: "CD32 KS ROM v3.1 r40.60."
    source_ref: "rommgr.cpp:323-324"

  - name: "amiga-ext-310-cd32.rom"
    system: commodore-cd32
    required: true
    size: 524288
    crc32: "87746be2"
    sha1: "5bef3d628ce59cc02a66e6e4ae0da48f60e78f7f"
    note: "CD32 extended ROM r40.60, passed as kickstart_ext_rom_file."
    source_ref: "rommgr.cpp:325-326, memory.cpp:1833-1849"

  - name: "amiga-ext-130-cdtv.rom"
    system: commodore-cdtv
    required: true
    size: 262144
    crc32: "42baa124"
    sha1: "7ba40ffa17e500ed9fed041f3424bd81d9c907be"
    note: "CDTV extended ROM v1.0, passed as kickstart_ext_rom_file with the 1.3 Kickstart."
    source_ref: "rommgr.cpp:339-340, memory.cpp:1833-1849"

  - name: "rom.key"
    found_by: name
    system: commodore-amiga
    required: false
    size: 2069
    crc32: "869ae1b1"
    sha1: "801bbab32e3d37386dd1636d4f1d6fa7e21d5874"
    note: "Cloanto Amiga Forever ROM key. Read from the configured key path, the ROM path, roms/, the data path, ../shared/rom/ and next to the Kickstart file, needed only for encrypted ROMs."
    source_ref: "rommgr.cpp:119-120, rommgr.cpp:1459-1535"