A GBA emulator frontend powered by teek and libmgba.

A full-featured GBA player with video/audio rendering, keyboard and gamepad input, save states, and a settings UI.

See INSTALL.md for platform-specific dependency setup.

gemba [command] [options]

Run gemba <command> --help for command-specific options.

# Play a ROM (these are equivalent)
gemba game.gba
gemba play game.gba

# Play with options
gemba play --scale 2 --fullscreen game.gba

# Record 10 seconds of gameplay (headless)
gemba record --frames 600 game.gba

# Show recording stats
gemba decode --stats recording.grec

# Encode to video
gemba decode -o clip.mp4 recording.grec

# Replay an input recording
gemba replay session.gir

# Reset config
gemba config --reset

• GBA emulation via libmgba
• SDL2 video rendering with configurable window scale (1x-4x)
• Integer scaling and nearest-neighbor/bilinear pixel filtering
• GBA color correction (Pokefan531 formula) for authentic LCD appearance
• Fullscreen support
• SDL2 audio with volume control and mute
• Keyboard and gamepad input with remappable controls and hotkeys
• Quick save/load and 10-slot save state picker with thumbnails
• Turbo/fast-forward mode
• ROM info viewer
• Persistent user configuration with settings UI

The UI supports multiple languages via YAML-based locale files. The active language is auto-detected from the system environment (LANG) or can be set manually in the config.

Currently supported:

To force a specific language:

Gemba.user_config.locale = 'ja'

Adding a new language: create lib/gemba/locales/<code>.yml following the structure in en.yml.

• Game picker / ROM browser
• GB/GBC support
• ROM patching (IPS/UPS)
• Local multiplayer (link cable emulation)
• RetroAchievements integration
• Solar sensor and tilt/gyro cartridge emulation
• Audio visualizer / channel debug view
• Ruby scripting API

MIT. See THIRD_PARTY_NOTICES for bundled font licenses.