lmmendes / chip8-rb

CHIP-8 Interpreter in Ruby

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Chip8

This is a work in progress.

CHIP-8 is an interpreted programming language, developed by Joseph Weisbecker. It was initially used on the COSMAC VIP and Telmac 1800 8-bit microcomputers in the mid-1970s. CHIP-8 programs are run on a CHIP-8 virtual machine. It was made to allow video games to be more easily programmed for said computers.

Installation

$ gem  install chip8

Usage

$ chip8 game.rom

Disassemble ROM

$ chip8 -d game.rom

0x0C8: [1225] JMP 225
0x0CA: [5350] SKNE V3, V5
0x0CC: [4143] SKNE V1, 67
0x0CE: [4520] SKNE V5, 32
0x0D0: [494E] SKNE V9, 78
0x0D2: [5641] SKNE V6, V4
0x0D4: [4445] SKNE V4, 69
...

Troubleshooting

chip8-rb depends on gosu with SDL 2 library if you see this error:

Gem::Ext::BuildError: ERROR: Failed to build gem native extension.

Follow the Gosu instructions instructions in order to understand how to install gosu and it's dependencies like sdl:

Installation instructions for macOS | Installation instructions for Linux

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/lmmendes/chip8-rb.

License

The gem is available as open source under the terms of the MIT License.

About

CHIP-8 Interpreter in Ruby

License:MIT License


Languages

Language:Ruby 98.1%Language:Shell 1.9%