Home

Awesome

NES Term [+..••]

Terminal frontend for the SimpleNES Emulator, built with TermOx.

<p align="center"> <img src="docs/mario.png"> </p> <p align="center"> <img src="docs/zelda.png"> </p>

Build

Relies on cmake to generate build files for the nes-term target. git submodules are used; run git submodule update --init --recursive after cloning.

Run

The emulator can run a game by specifying the ROM file as the first argument when launching from the terminal.

Root privileges are required for proper keyboard input in the terminal, key release events cannot be accessed without opening the console as a file, which requires root.

From the build directory:

sudo ./src/nes-term ~/location/of/ROM/file

The release build seems to run fine at 60fps; debug will be slow 🐌

The NES has a resolution of 256x240, if your terminal is not expanded to at least this size, the display will be scaled to a lower resolution. It is recommended to make the font size much smaller in order to get the full resolution(ctrl + (plus/minus) changes font size on most terminals).

<p align="center"> <img src="docs/low-res.png"> </p>

Lower resolution scalling.

Sound is not implemented.

Controls

Only Player 1 is implemented. Open an issue if you can think of a good keyboard layout for two players.