emulators:retroarch [Batocera.linux

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
<WRAP group>
<WRAP round box twothirds column>
{{ :emulators:retroarch_logo.png?nolink&500 |Ubiquitous with retro-gaming.}}

====== RetroArch ======

[[https://docs.libretro.com/|RetroArch]] (formerly SSNES), is a ubiquitous frontend that can run multiple "cores", which are essentially the emulators themselves. The most common cores use the [[https://www.libretro.com/|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.

</WRAP>
</WRAP>

===== 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. [[:batocera_conf_syntax|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]'' + {{:wiki:south.png?nolink&20|South button (B SNES)}} which can be used to alter various things like RetroArch's basic settings, core options and [[:remapping_controls_per_emulator|per-core controller mapping]].

<WRAP center round tip>
Config overrides and the use of RA options not available in ES yet are explained on [[:advanced_retroarch_settings|the advanced RetroArch configuration page]].
</WRAP>

===== Troubleshooting =====

General troubleshooting can be done at the [[:support|generic support pages]].

libretro offers extensive documentation on their own wiki, refer to [[https://docs.libretro.com/|libretro's documentation]] for the particular core that you are troubleshooting.