cfxnes

cfxnes (app)

NES emulator running in web browser.

A live demo is at jpikl.github.io/cfxnes.

Building and Running

Before building the application, build the cfxnes library first.

By default, application assumes that it’s deployed at root path /. You can change that by setting BASE_URL=/some/path environment variable before the build.

Application can be build in 2 modes:

1. As a Node.js server.
2. As a static website.

Node.js server

Run npm run build to build the application into the dist/node directory.

Run npm start to start the application at localhost:5000.

Server configuration is loaded from the config.json file. Configuration options can be also passed through environment variables (fooBar configuration option corresponds to FOO_BAR environment variable). Default values are documented in defaults.js.

When the application is started for the first time, it creates roms directory. Add .nes files to this directory to make them available on the library page. For custom thumbnails, add picture with identical name (e.g., game.jpg for game.nes). Supported formats are JPG, PNG and GIF.

Static website

Run npm run build:static to build the application into the dist/static directory.

Run node dist/rom-import.js <dir> to import *.nes files for the library page.

Run npx http-server dist/static to serve the static website at localhost:8080.

Development

npm run <script>	Description
dev	Build and start application in development mode.
dev:server	Build and start server in development mode.
dev:client	Build and start client in development mode.
build	Build application.
build:server	Build server.
build:client	Build client.
build:static	Build application as a static website.
analyze	Record webpack statistics into stats.json file.
start	Start application at localhost:5000.
lint	Run linter.
lint:js	Run linter (JS only).
lint:css	Run linter (CSS only).
test	Run all tests.
clean	Clean all generated files.

Running one of the dev* scripts for the first time will generate webpack.dev.js configuration file that can be used to customize some webpack development parameters.

Troubleshooting

Emulation does not work when running app using npm run dev

This seems to be a Chrome issue. There are two workarounds:

1. Build the cfxnes library first. Then run npm run dev.
2. Comment this.vblankSuppressed = false; line in PPU constructor in PPU.js.

This site is open source. Improve this page.