GBRb

This project is a work in progress and nowhere near complete.

Nintendo Game Boy emulator written in Ruby.

FAQ

How can I get it?

Clone the repository (directions are provided in the right sidebar) for the latest version.

Packaged releases are available through Ruby Gems. Simply type gem install GBRb

How do I run it?

Just point GBRb to the location of your ROM and have fun.

gbrb ~/location/to/my/romfile.gb

How can I contribute?

  1. Select an issue.
  2. Fork this repository.
  3. Create a bugfix branch (git checkout -b my-issue-fix)
  4. Commit your changes (git commit -am "Fixed some bug")
  5. Push the branch (git push origin my-issue-fix)
  6. Create a new Pull Request

Where can I learn about Game Boy emulation?

Nintendo's Game Boy is well documented across the internet and a quick search will turn up many useful results. Or you can save some time and visit the wiki which has links to my research.

Code Status

Build Status  Code Climate  Coverage Status 

Progress

Boot Sequence which displays the Nintendo Logo  Background tiles drawn for Tic-Tac-Toe  Background for OPUS-5 test game discussed in jsGB 

Testing

Basic Character and Graphics Test (TEST.GB)  Blargg CPU Tests 

Roadmap

  • Improve Performance
  • Input
  • Support games which use Memory Bank Controllers
  • Sound