MedNES Save

A cycle-accurate, cross-platform NES emulator written in C++

Project README


MedNES is a cycle-accurate NES emulator written in C++. Supported mappers: NROM(0), MMC1(1), UNROM(2), CNROM(3)

Try it out in your browser here!

Getting Started

These instructions will get you a copy of the project up and running on your local machine.


Cloning This Repository

  1. Open Terminal.
  2. Change the current working directory to the location where you want the cloned directory to be made.
  3. Type git clone
  4. Press Enter. Your local clone will be created.




./MedNES -insert <path/to/rom>


alt text Super Mario Bros alt text Donkey Kong alt text Bomberman II
alt text Pac-Man alt text Mega Man alt text The Legend of Zelda


Here are some projects that build on top of MedNES:

  • nes-memoryview: This project is really interesting. It shows how each byte in the 2kB RAM changes over time. You can associate sprite movements with OAM bytes just by looking at the plots! Also, this is the project that enabled the web port!
  • doogmorning NES emulator: I came across this NES emulator, which added MedNES to its reference list. Go check it out!


This program is free software: you can redistribute it and/or modify it under the terms of the MIT License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the MIT License for more details.

Contributing Code

We'd love to accept your patches! If you have improvements, send us your pull requests!

Open Source Agenda is not affiliated with "MedNES" Project. README Source: wpmed92/MedNES
Open Issues
Last Commit
1 year ago

Open Source Agenda Badge

Open Source Agenda Rating