nes_test 0.2.0

This is an example application for

To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:


This is an example application for



For a pre-built package

For Windows there are stand-alone binary builds available at the GitHub release page. Note: the 32-bit (x86) version was compiled with DMD so it's not very optimized.

Fetching with Dub

  dub fetch nes_test

To run:

  dub run nes_test --build=release -- <rom>

Or for a 64-bit version:

  dub run nes_test --arch=x86_64 --build=release -- <rom>


Building from source

Clone or download this repo, cd to the folder that contains the source folder & run:

  dub build --build=release

Or for a 64-bit version:

  dub build --arch=x86_64 --build=release


If you're on Windows I'd also add --arch=x86_mscoff when using dub run or build to create 32-bit versions. The linker produces a very slow executable otherwise.

The app expects the SDL2 runtime binaries (minimum version 2.0.5) to be available. You can find them here:


  nes_test <rom>
  Use nes_test -h for more options.

The app will create a save & state folder in its current directory on first run if they don't already exist. Battery backed RAM is saved only on program exit.


Joysticks are supported, although the button mapping is currently hard-coded. Keyboard controls are indicated below.

Up, Down, Left, RightArrow Keys or WSAD
SelectRight Shift or Space
AZ or N
BX or M
Fullscreen/Windowed ToggleF11
Exit FullscreenEscape
ResetCtrl + R
Save StateF5
Load StateF1
  • Blahness
nes, derelict-sdl2
0.2.0 2018-Oct-30
0.1.2 2018-Feb-04
0.1.1 2018-Feb-02
0.1.0 2018-Feb-02
~master 2018-Oct-30
Show all 5 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 0 downloads this month

  • 28 downloads total

Short URL: