#gamedev #emulator #port #msx #gomsx

librsmsx

a MSX emulator written in rust, a port from gomsx

10 releases

new 0.2.8 Jan 29, 2025
0.2.7 Jan 27, 2025
0.1.0 Jan 24, 2025

#164 in Game dev

Download history 487/week @ 2025-01-22

487 downloads per month

GPL-2.0-or-later

5MB
18K SLoC

Contains (Windows DLL, 2.5MB) SDL3.dll, (Windows DLL, 1.5MB) SDL2.dll, (static library, 270KB) SDL3.lib, (static library, 185KB) SDL2.lib

rsmsx

a MSX emulator written in rust, a port from gomsx(https://github.com/pnegre/gomsx). Tested for debian linux and windows.

Why?

There's no MSX emulator written in rust and I want to learn more about rust and emulation. It's for the educational purpose and did not targeted for 100% perfect emulator.

How to RUN it

Make sure you have the following libraries installed: - libsdl3 - libsdl3-image - libsdl3-ttf

Bundled with the emulator is the C-BIOS rom file. It provides a free implementation of the BIOS routines of the MSX. No BASIC.

If you want to run BASIC, you can find a MSX1.ROM system file elsewhere.

The file "softwaredb.xml" is useful in aiding the emulator to apply the correct memory mapper for the MSX cartridge games. It's not required, but usually you can't play games without it.

To run it:

$ cargo run --example rsmsx --cart game.rom

Compilation

So, you want to check the source, eh? First, you'll need a rust installation. I recommend rustup.

Next, get the source and the dependencies if necessary:

$ git clone https://github.com/ghtalpo/librsmsx
$ sudo apt install sdl3 libsdl3-dev

And, you just build the program:

$ cd yourworkspace/rsmsx
$ cargo run --example rsmsx --cart game.rom

Happy hacking!!!

Dependencies

~21MB
~389K SLoC