Guac is an Emulator written in golang for Gameboy, Gameboy Color, Gameboy Advance, and Nintendo DS handheld consoles.
See Releases for Windows and Linux precompiled binaries.
Building from source is possible with golang > 1.26.0, 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, gba, nds 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
- Menu Game Density
- FPS Control
- DMG Gameboy Palette
- Optimizations (Idle looping, sound clock updated)
- Jit Parameters
- Bios and Firmware Options
- Screen Layout, Sizing and Rotation
- Real Time Clock offset
- 3D Scene Export options
Check the ./emu folder for individual consoles. These consoles will have "testing.md" files showing currently passing tests and tested games.