The openMSX libretro core emulates MSX1, MSX2, MSX2+, and turbo R computers. The documentation describes the core as preliminary.

Documented builds cover Linux (x86_64 and aarch64), Windows (x64), macOS (Apple Silicon and Intel), and Android (arm64-v8a). Android is limited to Software video output.

Getting started

No additional BIOS is needed to start the core with its included C-BIOS machines. At first start, the core writes its bundled machines, extensions, scripts, and C-BIOS ROMs to `system/openmsx/share`. It repeats this after a core update, overwriting only its own files.

Using a real MSX machine configuration

  • 1. Place the selected real machine's required system ROMs in `system/openmsx/share/systemroms`.
  • 2. Select the machine through the `Machine` core option.
  • 3. If C-BIOS MSX2+ starts instead, check that the selected machine's required system ROMs are present in that directory. The documented fallback for missing system ROMs is C-BIOS MSX2+.
  • openMSX identifies these ROMs by their contents, not their filenames.

Match the media to the machine

  • Documented content extensions:
  • - Cartridges: `.rom`, `.ri`, `.mx1`, `.mx2`, `.col`, `.sg`, `.sc`
  • - Disk images: `.dsk`, `.di1`, `.di2`, `.dmk`, `.xsa`
  • - Cassettes: `.cas`, `.wav`
  • - Disk lists: `.m3u`
  • - Archives: `.zip`, `.gz`

Controller selection

Choose the device for each controller port at `Controls > Port 1/2 Controls > Device Type`.

Saves and update precautions

The feature table marks “Saves” as unsupported, but separately lists state support. It also documents persistent cartridge SRAM and machine settings in the `openmsx/` folder inside RetroArch's save directory. These are distinct from save states.

Netplay is marked unsupported.

Evidence and publication details

Sources & references

Content responsibility: FrameTinker editorial desk. Source authors and software maintainers are credited separately below; this is not a claim of hands-on testing.

Published .

RetroArch: openmsx — official gaming software documentation https://raw.githubusercontent.com/libretro/docs/master/docs/library/openmsx.mdRetrieved Nov 16, 2026

Something doesn’t match your setup?

Suggest a correction