Skip to content

aowalke2/iron-boy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Iron Boy

A GameBoy emulator, written in Rust.

In my quest to build a GBA emulator, I made a Game Boy emulator.

Getting Started

Make sure you have the latest version of Rust installed

Mac OS with homebrew

brew install sdl2

Ubuntu

sudo apt update && sudo apt install -y libsdl2

Running

cargo run <rom file path>

  • You can also build a release and run the executable as well

Keymappings

Joypad Keyboard
A X
B Z
Start Space
Select Enter
Up Up Arrow
Down Down Arrow
Left Left Arrow
Right Right Arrow

Tests

Blargg's tests

Test Status
cpu instrs 👍
instr timing 👍

* Other Blargg tests failing or can not test due to not supporting CGB at the moment

DMG Acid test

Test Status
DMG Acid 👍

Acknowledgements and Sources

Awesome Emulators

These are some awesome emulators by some really smart people that helped me get to this point.

About

A Game Boy Emulator written in Rust

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages