Skip to content

salihefee/chip8-emulator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

here is the readme i made github copilot generate

CHIP-8 Emulator

A simple CHIP-8 emulator written in C++ using the Raylib library for graphics and input handling.

Table of Contents

Description

This project is a CHIP-8 emulator implemented in C++. It uses the Raylib library for rendering graphics and handling input. The emulator can load and run CHIP-8 ROM files, providing a simple way to play classic CHIP-8 games.

Installation

Prerequisites

  • C++11 or higher
  • g++
  • make
  • raylib

Building the Project

  1. Clone the repository:

    git clone https://github.com/salihefee/chip8-emulator.git
    cd chip8-emulator
  2. Compile the project using the provided Makefile:

    make

Usage

  1. Run the emulator with a CHIP-8 ROM file:

    ./build/emulator path/to/romfile
  2. Use the following keys on your keyboard to control the program:

    1 2 3 4
    Q W E R
    A S D F
    Z X C V
    
  3. Press F1 to reload the ROM file.

Contributing

Contributions are welcome! Please follow these steps to contribute:

  1. Fork the repository.
  2. Create a new branch for your feature or bugfix.
  3. Commit your changes.
  4. Push your branch to your forked repository.
  5. Create a pull request with a description of your changes.

License

This project is licensed under the GNU General Public License (GPL). See the LICENSE file for details.

Releases

No releases published

Packages

No packages published