CHIP-8 Emulator

Ubuntu Installation

1. Clone the Project:

   git clone https://github.com/Abdirazak140/CHIP-8-Emulator.git

2. Create Virtual Environment:

   python3 -m venv myenv
   source myenv/bin/activate

3. Install Requirements:

   pip install -r requirements.txt

Windows Installation

1. Clone the Project:

   git clone https://github.com/Abdirazak140/CHIP-8-Emulator.git

2. Install Requirements:

   pip install -r requirements.txt

Playing Games

1. After successfully setting up the emulator, run the main.py script: Ubuntu:

    sudo python3 main.py

   Windows:

   python main.py

2. You will be presented with a list of available games in the "games" folder. Enter the number of the game you want to play.

3. The selected game will start running on the CHIP-8 emulator.

4. To interact with the game, use the keys specified below:

   • Original CHIP-8 keypad layout:

     1 2 3 C
     4 5 6 D
     7 8 9 E
     A 0 B F
     

   • The keypad layout (you are using) to represent the following chip-8 keys:

     1 2 3 4
     Q W E R
     A S D F
     Z X C V
     

5. Enjoy playing the selected game on your CHIP-8 emulator!

Feel free to explore different games in the "games" folder and have fun with your CHIP-8 emulator! If you encounter any issues or have questions, don't hesitate to reach out for assistance. Happy gaming!