emulator: DOSBox Pure
type: libretro
source: "https://github.com/libretro/dosbox-pure"
logo: "https://raw.githubusercontent.com/schellingb/dosbox-pure/main/images/logo.png"
profiled_date: "2026-03-18"
core_version: "0.9.9"
display_name: "DOS (DOSBox-Pure)"
cores: [dosbox_pure]
systems: [dos]
verification: sha1
notes: >
  No BIOS required. MT-32 and SoundFont support is optional for MIDI music.
  The core scans the RetroArch system directory (and subdirectories) for files
  ending in _CONTROL.ROM (MT-32/CM-32L) and .SF2/.SF3 (General MIDI SoundFont).
  MT-32 requires a matched pair: *_CONTROL.ROM + *_PCM.ROM in the same directory.
  Files can also be placed inside the game content as DOSBOX.SF2 or MT32_CONTROL.ROM
  + MT32_PCM.ROM on the mounted C: drive. ZIP archives containing both ROMs are
  also supported (identified by file size, not name). A cache file
  DOSBoxPureMidiCache.txt is written to system dir when scan takes >2s.
  Uses bundled MUNT (mt32emu) for MT-32 emulation, TinySoundFont for SF2 playback.
  No firmware entries in the .info file - all MIDI files are optional enhancements.

files:
  # -- MT-32 Control ROMs (64 KB) --

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control v1.04"
    required: false
    size: 65536
    sha1: "5a5cb5a77d7d55ee69657c2f870416daed52dea7"
    source_ref: "mt32emu.h:CTRL_MT32_V1_04"

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control v1.05"
    required: false
    size: 65536
    sha1: "e17a3a6d265bf1fa150312061134293d2b58288c"
    source_ref: "mt32emu.h:CTRL_MT32_V1_05"

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control v1.06"
    required: false
    size: 65536
    sha1: "a553481f4e2794c10cfe597fef154eef0d8257de"
    source_ref: "mt32emu.h:CTRL_MT32_V1_06"

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control v1.07"
    required: false
    size: 65536
    sha1: "b083518fffb7f66b03c23b7eb4f868e62dc5a987"
    source_ref: "mt32emu.h:CTRL_MT32_V1_07"

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control BlueRidge"
    required: false
    size: 65536
    sha1: "7b8c2a5ddb42fd0732e2f22b3340dcf5360edf92"
    source_ref: "mt32emu.h:CTRL_MT32_BLUER"

  # -- MT-32 v2.x Control ROMs (128 KB) --

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control v2.03 (new MT-32)"
    required: false
    size: 131072
    sha1: "5837064c9df4741a55f7c4d8787ac158dff2d3ce"
    source_ref: "mt32emu.h:CTRL_MT32_V2_03"

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control v2.04"
    required: false
    size: 131072
    sha1: "2c16432b6c73dd2a3947cba950a0f4c19d6180eb"
    source_ref: "mt32emu.h:CTRL_MT32_V2_04"

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control v2.06"
    required: false
    size: 131072
    sha1: "2869cf4c235d671668cfcb62415e2ce8323ad4ed"
    source_ref: "mt32emu.h:CTRL_MT32_V2_06"

  - name: "MT32_CONTROL.ROM"
    description: "MT-32 Control v2.07"
    required: false
    size: 131072
    sha1: "47b52adefedaec475c925e54340e37673c11707c"
    source_ref: "mt32emu.h:CTRL_MT32_V2_07"

  # -- CM-32L / LAPC-I Control ROMs (64 KB) --

  - name: "CM32L_CONTROL.ROM"
    description: "CM-32L/LAPC-I Control v1.00"
    required: false
    size: 65536
    sha1: "73683d585cd6948cc19547942ca0e14a0319456d"
    source_ref: "mt32emu.h:CTRL_CM32L_V1_00"

  - name: "CM32L_CONTROL.ROM"
    description: "CM-32L/LAPC-I Control v1.02"
    required: false
    size: 65536
    sha1: "a439fbb390da38cada95a7cbb1d6ca199cd66ef8"
    source_ref: "mt32emu.h:CTRL_CM32L_V1_02"

  # -- CM-32LN / CM-500 / LAPC-N Control ROM (64 KB) --

  - name: "CM32LN_CONTROL.ROM"
    description: "CM-32LN/CM-500/LAPC-N Control v1.00"
    required: false
    size: 65536
    sha1: "dc1c5b1b90a4646d00f7daf3679733c7badc7077"
    source_ref: "mt32emu.h:CTRL_CM32LN_V1_00"

  # -- PCM ROMs --

  - name: "MT32_PCM.ROM"
    description: "MT-32 PCM ROM"
    required: false
    size: 524288
    sha1: "f6b1eebc4b2d200ec6d3d21d51325d5b48c60252"
    source_ref: "mt32emu.h:PCM_MT32"
    notes: "pairs with any MT-32 v1.x control ROM"

  - name: "CM32L_PCM.ROM"
    description: "CM-32L/CM-64/LAPC-I PCM ROM"
    required: false
    size: 1048576
    sha1: "289cc298ad532b702461bfc738009d9ebe8025ea"
    source_ref: "mt32emu.h:PCM_CM32L"
    notes: "pairs with MT-32 v2.x or CM-32L control ROMs. Lower half aliases MT-32 PCM."

  # -- General MIDI SoundFont --

  - name: "DOSBOX.SF2"
    description: "General MIDI SoundFont (any .sf2/.sf3 accepted)"
    required: false
    source_ref: "dosbox_pure_libretro.cpp:1375,2760"
    notes: >
      Any .SF2 or .SF3 file in the system directory works. The core lists all
      found SoundFonts in the MIDI config dropdown. DOSBOX.SF2 is the conventional
      name and is also auto-detected when placed inside game content on C: drive.