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
487 downloads per month
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