Ubiquitous with retro-gaming.


RetroArch (formerly SSNES), is a ubiquitous frontend that can run multiple “cores”, which are essentially the emulators themselves. The most common cores use the libretro API, so that's why cores run in RetroArch in Batocera are referred to as “libretro: (core name)”. RetroArch aims to unify the feature set of all libretro cores and offer a universal, familiar interface independent of platform.

Most RetroArch related settings can be altered from Batocera's EmulationStation, either in the SYSTEM SETTINGS or the GAME SETTINGS (either globally or on a per-system basis).

Standardized features available to all libretro cores: global.videomode, global.videomode, global.ratio, global.shaderset, global.smooth, global.integerscale, global.bezel, global.bezel_stretch, global.hud, global.hud_corner, global.bezel.tattoo, global.bezel.tattoo_corner, global.bezel.tattoo_file, global.bezel.resize_tattoo, global.ai_service_enabled, global.ai_target_lang, global.ai_service_url, global.ai_service_pause, global.runahead, global.secondinstance, global.video_frame_delay_auto, global.vrr_runloop_enable, global.video_threaded

These options can all be specified to apply to only a specific system by replacing global with the shortname of the system. Read more here.

ES setting name batocera.conf_key Description ⇒ ES option key_value
Settings that apply to all cores of this emulator
GRAPHICS API global.gfxbackend Choose which graphics API library to use. In general, Vulkan is the preferred (and more performant) API, but certain hardware may favor OpenGL more. Vulkan may not work for every core/hardware configuration. GLcore is a newer version of OpenGL, but doesn't have as much coverage as OpenGL.
⇒ OpenGL gl, GLCore glcore, Vulkan vulkan.
AUDIO LATENCY global.audio_latency In milliseconds. Increasing this can reduce crackling/cutting out, at the cost of delayed audio.
⇒ 256 256, 192 192, 128 128, 64 64, 32 32, 16 16, 8 8.
ALLOW ROTATION global.video_allow_rotate Allow cores to set rotation. (FIXME What? Why is this an option?)
⇒ On true, Off false.
CONTROLLER TO LIGHT GUN psx.lightgun_map Map controller inputs to light gun inputs.
⇒ On true, Off false.

RetroArch offers a Quick Menu accessed by pressing [HOTKEY] + South button (B SNES) which can be used to alter various things like RetroArch's basic settings, core options and per-core controller mapping.

Config overrides and the use of RA options not available in ES yet are explained on the advanced RetroArch configuration page.

General troubleshooting can be done at the generic support pages.

libretro offers extensive documentation on their own wiki, refer to libretro's documentation for the particular core that you are troubleshooting.

  • emulators/retroarch.txt
  • Last modified: 9 months ago
  • by atari