Skip to content

danirod/chip8

devel
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
doc
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

CHIP-8 Build Status Coverage Status GitHub tag GitHub license

chip8 is a CHIP-8 emulator developed in C using the SDL2 multimedia library. It emulates a standard CHIP-8 machine and implements all the opcodes that the specification provides.

Usage

To emulate a binary ROM just provide the file as an argument:

$ chip8 ~/roms/TETRIS.bin

You can have more information by reading the software manual. Download as PDF.

Building from sources

In order to compile this project you will need to have SDL 2.0 headers and libraries in your machine. Head to www.libsdl.org to get those in case you still haven't got them or get them using your package manager if your operating system has any.

After installing SDL 2.0 you can download the software distribution and install it via the following commands:

autoreconf --install  # Only if you are using the Git repository
./configure
make
make install
make check  # Optional: to test the emulator -- libcheck is required

Screenshots

GNU/Linux:

CHIP-8 Emulator on GNU/Linux

Apple® MacOS® X:

CHIP-8 Emulator on MacOS X

Microsoft® Windows®:

CHIP-8 Emulator on Windows

License

CHIP-8: A multiplatform CHIP-8 emulator done in SDL
Copyright © 2015-2016 Dani Rodríguez <danirod@outlook.com>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

See COPYING for the entire contents of the license.