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.
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, 2026Something doesn’t match your setup?
Suggest a correction
