RetroArch
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.
RetroArch configuration
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. ( 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] + 
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.
Troubleshooting
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: 22 months ago
- by atari