⚠️ This project is functionally broken and is kept here for archival purposes. Due to discovered flaws and difficulties implementing features, I will not be providing further updates or fixes. The hassle of Chip8 quirks, it's self-modifying code, and the indirect JumpV0 instruction has killed my vibe.

Turn Chip8 roms into a readable python-style pseudo code or pseudo-assembly.

Pseudo Code:

Data file generated alongside Pseudo code:

Easy to read Assembly option:

The decompiler can detect what opcodes are instructions, and which are sprite or general data. This concept is used in the pseudo decomp and will export the data info to a separate file.

The script takes one argument, the path to the rom. It will then ask for the decomp mode you'll like to use, Input the number corresponding to the mode.

>>python3 run.py rom.ch8

What decomp mode would you like to use?
    1 - pseudo assembly
    2 - pseudo python (full analyzis)
: