waterfoul/README.md
Colby Swandale 9a1f2456ae added how to run the emulator in README
also fixed a few spelling issues.
2016-05-26 21:43:29 +10:00

1.1 KiB

Waterfoul

Waterfoul is a Gameboy emulator written in Ruby-lang. It is just a casual excersize by myself to learn the internals of the device and how it works.

Requirements

The sdl2 library is currenty used to render pixels. Most platforms have packages avaliable, else see the here. This library is required and needs to be installed before you can run the emulator.

Can it play roms?

No. But a lot of work is being put into making a compatable emulator. The device does run the internal boot program succesfully and is starting to pass test programs sucesfully (barggs).

Testing

If you wish to run the test suite, download the source code (make sure to run bundle install) and run bundle exec rspec

I Want to run it anyway

If you wish to see the emulator in action, download a rom online (it is required even though the game wont run) which typically have a .gb extension and place it onto your local file system.

bundle exec exe/waterfoul start <path to rom>

The boot program will be executed by default, if you wish to skip it add --skip-boot as an option.