Skip to content

Nintendo Entertainment System (NES)

Overview

The Nintendo Entertainment System (NES) application is an emulator for the Nintendo Entertainment System game console.

Sir Ababol by The Mojon Twins

Controls

The emulator supports up to two controllers. The keyboard and gamepad mappings are listed in the tables below.

Keyboard

Keyboard support is only available for controller one.

Name
Keys
Comments
Move
A or
B or
Start
Select The Right Shift Key.
Show Pause Screen

Gamepad

Gamepad support is available for both controllers.

Name
Gamepad
Comments
Move  or 
A or
B or
Start Not available for Xbox and not recommended for iOS (see alternate)

Press the Menu (Start) Button.
Start
(Alternate)
 and  Hold down the Right Trigger and click (press down) on the Right Thumbstick.
Select Not available for Xbox and not recommended for iOS (see alternate)

Press the View (Back) Button.
Select
(Alternate)
 and  Hold down the Right Trigger and click (press down) on the Left Thumbstick.
Show Pause Screen  and  Not available for Xbox and not recommended for iOS (see alternate 3 or 4)

Hold down the Left Trigger and press the Menu (Start) Button.
Show Pause Screen
(Alternate)
 and  Not available for Xbox and not recommended for iOS (see alternate 3 or 4)

Hold down the Left Trigger and press the View (Back) Button.
Show Pause Screen
(Alternate 2)
 and  Not available for Xbox and not recommended for iOS (see alternate 3 or 4)

Hold down the X Button and press the View (Back) Button.
Show Pause Screen
(Alternate 3)
 and  Hold down the Left Trigger and click (press down) on the Left Thumbstick.
Show Pause Screen
(Alternate 4)
 and  Hold down the Left Trigger and click (press down) on the Right Thumbstick.

Battery-backed SRAM

Some NES cartridges include battery-backed SRAM as a means of preserving state between sessions. The NES application supports persisting this SRAM state into the browser's local storage or optionally to cloud-based storage. The SRAM contents will be persisted to storage whenever the pause screen is displayed (or the game is exited). Therefore, the menu should be displayed periodically for games that support battery-backed SRAM to ensure the state is properly persisted.

Feed

This section details how NES application instances can be added to feeds.

Type

The type name for the NES application is fceux.

Note

The alias nes also currently maps to this application. In the future, the nes alias may be mapped to another NES application (different emulator implementation) if it is determined to be a more appropriate default.

Properties

The table below contains the properties that are specific to the NES application. These properties are specified in the props object of a feed item.

Property Type Required Details
pal Boolean No Whether to force PAL video mode for the specified ROM.
rom URL Yes URL to an NES ROM file or a zip file containing a ROM file.
zoomLevel Numeric No A numeric value indicating how much the display image should be zoomed in (0-40).

This property is typically used to hide the black borders that are present on some games.

Example

The following is an example of a complete feed that consists of a single NES application instance (type value of nes). The rom property value is a URL that points to a Dropbox location that contains the excellent homebrew game Blade Buster by Japanese doujin group High Level Challenge.

{
  "title": "NES Feed",
  "longTitle": "Nintendo Entertainment System Example Feed",
  "categories": [
    {
      "title": "NES Games",
      "longTitle": "Nintendo Entertainment System Games",
      "items": [
        {
          "title": "Blade Buster",
          "type": "nes",
          "props": {
            "rom": "https://dl.dropboxusercontent.com/s/qylh6jezs1qzz6u/BladeBuster.nes"
          }
        }
      ]
    }
  ]
}

This example can be tested by adding a feed with the following URL within the webЯcade player:

https://tinyurl.com/sample-nes-feed

References

Back to top