Skip to content

libratechw/Chip8Python

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CHIP-8 Emulator

A simple CHIP-8 emulator in Python, developed as a personal learning project.

Requirements

  • Python 3.x (Tested with Python 3.12.8)
  • NumPy (for CPU registers emulation)
  • Pygame (for display and input handling)

Installation

  1. Clone this repository:
    git clone https://github.com/libratechw/Chip8Python.git
  2. Navigate to the project directory:
    cd Chip8Python
  3. Install the required dependencies:
    pip install -r requirements.txt

Usage

To run the emulator, use the following command:

python main.py <path_to_rom>

Replace <path_to_rom> with the path to the CHIP-8 ROM file you want to run.

You can also specify additional options:

  • --scale: Screen scale factor (default is 10)
  • --clock-speed: CPU clock speed in Hz (default is 500 Hz)

Example:

python main.py roms/pong.ch8 --scale 15 --clock-speed 600

License

MIT License.

Acknowledgements

About

Chip-8 emulator written in Python.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages