Nes system in cython with joystick support. Tested on Windows 10 and Linux Ubuntu I don't see why it wouldn't work on macOS. This project was heavily inspired from javidx9 (https://www.youtube.com/@javidx9) so huge thanks to him.

I recommended you set this up in an anaconda enviorment. You can download it from here: https://www.anaconda.com/download. After downlaoding open an anaconda prompt and type:

conda create --name cy_NES_EMU_env python=3.9

Run through the setup procedure as prompted. Once complete enter

conda activate cy_NES_EMU_env

Navigate to the module directory

cd path/to/module/cy_NES_Emulator

Inside is a requirements file, install it as follows

pip install -r requirements.txt

Lastly, run the command

python setup.py build_ext --inplace

To compile the code.

All done! The module behaves exactly like any other python module.

To use cy_NES_Emulator from the command line simply open the command line in the same directory as the cy_NES_Emulator folder and type the following

python cy_NES_Emulator

You will be prompted to choose the location of your rom file. You may also specity a path directly using

python cy_NES_Emulator -run "Super Mario Bros (E).nes"

Simply import as follows

from cy_NES_Emulator import NES

followed by these two lines

nes = NES("Super Mario Bros (E).nes")
nes.run()

The emulator has keyboard and joystick support. If you plug in another controller you can probably guess what the mapping will be.