Terminal frontend for the SimpleNES Emulator, built with TermOx.
Relies on cmake to generate build files for the nes-term
target. git
submodules are used; run git submodule update --init --recursive
after cloning.
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).
Lower resolution scalling.
Sound is not implemented.
Only Player 1 is implemented. Open an issue if you can think of a good keyboard layout for two players.
- D-Pad: Arrows keys
- A Button: z
- B Button: x
- Start: Enter
- Select: Backspace