Skip to content

tmpstpdwn/CHIP-8

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CHIP-8 Emulator

A simple, functional CHIP-8 emulator written by me as a learning project. It supports most CHIP-8 programs.

⚠️ Note:

  • This is strictly a standard CHIP-8 implementation.
  • This implementation does not support audio output.

Screenshots

Space Invaders

Space Invaders

Lunar Lander

Lunar Lander

Tic Tac Toe

Tic Tac Toe


Dependencies

This emulator uses raylib for rendering. Make sure it's installed before building the project.


How to Run

  1. Clone the repository and build:

    git clone https://github.com/tmpstpdwn/CHIP-8
    cd CHIP-8
    make
  2. Run the emulator with a ROM:

    ./chip8 path/to/rom.ch8
  3. Keyboard controls:

    CHIP-8 uses a 4×4 hexadecimal keypad:

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

    Mapped to your keyboard as:

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

ROMs

You can find public domain CHIP-8 ROMs here.


Resources used

License

MIT License — free to use, modify, and distribute.