fnesemu

A Cross-Platform NES/PCE/MD Emulator Built with Flutter

This project is experimental.

• Achieves 60 fps on an i5-8250 processor @web(NES,PCE), @windows(all)
• Runs on all Flutter-supported platforms: Android, iOS, macOS, Linux, Windows, and Web
• NES (.nes)
  • SRAM backup by shared_preference
  • Supports the following iNES mapper types:
    • 0: NROM, 1: MMC1, 2: UxROM, 3: CNROM, 4: MMC3, 9/10: MMC2/4
    • 73: VRC3, 75: VRC1, 21/23/25: VRC2/4, 24|26: VRC6 (with audio)
    • 19: Namco163 (waveform sound not supported), 88/206: Namco118
• PCE (.pce)
  • Does not support SRAM / CD / SG16
• MD (.gen .md)
  • Does not suppor SRAM / CD / PAL / 32X

How to use

1. Visit the demo site or access the latest version directly
2. Select the file by clicking on the 'Load ROM' icon (a square and small arrow) on the leftmost of the App bar icons
3. Click on the 'Run' icon (a right-directed triangle) to start emulation

Joypad-Keyboard assignment

key	Z	X	C	A	S	Q	W	E	UP	DOWN	LEFT	RIGHT
NES	B	A		select	start				UP	DOWN	LEFT	RIGHT
PCE	II	I		select	run				UP	DOWN	LEFT	RIGHT
MD	A	B	C		start	X	Y	Z	UP	DOWN	LEFT	RIGHT

How to build and run on local machine

To build and run fnesemu on a local machine, you will need flutter 3.22.0 with at least one enabled device. Follow these steps:

git submodule update --init
flutter run -d [windows|linux|chrome|macos|your-android-device|your-ios-device] --release

How to develop

To add more mapper type support

TBD

To test 6502 emulation

The 6502 emulator core used in fnesemu has been validated using the Nestest ROM by comparing register and flag values against the Nestest log.

To test the 6502 emulation, run the following command:

$ curl https://raw.githubusercontent.com/christopherpow/nes-test-roms/master/other/nestest.log > assets/nestest.log
$ curl https://raw.githubusercontent.com/christopherpow/nes-test-roms/master/other/nestest.nes > assets/rom/nestest.nes
$ make test-6502
running fnesemu cpu test...
loading: File: 'assets/rom/nestest.nes'
cpu test completed successfully.

To test z80 emulation

get tests.in and tests.expected from Fuse, store these file to assets

$ make test-z80

To test M68000 emulation

$ cd assets && git clone https://github.com/SingleStepTests/680x0.git
$ cd ..
$ make test-m68