mirror of
https://github.com/kaepr/gameboy_emulator.git
synced 2026-03-15 14:17:16 +00:00
Gameboy Emulator in Rust
- Rust 98.9%
- TypeScript 0.6%
- HTML 0.4%
| frontend | ||
| gameboy_emulator | ||
| gameboy_emulator_lib | ||
| images | ||
| .gitignore | ||
| Cargo.lock | ||
| Cargo.toml | ||
| justfile | ||
| layout.kdl | ||
| README.md | ||
Gameboy Emulator
Gameboy emulator, built using Rust for learning purposes.
Run Instructions
# Running ROM
cargo run -- -p "relative path to rom"
# List different cli options
cargo run -- --help
Controls
| Keyboard | Input |
|---|---|
| W | Dpad Up |
| S | Dpad Down |
| A | Dpad Right |
| D | Dpad Left |
| J | A |
| K | B |
| U | Select |
| I | Start |
Images
Dependencies
- rust_minifb Framebuffer for displaying the lcd output and keyboard input
Test roms
Blarrg's test roms can be found at gb-test-roms.
Tasks
- Pass all individual CPU instruction tests
- Add more mappers
- Run using WASM
- Display on browser

