CHIP-8 emulator

An implementation of a CHIP-8 emulator in Python.

Demo

Running the project

Linux

1. Create a virtual environment.

python -m venv .venv

2. Activate a virtual environment.

source .venv/bin/activate

3. Install the Pygame library.

pip install pygame

4. Or install dependencies from the requirements file; this will include dev dependencies also.

pip install -r requirements.txt

5. Run the emulator.

python main.py /path/to/your/rom

e.g.

python main.py ./ROMs/1-chip8-logo.ch8

Windows

1. Create a virtual environment.

python -m venv .venv

2. Activate a virtual environment.

.venv\Scripts\activate

After creating a virtual environment and activating it, you should install the Pygame library or all dependencies from the requirements file (steps 3. and 4).

Find more ROMs

You can find more ROMs here, or by simply googling "chip8 roms".