summaryrefslogtreecommitdiffstats
path: root/games/vbam/README
blob: 940fe37e79716f7cea1e1c7680164212e1a65b14 (plain)
vbam (cross-platform gameboy/gbc/gba emulator)

VisualBoyAdvance-M is a Nintendo Game Boy Advance Emulator with high
compatibility with commercial games. It emulates the Nintendo Game Boy
Advance hand held console, in addition to the original Game Boy hand
held systems and its Super and Color variants. VBA-M is a continued
development of the now inactive VisualBoy Advance project, with many
improvements from various developments of VBA.

The main executable is /usr/games/vbam, which is a command-line app
with no GUI controls.

Optional dependencies:

wxGTK3 - highly recommended, autodetected (can be disabled via
WX=no). This gives you a /usr/games/visualboyadvance-m executable that
has a modern graphical user interface, plus desktop integration.

SFML - autodetected (can be disabled via SFML=no). Only required for
emulating the GBA Link cable.

lirc - autodetected (can be disabled via LIRC=no). Allows using an
IR remote control to control the emulator. Only works with the SDL
user interface (the vbam executable). Untested by the SlackBuild
maintainer, as I don't own any lirc-compatible hardware.

Notes:

The config file (vbam.ini) is shared between the visualboyadvance-m
and vbam executables, and lives in ~/.config/visualboyadvance-m/
(mentioned here because the man pages don't document this). When
upgrading versions, you might have to delete the config file if vbam
and/or visualboyadvance-m crash or act weird.

There are a couple of alternatives on SBo you might try instead of
this vbam SlackBuild: mgba and/or higan.