Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
doc/images
lib
misc
perf
spec
.gitignore
.travis.yml
Gemfile
LICENSE.txt
README.md
Rakefile
gbrb.gemspec

README.md

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
  • Support games which use Memory Bank Controllers
  • Sound