guac

guac: NDS, GBA, GBC, DMG Emulator

Guac is an Emulator written in golang for Gameboy, Gameboy Color, Gameboy Advance, and Nintendo DS handheld consoles.

Update Videos

Cycle Accurate GBA (v0.0.4)

UI Update (v0.0.3)

NDS Update (v0.0.2)

Original (v0.0.1)

Features

Emulation out of the box

guac does not require any bios or firmware files (but you can provide!), just the roms you are interested in using. It also has full controller support even in menus.

Accuracy

GBA emulation is highly accurate, having a cycle accurate cpu, and other subsystems. Real-Time Clocks, Solar Sensors and more are properly emulated as well.

Performance

Nintendo DS emulation on guac comes with a one-of-a-kind jit compiler. This allows cpu emulation to be 2-5x faster depending on workloads. This is the first jit compiler that can interop with (more like confuse) the golang runtime to allow calls to go functions from jit code. Additionally, this is the first ever arm64 jit compiler written in golang. For more information please see gojit.

Customizable

guac comes with a TON of customizable options. The ui has customizable colors, hotkeys, and localization in english or spanish. All consoles have customizable inputs. Nintendo DS has customizable screen layouts, Real-Time Clock, and Firmware.

3D Export

guac comes with a 3D Scene Export, allowing the current 3d scene to be exported as a .obj file. This allow the 3D scene to be imported into 3D software such as Blender, Maya etc for debugging, artistic expression and more.

Getting Started

See Releases for Windows and Linux precompiled binaries. Run the executable without any flags or configuration.

.\guac

If you are interested in specific flags and configuration options please see guacemulator.com.

Building

Building from source is possible with golang > 1.26.5, using:

go build .

For specific system build quirks please see guacemulator.com.