librsmsx

Crates.iolibrsmsx
lib.rslibrsmsx
version
sourcesrc
created_at2025-01-24 03:33:58.845467
updated_at2025-02-06 02:48:31.632989
descriptiona MSX emulator written in rust, a port from gomsx
homepage
repositoryhttps://github.com/ghtalpo/librsmsx
max_upload_size
id1528999
Cargo.toml error:TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
ghtalpo (ghtalpo)

documentation

README

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!!!

Commit count: 0

cargo fmt