| Next revision | Previous revision |
| emulators:retroarch [2020/12/20 11:49] – created, it's not much right now, but there wasn't any page trying to introduce retroarch and libretro cores fishou | emulators:retroarch [2022/06/21 10:07] (current) – created atari |
|---|
| ====== Retroarch inside batocera ====== | <WRAP group> |
| | <WRAP round box twothirds column> |
| | {{ :emulators:retroarch_logo.png?nolink&500 |Ubiquitous with retro-gaming.}} |
| |
| Retroarch is a front-end for libretro cores, put simply, it basically makes possible to port programs (cores) to it, while making the configuration easier for the end user. | ====== RetroArch ====== |
| |
| It also enables several features in a consistent way, such as hotkey combos, savestates, taking screenshots, recording videos, netplay, and so on. | [[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. |
| |
| ===== List of libretro cores used in batocera ===== | </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. |
| |
| The libretro cores useable in Batocera are the one listed in the [[https://batocera.org/compatibility|compatibility list]] on batocera's website with the word libretro attached to them. | |