Yet another NES emulator, written just for fun :)

Cross-platform (Linux, MacOS, Windows) and with online multiplayer support!

Install SDL2 and SDL2_ttf and build using cmake:

$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release ../src
$ make

To enable the Debug "GameView" (showing CPU/PPU state info and enabling single-step mode), use:

-DENABLE_DEBUG_GW=on

Tested on MacOS and Ubuntu.

Install MinGW.

Download SDL2 and SDL2_ttf for MinGW and copy the content of both folders (merging them) in /path/to/MinGW/SDL2.

Run:

$ mkdir build_win
$ cmake -DWIN=on -DWIN_SDL2=/path/to/MinGW/SDL2/x86_64-w64-mingw32/ -DCMAKE_BUILD_TYPE=Release ../src
$ make

From the build directory:

$ ./borznes /path/to/rom

beware that it expects "courier.ttf" in the pwd (yeah, it's ugly).

On Machine 1:

$ ./borznes_multi /path/to/rom

The program will wait for a connection on port 54000.

On Machine 2:

$ ./borznes_multi /path/to/rom 10.0.0.1

where 10.0.0.1 is the IP of Machine 1.

The (default) keymappings for Player1 are the following:

keymappings can be changed using the tool "define_keys"

• NROM(000)
• MMC1(001)
• UNROM(002)
• CNROM(003)
• MMC3(004)
• MMC5(005) partial support
• AxROM(007)
• MMC2(009)
• MMC4(010)
• Camerica(071)
• FC-001(163)

• Check that P1 and P2 are running the same ROM (P1 should send an hash of its ROM)
• Support state saving in multiplayer (it should be easy, P1 should send a state to P2 via socket)
• More mappers

• Highly inspired by https://github.com/fogleman/nes
• Series on developing a NES emulator in C++ by "javidx9" (OneLoneCoder): https://www.youtube.com/playlist?list=PLrOv9FMX8xJHqMvSGB_9G9nZZ_4IgteYf
• Series on developing a NES emulator in C++ by "Systems with JT": https://www.youtube.com/playlist?list=PLP2yfE2-FXdQBRpnZbcObTe33-eSeSRYl
• NesDEV wiki: https://www.nesdev.org/wiki/Nesdev_Wiki
• Accurate description of most mappers: https://www.romhacking.net/documents/362/