Retroarch overloads

Here is a non-exhaustive list of keys that can be altered in a .retroarch.cfg type overload file, these modifications can only be done if the emulator is a core retroarch.

An * after the value means that the parameter can also be overloaded via a .recalbox.conf

Audio

  • audio_enable = "true" Enable or disable audio

  • audio_volume = "0.000000" Set the volume gain, 0 = default volume by default

Retroarch Menu

  • quick_menu_show_save_content_dir_overrides = "false" Show or hide the Configuration override option for the directory

  • quick_menu_show_save_core_overrides = "false" Show or hide the Configuration override option for the core

  • quick_menu_show_save_game_overrides = "false" Show or hide the option Configuration override for the game

Configuration Overrides are a feature of Retroarch, similar to overloads, but which retain a lot of information, in the context of recalbox, better to prefer overloads if possible

Debug

  • fps_show = "true" Show in-game FPS

  • menu_driver = "ozone" Choose the retroarch menu, ozone base, except on GPi Case, where rgui is used

  • menu_enable_widgets = "true" Enable in-game popups, if set to false, will display notifications as yellow text

Dossiers

  • recording_output_directory = "" Folder where video recordings go

  • savefile_directory = "" Where to save / load saves

  • savestate_directory = "" Where to save / load savestates

  • screenshot_directory = "" Folder where screenshots go

Translation service

  • ai_service_enable = "true" * Enable or disable the translation service

  • ai_service_mode = "0" Translation service mode, 0: image, 1: voice

  • ai_service_source_lang = "0" * Language to read for the translation service, 0 = not specified

  • ai_service_target_lang = "1" * Language to translate into, 1 = English, 3 = French

  • ai_service_url = * Internet link of the service to use

Overlays

  • aspect_ratio_index = "23" * Ratio index, 23 = Custom

  • input_overlay = "" Link to the overlay configuration file

  • input_overlay_enable = "true" Activation of the overlay

  • input_overlay_hide_in_menu = "true" Hide Overlay in Retroarch menu

Coordinates to be defined with the overlay:

  • custom_viewport_height = ""

  • custom_viewport_width = ""

  • custom_viewport_x = ""

  • custom_viewport_y = ""

  • video_message_pos_x = "0.050000"

  • video_message_pos_y = "0.050000"

Netplay

  • netplay_nickname = "" * Pseudo netplay

​

Screen rotation

  • video_rotation = "1" Rotate the video rendering, 0 = normal, 1 = 90 °, 2 = 180 °, 3 = 270 °, pay attention to the aspect ratio

Joystick and Directional Pad

dissociate / associate the Directional Pad to one of the joysticks

  • input_player1_analog_dpad_mode = "0" dissociate

    • = "1" associated with the left joystick

    • = "2" associated with the right joystick

Remapping hotkeys

The settings for changing hotkeys depend on the controller mapping in Recalbox, so if the controller changes, the configuration overloaded with these lines may no longer work.

To have the numerical value for each key on your controller, look in the system/configs/retroarch/retroarchcustom.cfg file for the value of the desired key according to this table:

Hide
Show
Hide

Click on the "Show" tab to show the keys for each key

Show

Key name

Key concerned whose value must be taken

A

input_player1_a_btn

B

input_player1_b_btn

X

input_player1_x_btn

Y

input_player1_y_btn

Up

input_player1_up_btn

Down

input_player1_down_btn

Left

input_player1_left_btn

Right

input_player1_right_btn

Select

input_player1_select_btn

Start

input_player1_start_btn

L

input_player1_l_btn

L2

input_player1_l2_btn

L3

input_player1_l3_btn

R

input_player1_r_btn

R2

input_player1_r2_btn

R3

input_player1_r3_btn

L Axis Up

input_player1_l_y_minus_axis

L axis Down

input_player1_l_y_plus_axis

L Axis Left

input_player1_l_x_minus_axis

L Axis Right

input_player1_l_x_plus_axis

R axis Up

input_player1_r_y_minus_axis

R axis Down

input_player1_r_y_plus_axis

R Axis Left

input_player1_r_x_minus_axis

R axis Right

input_player1_r_x_plus_axis

The modifications to be made to the following values must be made in the overload file.

The previous file is only used to observe the current mapping.

  • input_enable_hotkey_btn = Hotkey key

  • input_screenshot_btn = Key to take a screenshot

  • input_exit_emulator_btn = Key to quit the game

  • input_load_state_btn = Key to load a save state

  • input_save_state_btn = Key to Save state

  • input_menu_toggle_btn = Key to access the Retroarch menu

  • input_reset_btn = Key to restart the game

  • input_ai_service_btn = Key to translate the current screen

For example, The legend of Zelda: Link's Awakening on Game Boy requires to use Start + Select + A + B to save, if your controller does not have a home button, and therefore the hotkey is on Select, natural saving of the game will be impossible, also put the input_enable_hotkey_btn key on the R key of your controller, as a replacement exclusively for this game. If for your controller, the R key, so the value of the input_player1_r_btn key is 4, then you will have to enterinput_enable_hotkey_btn = 4.