Skip to content

ToddBodnar/rustboy

Repository files navigation

Rust Boy, a Game Boy emulator in Rust

An sample menu An animation of chatting in pokemon A Tetris screenshot Passing cpu_instrs test

This emulator is capable of running most Game Boy games to some fidelity and implements all official instructions and memory banks.

Building

Run cleanAndMake.sh. You will need a recent (as of July 2022) version of Rust and CMake installed.

Running

The emulator can be run through a simple command cargo run your_rom_here.gb.

Gameboy Button Keyboard Button
A F
B D
Start R
Select E
Up Up
Down Down
Left Left
Right Right

Additionally, screen shots can be created by pressing space.

If supported by the game, a .sav file will be made in the same directory as the rom.

Testing

Unit tests are available in the individual .rs files and can be run simply with cargo test. Additionally, the integrationTests.sh script will run through each of Blagg's Game Boy test roms and compare the output screen to a known good result.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages