Guac is an Emulator written in golang for Gameboy, Gameboy Color and Gameboy Advance handheld consoles.
See Releases for Windows and Linux precompiled binaries.
Building from source is possible with golang > 1.24.5, using:
go build .
In both command line and console mode, save files are placed in the same directory as the rom file (ex. "harvest_moon.gba", "harvest_moon.gba.save")
Run the executable with a rom path (gb, gbc, and gba are required extensions) to immediately enter the game.
.\guac -r="../rom/pokemon_emerald.gba"
Run the executable without flags to use console mode, which initalizes a Game Selection Screen.
.\guac
At root, create a "roms.json" file. This file will hold the game metadata in the following format. At this time Art must be 1:1 pngs or jpgs. Watch trailing commas in json, it got me many a times.
[
{
"RomPath": "./rom/gba/the_minish_cap.gba",
"ArtPath": "./art/the_minish_cap.png"
}
...]
Emulator settings can be configured using the config.toml file at root. If you would like to return to the default config.toml file, delete any present config.toml file and run the emulator.
- Keyboard / Controller Input
- Backdrop Color
- Original DMG Gameboy Palette
- Menu Game Density
- Experimental Performance Improvements (HLE Bios, Multithreading etc)
Check the ./emu folder for individual consoles. These consoles will have "testing.md" files showing currently passing tests and tested games.
Please contribute! At this time I am mostly interested in getting game errors fixed. Cycle accuracy, and serial communication are not a priority at this time. At this time, AI contributions will be rejected. For what needs work see "todo.md" pages for each console.