Skip to content

agi90/gb-rust

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gb-rust

Yet another DMG (Game Boy) emulator.

Written mostly for fun, it's not intended for general use.

Run

$ cargo build --release
$ cargo run --release -- rom.gb

Command Line options

  • -d --debug Will start the debugger immediately
  • -m --magnification Allows changing the magnification of the emulated screen.

Features

  • MBC0, MBC1, MBC3 support.
  • Works on Linux and Windows (didn't test OSX).
  • Experimental sound support.

Commands

  • F1 breaks execution and enters the debugger
  • F2 toggle between normal speed and unlimited frame rate
  • Arrow keys control up/left/right/down
  • A controls gameboy button A
  • S controls gameboy button B
  • D controls gameboy button Start
  • F controls gameboy button Select
  • h will print a list of commands for the debugger while in debugging mode

This project is released under the MIT license.

Tests

Blargg tests:

cpu_instr_passed instr_timing_passed mem_timing_passed mem_timing2_passed screenshot_priority_passed halt_bug_failed interrupt_time_failed dmg_sound_failed_7

Todo

  • oam_bug (crashes)

Screenshots

Pokemon Red/Blue

pokemon-title pokemon-in-game pokemon-menu

Tetris

video

tetris-1 tetris-2 tetris-3

Prehistorik Man

prehistorik

About

Yet another DMG (Game Boy) emulator.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages