C++ CHIP-8 emulator

An emulator written in C++ based on Austin Morlans Building a CHIP-8 Emulator
Explore the docs »

Report Bug · Request Feature

Table of Contents

1. Screenshots
2. About The Project
3. Getting Started
4. Roadmap
5. Contributing
6. License
7. Contact
8. Special Thanks

Screenshots

Tetris:

About The Project

I have always been fascinated about emulators, and they are a big reason I got into computers in the first place. I wanted a way to apply my skills as a Computer Engineer, and came to the conclusion to create an emulator. I want to create a gameboy emulator in the future, but for now I started off small with a CHIP-8 emulator instead, only having 34 Opcodes to worry about. I came across Austin Morlan's guide on how to achieve this, and created my first emulator.

Getting Started

Installation

Clone the repo

git clone https://github.com/akash5852/chip8-emulator

Get SDL2, installation varies based on OS.

If using a Linux however, use this command

sudo apt-get install libsdl2-dev

Compile using

g++ -Isrc/Include -Lsrc/lib -o chip8 *.cpp -lSDL2main -lSDL2

Obtain ROMS for CHIP-8 and run ROMS using,

./chip8 10 n x.ch8

With n being the delay in miliseconds, I recommend 3 and x being the ROM name.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License.

Contact

Akash Sharma - shara98@mcmaster.ca

Project Link: https://github.com/akash5852/chip8-emulator

Thank You

Enormous thanks to Austin Morlan's 'Building a CHIP-8 Emulator'!

You can find it here: https://austinmorlan.com/posts/chip8_emulator/