Skip to content

lmmendes/chip8-rb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Releases

No releases published

Packages

No packages published