Repository files navigation

Term Boy is a Nintendo Game Boy emulator...for your terminal.

This is an early implementation written in Go. A more complete version (writtenin C++) is availablehere.

This project is based on code from an existing Game Boy Color emulator,gomeboycolor.

Be sure to also check outlibtermboy, which distills the techniques used to implement Term Boy into a reusable library (with color support!).

If you're an Arch Linux user, you can download Term Boy from theAUR. After compilation, thebinary will be installed as/usr/bin/termboy.

Users of other distros can download and build Term Boy by runninggo get github.com/dobyrch/termboy-go. Start Term Boy by runningtermboy-go <ROM.gb> in a Linux virtual console.

Use ESDF for the D-pad, G/H for SELECT/START, and J/K for B/A. Press ESC to quit.

Ubuntu users may see the message "Failed to set font height." Term Boy usesthesetfont command to change the font height, which looks for the fontdefault8x16.psfu in/usr/share/consolefonts. The font can be downloaded fromtheKbd project. Download any of thearchives and the font will be located indata/consolefonts.

A branch for FreeBSD is also available (git checkout freebsd). See PORTINGfor more details.

Sound is not yet supported. If you want sound now, try out my otherimplementation.

If you would like to see how I generated a custom boot ROM (that shows "Term Boy"in place of "Nintendo"), seebootrom-gen.

Unlike other video game emulators, Term Boy hasno dependencies on X11 orany graphics libraries. This makes it possible to play high-quality, graphicalgames in a command-line environment. If you're bored of text-based games likeAdventure, give TermBoy a shot!