Home

Awesome

GB Term |+ ;|

Terminal frontend for the GBEmu Gameboy Emulator, built with TermOx.

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

Build

Relies on cmake to generate build files for the gb-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/gb-term ~/location/of/ROM/file

The release build should run fine at 60fps; debug will be slightly slower 🐌

The Gameboy has a resolution of 160x144, 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).

Sound is not implemented.

Controls

Gameboy

Emulator