This page lists every configuration key of RetroArch 1.22.2, the version shipped with Recalbox 10. It is generated from the RetroArch sources rather than copied by hand: all 799 keys are here, with their type and default value.
It is a reference. For everyday use — which keys actually matter, how to name the file, which folder it applies to — start with RetroArch overrides.
A key marked ✱ is written by Recalbox every time a game starts, from your settings in the menus. Those are exactly the ones to override in a
.retroarch.cfgif you want to neutralise them: your override is applied last and wins. The others are left untouched — RetroArch uses its default, and you are free to change it.
Put the key and its value in an override file, one per line, as key = "value":
video_smooth = "false"
audio_volume = "-6.0"
The file applies according to where you put it — the whole roms folder, one system, or a single game. See Configuration override for the exact naming.
These keys only affect Libretro emulators (run inside RetroArch). Standalone emulators — PCSX2, Dolphin, PPSSPP… — have their own configuration.
Types: bool is "true" or "false", uint and int are whole numbers, float a decimal number, path a file path, array a string. A default shown as — means empty, or decided at startup.
Resolution, filters, vsync, rotation, scaling. 99 keys, 15 of them driven by Recalbox.
video_*10 keys starting with video_.
| Key | Type | Default |
|---|---|---|
video_driver ✱ |
array | — |
video_filter |
path | — |
video_fullscreen ✱ |
bool | false |
video_rotation |
uint | ORIENTATION_NORMAL |
video_scale |
uint | 3 |
video_smooth ✱ |
bool | false |
video_threaded ✱ |
bool | false |
video_vfilter |
bool | true |
video_viwidth |
uint | 640 |
video_vsync |
bool | true |
video_window_*8 keys starting with video_window_.
| Key | Type | Default |
|---|---|---|
video_window_auto_height_max |
uint | 1080 |
video_window_auto_width_max |
uint | 1920 |
video_window_custom_size_enable |
bool | false |
video_window_offset_x |
int | 0 |
video_window_offset_y |
int | 0 |
video_window_opacity |
uint | 100 |
video_window_save_positions |
bool | false |
video_window_show_decorations |
bool | true |
video_hdr_*5 keys starting with video_hdr_.
| Key | Type | Default |
|---|---|---|
video_hdr_display_contrast |
float | 5.0f |
video_hdr_enable |
bool | false |
video_hdr_expand_gamut |
bool | true |
video_hdr_max_nits |
float | 1000.0f |
video_hdr_paper_white_nits |
float | 200.0f |
video_msg_*5 keys starting with video_msg_.
| Key | Type | Default |
|---|---|---|
video_msg_bgcolor_blue |
uint | 0 |
video_msg_bgcolor_enable |
bool | false |
video_msg_bgcolor_green |
uint | 0 |
video_msg_bgcolor_opacity |
float | 1.0f |
video_msg_bgcolor_red |
uint | 0 |
video_stream_*5 keys starting with video_stream_.
| Key | Type | Default |
|---|---|---|
video_stream_config |
path | — |
video_stream_port |
uint | RARCH_STREAM_DEFAULT_PORT |
video_stream_quality |
uint | — |
video_stream_scale_factor |
uint | 1 |
video_stream_url |
path | — |
video_windowed_*5 keys starting with video_windowed_.
| Key | Type | Default |
|---|---|---|
video_windowed_fullscreen |
bool | true |
video_windowed_position_height |
uint | 720 |
video_windowed_position_width |
uint | 1280 |
video_windowed_position_x |
uint | 0 |
video_windowed_position_y |
uint | 0 |
video_dingux_*4 keys starting with video_dingux_.
| Key | Type | Default |
|---|---|---|
video_dingux_ipu_filter_type |
uint | DINGUX_IPU_FILTER_BICUBIC |
video_dingux_ipu_keep_aspect |
bool | true |
video_dingux_refresh_rate |
uint | DINGUX_REFRESH_RATE_60HZ |
video_dingux_rs90_softfilter_type |
uint | DINGUX_RS90_SOFTFILTER_POINT |
video_fullscreen_*4 keys starting with video_fullscreen_.
| Key | Type | Default |
|---|---|---|
video_fullscreen_x ✱ |
uint | — |
video_fullscreen_x ✱ |
uint | 0 |
video_fullscreen_y ✱ |
uint | — |
video_fullscreen_y ✱ |
uint | 0 |
video_record_*4 keys starting with video_record_.
| Key | Type | Default |
|---|---|---|
video_record_config |
path | — |
video_record_quality |
uint | — |
video_record_scale_factor |
uint | 1 |
video_record_threads |
uint | 2 |
video_viewport_*4 keys starting with video_viewport_.
| Key | Type | Default |
|---|---|---|
video_viewport_bias_portrait_x |
float | 0.5 |
video_viewport_bias_portrait_y |
float | 0.0 |
video_viewport_bias_x |
float | 0.5 |
video_viewport_bias_y |
float | 0.5 |
| Key | Type | Default |
|---|---|---|
video_3ds_display_mode |
uint | CTR_VIDEO_MODE_3D |
video_3ds_lcd_bottom |
bool | true |
video_adaptive_vsync |
bool | false |
video_allow_rotate ✱ |
bool | true |
video_aspect_ratio |
float | 1.3333f |
video_aspect_ratio_auto ✱ |
bool | false |
video_autoswitch_pal_threshold |
float | 54.50f |
video_autoswitch_refresh_rate |
uint | — |
video_bfi_dark_frames |
uint | 1 |
video_black_frame_insertion |
uint | 0 |
video_context_driver |
array | — |
video_crop_overscan |
bool | true |
video_ctx_scaling |
bool | false |
video_disable_composition |
bool | false |
video_filter_dir |
path | — |
video_font_enable |
bool | true |
video_font_path |
path | — |
video_font_size ✱ |
float | 32 |
video_force_aspect |
bool | true |
video_force_srgb_disable |
bool | false |
video_frame_delay |
uint | 0 |
video_frame_delay_auto ✱ |
bool | false |
video_gpu_record |
bool | false |
video_gpu_screenshot |
bool | true |
video_hard_sync ✱ |
bool | false |
video_hard_sync_frames |
uint | 0 |
video_max_frame_latency |
int | 1 |
video_max_swapchain_images ✱ |
uint | 3 |
video_message_pos_x |
float | 0.05f |
video_message_pos_y |
float | 0.05f |
video_monitor_index |
uint | 0 |
video_notch_write_over_enable |
bool | false |
video_overscan_correction_bottom |
uint | 0 |
video_overscan_correction_top |
uint | 0 |
video_post_filter_record |
bool | false |
| Key | Type | Default |
|---|---|---|
video_refresh_rate |
float | — |
video_scale_integer ✱ |
bool | false |
video_scale_integer_axis |
uint | 0 |
video_scale_integer_scaling |
uint | 0 |
video_scan_subframes |
bool | false |
video_shared_context |
bool | false |
video_swap_interval |
uint | 1 |
video_use_metal_arg_buffers |
bool | — |
video_waitable_swapchains |
bool | true |
video_wiiu_prefer_drc |
bool | false |
Loading and tuning shaders. 10 keys, 2 of them driven by Recalbox.
| Key | Type | Default |
|---|---|---|
auto_shaders_enable |
bool | true |
menu_shader_pipeline |
uint | 2 |
quick_menu_show_shaders |
bool | true |
video_shader_delay |
uint | 0 |
video_shader_dir ✱ |
path | — |
video_shader_enable ✱ |
bool | false |
video_shader_preset_save_reference_enable |
bool | true |
video_shader_remember_last_dir |
bool | false |
video_shader_subframes |
uint | 1 |
video_shader_watch_files |
bool | false |
Resolution switching for tube displays. 11 keys, 3 of them driven by Recalbox.
| Key | Type | Default |
|---|---|---|
crt_switch_center_adjust |
int | 0 |
crt_switch_hires_menu |
bool | false |
crt_switch_porch_adjust |
int | 0 |
crt_switch_resolution ✱ |
uint | CRT_SWITCH_NONE |
crt_switch_resolution_no_interlaced ✱ |
uint | 0 |
crt_switch_resolution_super ✱ |
uint | 2560 |
crt_switch_resolution_use_custom_refresh_rate |
bool | false |
crt_switch_tate_integer_scale |
bool | false |
crt_switch_timings |
array | — |
crt_switch_vertical_adjust |
int | 0 |
crt_video_refresh_rate |
float | — |
Sound output, volume, resampling, audio latency, microphone. 46 keys, 4 of them driven by Recalbox.
audio_*7 keys starting with audio_.
| Key | Type | Default |
|---|---|---|
audio_device |
array | — |
audio_driver |
array | — |
audio_enable |
bool | true |
audio_latency ✱ |
uint | 0 /* TODO */ |
audio_resampler |
array | — |
audio_sync |
bool | true |
audio_volume ✱ |
float | 0.0f |
audio_enable_*6 keys starting with audio_enable_.
| Key | Type | Default |
|---|---|---|
audio_enable_menu |
bool | false |
audio_enable_menu_bgm |
bool | false |
audio_enable_menu_cancel |
bool | false |
audio_enable_menu_notice |
bool | false |
audio_enable_menu_ok |
bool | false |
audio_enable_menu_scroll |
bool | false |
microphone_*6 keys starting with microphone_.
| Key | Type | Default |
|---|---|---|
microphone_device |
array | — |
microphone_driver |
array | — |
microphone_enable |
bool | true |
microphone_latency |
uint | 0 /* TODO */ |
microphone_rate |
uint | 48000 |
microphone_resampler |
array | — |
midi_*4 keys starting with midi_.
| Key | Type | Default |
|---|---|---|
midi_driver |
array | — |
midi_input |
array | OFF |
midi_output |
array | OFF |
midi_volume |
uint | 100 |
| Key | Type | Default |
|---|---|---|
audio_block_frames |
uint | 0 |
audio_dsp_plugin |
path | — |
audio_fastforward_mute |
bool | false |
audio_fastforward_speedup |
bool | false |
audio_filter_dir |
path | — |
audio_max_timing_skew |
float | 0.05f |
audio_mixer_mute_enable |
bool | false |
audio_mixer_volume |
float | 0.0f |
audio_mute_enable |
bool | false |
audio_out_rate |
uint | 48000 |
audio_rate_control ✱ |
bool | false |
audio_rate_control_delta ✱ |
float | 0.005f |
audio_resampler_quality |
uint | RESAMPLER_QUALITY_NORMAL |
audio_respect_silent_mode |
bool | true |
audio_rewind_mute |
bool | false |
audio_wasapi_exclusive_mode |
bool | false |
audio_wasapi_float_format |
bool | false |
audio_wasapi_sh_buffer_length |
uint | 0 |
microphone_block_frames |
uint | 0 |
microphone_resampler_quality |
uint | RESAMPLER_QUALITY_NORMAL |
microphone_wasapi_exclusive_mode |
bool | false |
microphone_wasapi_float_format |
bool | false |
microphone_wasapi_sh_buffer_length |
uint | 0 |
Run-ahead, frame delay, fast-forward, slow motion, rewind. 15 keys, 5 of them driven by Recalbox.
| Key | Type | Default |
|---|---|---|
fastforward_frameskip |
bool | true |
fastforward_ratio |
float | 0.0f |
frame_time_counter_reset_after_fastforwarding |
bool | false |
frame_time_counter_reset_after_load_state |
bool | false |
frame_time_counter_reset_after_save_state |
bool | false |
preemptive_frames_enable ✱ |
bool | false |
rewind_buffer_size |
size | — |
rewind_buffer_size_step |
uint | 10 |
rewind_enable ✱ |
bool | false |
rewind_granularity |
uint | 1 |
run_ahead_enabled ✱ |
bool | false |
run_ahead_frames ✱ |
uint | 1 |
run_ahead_hide_warnings |
bool | false |
run_ahead_secondary_instance ✱ |
bool | true |
slowmotion_ratio |
float | 3.0f |
Mapping, ports, hotkeys, sensitivity, input drivers. 46 keys, 3 of them driven by Recalbox.
input_turbo_*7 keys starting with input_turbo_.
| Key | Type | Default |
|---|---|---|
input_turbo_allow_dpad |
bool | false |
input_turbo_bind |
int | -1 |
input_turbo_button |
uint | RETRO_DEVICE_ID_JOYPAD_B |
input_turbo_duty_cycle |
uint | 0 |
input_turbo_enable |
bool | true |
input_turbo_mode |
uint | 0 |
input_turbo_period |
uint | 6 |
input_touch_*6 keys starting with input_touch_.
| Key | Type | Default |
|---|---|---|
input_touch_scale |
uint | 1 |
input_touch_vmouse_gesture |
bool | true |
input_touch_vmouse_mouse |
bool | true |
input_touch_vmouse_pointer |
bool | true |
input_touch_vmouse_touchpad |
bool | true |
input_touch_vmouse_trackball |
bool | false |
| Key | Type | Default |
|---|---|---|
input_analog_deadzone |
float | 0.0f |
input_analog_sensitivity |
float | 1.0f |
input_android_physical_keyboard |
array | — |
input_auto_game_focus |
uint | AUTO_GAME_FOCUS_OFF |
input_auto_mouse_grab |
bool | false |
input_autodetect_enable ✱ |
bool | true |
input_axis_threshold |
float | 0.5f |
input_backtouch_enable |
bool | false |
input_backtouch_toggle |
bool | false |
input_bind_hold |
uint | 0 |
input_bind_timeout |
uint | 3 |
input_block_timeout |
uint | 0 |
input_descriptor_hide_unbound |
bool | false |
input_descriptor_label_show |
bool | true |
input_driver |
array | — |
input_hotkey_block_delay |
uint | 5 |
input_hotkey_device_merge |
bool | false |
input_hotkey_follows_player1 |
bool | false |
input_joypad_driver ✱ |
array | — |
input_keyboard_layout |
array | — |
input_max_users ✱ |
uint | 8 |
input_menu_toggle_gamepad_combo |
uint | INPUT_COMBO_NONE |
input_mouse_scale |
uint | 1 |
input_nowinkey_enable |
bool | false |
input_poll_type_behavior |
uint | 2 |
input_quit_gamepad_combo |
uint | INPUT_COMBO_NONE |
input_remap_binds_enable |
bool | true |
input_remap_sort_by_controller_enable |
bool | false |
input_remapping_directory |
path | — |
input_rumble_gain |
uint | 100 |
input_sensor_accelerometer_sensitivity |
float | 1.0f |
input_sensor_gyroscope_sensitivity |
float | 1.0f |
input_sensors_enable |
bool | true |
Artwork laid over the game image. 47 keys, 3 of them driven by Recalbox.
input_overlay_*40 keys starting with input_overlay_.
| Key | Type | Default |
|---|---|---|
input_overlay_abxy_diagonal_sensitivity |
uint | 50 |
input_overlay_analog_recenter_zone |
uint | 0 |
input_overlay_aspect_adjust_landscape |
float | 0.0f |
input_overlay_aspect_adjust_portrait |
float | 0.0f |
input_overlay_auto_rotate ✱ |
bool | false |
input_overlay_auto_scale |
bool | false |
input_overlay_behind_menu |
bool | false |
input_overlay_dpad_diagonal_sensitivity |
uint | 80 |
input_overlay_enable ✱ |
bool | — |
input_overlay_enable_autopreferred |
bool | false |
input_overlay_hide_in_menu |
bool | true |
input_overlay_hide_when_gamepad_connected |
bool | false |
input_overlay_lightgun_allow_offscreen |
bool | true |
input_overlay_lightgun_four_touch_input |
uint | 0 |
input_overlay_lightgun_port |
int | -1 |
input_overlay_lightgun_three_touch_input |
uint | 0 |
input_overlay_lightgun_trigger_delay |
uint | 1 |
input_overlay_lightgun_trigger_on_touch |
bool | true |
input_overlay_lightgun_two_touch_input |
uint | 0 |
input_overlay_mouse_dtap_msec |
uint | 200 |
input_overlay_mouse_dtap_to_drag |
bool | false |
input_overlay_mouse_hold_msec |
uint | 200 |
input_overlay_mouse_hold_to_drag |
bool | true |
input_overlay_mouse_speed |
float | 1.0f |
input_overlay_mouse_swipe_threshold |
float | 1.0f |
input_overlay_opacity |
float | 0.7f |
input_overlay_pointer_enable |
bool | false |
input_overlay_scale_landscape |
float | 1.0f |
input_overlay_scale_portrait |
float | 1.0f |
input_overlay_show_inputs |
uint | OVERLAY_SHOW_INPUT_PHYSICAL |
input_overlay_show_inputs_port |
uint | 0 |
input_overlay_show_mouse_cursor |
bool | false |
input_overlay_x_offset_landscape |
float | 0.0f |
input_overlay_x_offset_portrait |
float | 0.0f |
input_overlay_x_separation_landscape |
float | 0.0f |
input_overlay_x_separation_portrait |
float | 0.0f |
input_overlay_y_offset_landscape |
float | 0.0f |
input_overlay_y_offset_portrait |
float | 0.0f |
input_overlay_y_separation_landscape |
float | 0.0f |
input_overlay_y_separation_portrait |
float | 0.0f |
| Key | Type | Default |
|---|---|---|
input_osk_overlay |
path | — |
input_osk_overlay_auto_scale |
bool | false |
input_osk_overlay_opacity |
float | 0.7f |
input_overlay ✱ |
path | — |
menu_show_overlays |
bool | true |
osk_overlay_directory |
path | — |
overlay_directory |
path | — |
Save files, save states, screenshots. 12 keys, 5 of them driven by Recalbox.
| Key | Type | Default |
|---|---|---|
autosave_interval |
uint | 0 |
block_sram_overwrite |
bool | false |
save_file_compression |
bool | false |
savefile_directory ✱ |
path | — |
savefiles_in_content_dir |
bool | false |
savestate_auto_index |
bool | false |
savestate_auto_load ✱ |
bool | false |
savestate_auto_save ✱ |
bool | false |
savestate_directory ✱ |
path | — |
savestate_file_compression |
bool | true |
savestate_max_keep |
uint | 0 |
savestate_thumbnail_enable ✱ |
bool | false |
Login and achievement behaviour. 28 keys, 6 of them driven by Recalbox.
| Key | Type | Default |
|---|---|---|
cheevos_appearance_anchor |
uint | 0 |
cheevos_appearance_padding_auto |
bool | true |
cheevos_appearance_padding_h |
float | 0.0f |
cheevos_appearance_padding_v |
float | 0.0f |
cheevos_auto_screenshot |
bool | false |
cheevos_badges_enable |
bool | false |
cheevos_challenge_indicators |
bool | true |
cheevos_custom_host |
array | — |
cheevos_enable ✱ |
bool | false |
cheevos_hardcore_mode_enable ✱ |
bool | true |
cheevos_leaderboards_enable |
array | — |
cheevos_password ✱ |
array | — |
cheevos_richpresence_enable |
bool | true |
cheevos_start_active ✱ |
bool | false |
cheevos_test_unofficial |
bool | false |
cheevos_token |
array | — |
cheevos_unlock_sound_enable ✱ |
bool | false |
cheevos_username ✱ |
array | — |
cheevos_verbose_enable |
bool | true |
cheevos_visibility_account |
bool | true |
cheevos_visibility_lboard_cancel |
bool | true |
cheevos_visibility_lboard_start |
bool | true |
cheevos_visibility_lboard_submit |
bool | true |
cheevos_visibility_lboard_trackers |
bool | true |
cheevos_visibility_mastery |
bool | true |
cheevos_visibility_progress_tracker |
bool | true |
cheevos_visibility_summary |
uint | 1 |
cheevos_visibility_unlock |
bool | true |
Hosting, connecting, relays, spectators. 44 keys, 5 of them driven by Recalbox.
netplay_request_*16 keys starting with netplay_request_.
| Key | Type | Default |
|---|---|---|
netplay_request_device_p1 |
bool | false |
netplay_request_device_p10 |
bool | false |
netplay_request_device_p11 |
bool | false |
netplay_request_device_p12 |
bool | false |
netplay_request_device_p13 |
bool | false |
netplay_request_device_p14 |
bool | false |
netplay_request_device_p15 |
bool | false |
netplay_request_device_p16 |
bool | false |
netplay_request_device_p2 |
bool | false |
netplay_request_device_p3 |
bool | false |
netplay_request_device_p4 |
bool | false |
netplay_request_device_p5 |
bool | false |
netplay_request_device_p6 |
bool | false |
netplay_request_device_p7 |
bool | false |
netplay_request_device_p8 |
bool | false |
netplay_request_device_p9 |
bool | false |
| Key | Type | Default |
|---|---|---|
netplay_allow_pausing |
bool | false |
netplay_allow_slaves |
bool | true |
netplay_chat_color_msg |
uint | 0xFFFFFF |
netplay_chat_color_name |
uint | 0x008000 |
netplay_check_frames |
int | 600 |
netplay_custom_mitm_server |
path | — |
netplay_fade_chat |
bool | true |
netplay_input_latency_frames_min |
uint | 0 |
netplay_input_latency_frames_range |
uint | 0 |
netplay_ip_address |
path | — |
netplay_ip_port |
uint | RARCH_DEFAULT_PORT |
netplay_max_connections |
uint | 3 |
netplay_max_ping |
uint | 0 |
netplay_mitm_server ✱ |
array | — |
netplay_nat_traversal |
bool | true |
netplay_nickname |
path | — |
netplay_password ✱ |
path | — |
netplay_ping_show |
bool | false |
netplay_public_announce |
bool | true |
netplay_require_slaves |
bool | false |
netplay_share_analog |
uint | — |
netplay_share_digital |
uint | — |
netplay_show_only_connectable |
bool | true |
netplay_show_only_installed_cores |
bool | false |
netplay_show_passworded |
bool | true |
netplay_spectate_password ✱ |
path | — |
netplay_start_as_spectator ✱ |
bool | false |
netplay_use_mitm_server ✱ |
bool | false |
Cheat files and how they are applied. 1 keys.
| Key | Type | Default |
|---|---|---|
cheat_database_path |
path | — |
On-screen translation service. 6 keys, 4 of them driven by Recalbox.
| Key | Type | Default |
|---|---|---|
ai_service_enable ✱ |
bool | false |
ai_service_mode |
uint | 1 |
ai_service_pause |
bool | false |
ai_service_source_lang ✱ |
uint | 0 |
ai_service_target_lang ✱ |
uint | 0 |
ai_service_url ✱ |
array | http://localhost:4404/ |
Video capture and broadcasting. 4 keys.
| Key | Type | Default |
|---|---|---|
record_driver |
array | — |
recording_config_directory |
path | — |
recording_output_directory |
path | — |
streaming_mode |
uint | STREAMING_MODE_TWITCH |
Messages displayed while playing. 16 keys, 1 of them driven by Recalbox.
| Key | Type | Default |
|---|---|---|
notification_show_autoconfig |
bool | true |
notification_show_autoconfig_fails |
bool | true |
notification_show_cheats_applied |
bool | true |
notification_show_config_override_load |
bool | true |
notification_show_disk_control |
bool | true |
notification_show_fast_forward |
bool | true |
notification_show_netplay_extra |
bool | false |
notification_show_patch_applied |
bool | true |
notification_show_refresh_rate |
bool | true |
notification_show_remap_load ✱ |
bool | true |
notification_show_save_state |
bool | true |
notification_show_screenshot |
bool | true |
notification_show_screenshot_duration |
uint | 0 |
notification_show_screenshot_flash |
uint | 0 |
notification_show_set_initial_disk |
bool | true |
notification_show_when_menu_is_alive |
bool | false |
Core loading, playlists, folders. 64 keys, 2 of them driven by Recalbox.
content_show_*14 keys starting with content_show_.
| Key | Type | Default |
|---|---|---|
content_show_add_entry |
uint | — |
content_show_contentless_cores |
uint | — |
content_show_explore |
bool | true |
content_show_favorites |
bool | true |
content_show_favorites_first |
bool | false |
content_show_history |
bool | true |
content_show_images |
bool | true |
content_show_music |
bool | false |
content_show_netplay |
bool | true |
content_show_playlist_tabs |
bool | true |
content_show_playlists |
bool | true |
content_show_settings |
bool | true |
content_show_settings_password |
path | — |
content_show_video |
bool | true |
core_updater_*6 keys starting with core_updater_.
| Key | Type | Default |
|---|---|---|
core_updater_auto_backup |
bool | false |
core_updater_auto_backup_history_size |
uint | 1 |
core_updater_auto_extract_archive |
bool | true |
core_updater_buildbot_assets_url |
path | — |
core_updater_buildbot_cores_url |
path | — |
core_updater_show_experimental_cores |
bool | false |
playlist_show_*4 keys starting with playlist_show_.
| Key | Type | Default |
|---|---|---|
playlist_show_entry_idx |
bool | true |
playlist_show_history_icons |
uint | — |
playlist_show_inline_core_name |
uint | — |
playlist_show_sublabels |
bool | true |
| Key | Type | Default |
|---|---|---|
content_database_path |
path | — |
content_favorites_directory |
path | — |
content_favorites_path |
path | — |
content_favorites_size |
int | 200 |
content_history_directory |
path | — |
content_history_path |
path | — |
content_history_size |
uint | 200 |
content_image_history_directory |
path | — |
content_image_history_path |
path | — |
content_music_history_directory |
path | — |
content_music_history_path |
path | — |
content_runtime_log |
bool | true |
content_runtime_log_aggregate |
bool | false |
content_video_directory |
path | — |
content_video_history_path |
path | — |
core_assets_directory ✱ |
path | — |
core_info_cache_enable |
bool | true |
core_info_cache_enable |
bool | true |
core_info_savestate_bypass ✱ |
bool | false |
core_option_category_enable |
bool | true |
core_options_path |
path | — |
core_set_supports_no_game_enable |
bool | true |
core_suggest_always |
bool | false |
libretro_directory |
path | — |
libretro_info_path |
path | — |
libretro_log_level |
uint | 1 |
playlist_allow_non_png |
bool | false |
playlist_compression |
bool | false |
playlist_directory |
path | — |
playlist_entry_remove_enable |
uint | — |
playlist_entry_rename |
bool | true |
playlist_fuzzy_archive_match |
bool | false |
playlist_portable_paths |
bool | false |
playlist_sort_alphabetical |
bool | true |
playlist_sublabel_last_played_style |
uint | — |
| Key | Type | Default |
|---|---|---|
playlist_sublabel_runtime_type |
uint | PLAYLIST_RUNTIME_PER_CORE |
playlist_use_filename |
bool | false |
playlist_use_old_format |
bool | false |
scan_serial_and_crc |
bool | false |
scan_without_core_match |
bool | false |
Locations used by RetroArch. 14 keys, 1 of them driven by Recalbox.
| Key | Type | Default |
|---|---|---|
assets_directory |
path | — |
bottom_assets_directory |
path | — |
bundle_assets_dst_path |
path | — |
bundle_assets_src_path |
path | — |
cache_directory |
path | — |
dynamic_wallpapers_directory |
path | — |
rgui_browser_directory |
path | — |
rgui_config_directory |
path | — |
runtime_log_directory |
path | — |
screenshot_directory |
path | — |
settings_show_directory |
bool | true |
system_directory ✱ |
path | — |
thumbnails_directory |
path | — |
use_last_start_directory |
bool | false |
Menu skin and navigation — rarely useful under Recalbox, which has its own frontend. 206 keys, 3 of them driven by Recalbox.
quick_menu_*25 keys starting with quick_menu_.
| Key | Type | Default |
|---|---|---|
quick_menu_show_add_to_favorites |
bool | true |
quick_menu_show_add_to_playlist |
bool | false |
quick_menu_show_cheats |
bool | true |
quick_menu_show_close_content |
bool | true |
quick_menu_show_controls |
bool | true |
quick_menu_show_core_options_flush |
bool | false |
quick_menu_show_crt_cali ✱ |
bool | false |
quick_menu_show_download_thumbnails |
bool | true |
quick_menu_show_game_ai |
bool | 1 |
quick_menu_show_information |
bool | true |
quick_menu_show_options |
bool | true |
quick_menu_show_replay |
bool | false |
quick_menu_show_reset_core_association |
bool | true |
quick_menu_show_restart_content |
bool | true |
quick_menu_show_resume_content |
bool | true |
quick_menu_show_save_content_dir_overrides |
bool | true |
quick_menu_show_save_core_overrides |
bool | true |
quick_menu_show_save_game_overrides |
bool | true |
quick_menu_show_save_load_state |
bool | true |
quick_menu_show_savestate_submenu |
bool | true |
quick_menu_show_set_core_association |
bool | true |
quick_menu_show_start_recording |
bool | true |
quick_menu_show_start_streaming |
bool | true |
quick_menu_show_take_screenshot |
bool | true |
quick_menu_show_undo_save_load_state |
bool | true |
settings_show_*22 keys starting with settings_show_.
| Key | Type | Default |
|---|---|---|
settings_show_accessibility |
bool | true |
settings_show_achievements |
bool | true |
settings_show_ai_service |
bool | true |
settings_show_audio |
bool | true |
settings_show_configuration |
bool | true |
settings_show_core |
bool | true |
settings_show_drivers |
bool | true |
settings_show_file_browser |
bool | true |
settings_show_frame_throttle |
bool | true |
settings_show_input |
bool | true |
settings_show_latency |
bool | true |
settings_show_logging |
bool | true |
settings_show_network |
bool | true |
settings_show_onscreen_display |
bool | true |
settings_show_playlists |
bool | true |
settings_show_power_management |
bool | true |
settings_show_recording |
bool | true |
settings_show_saving |
bool | true |
settings_show_steam |
bool | true |
settings_show_user |
bool | true |
settings_show_user_interface |
bool | true |
settings_show_video |
bool | true |
menu_show_*21 keys starting with menu_show_.
| Key | Type | Default |
|---|---|---|
menu_show_advanced_settings |
bool | true |
menu_show_configurations |
bool | true |
menu_show_core_manager_steam |
bool | true |
menu_show_core_updater |
bool | true |
menu_show_dump_disc |
bool | true |
menu_show_eject_disc |
bool | true |
menu_show_help |
bool | true |
menu_show_information |
bool | true |
menu_show_latency |
bool | true |
menu_show_legacy_thumbnail_updater |
bool | false |
menu_show_load_content |
bool | true |
menu_show_load_content_animation |
bool | false |
menu_show_load_core |
bool | true |
menu_show_load_disc |
bool | true |
menu_show_online_updater |
bool | true |
menu_show_quit_retroarch |
bool | true |
menu_show_reboot |
bool | true |
menu_show_restart_retroarch |
bool | true |
menu_show_rewind |
bool | true |
menu_show_shutdown |
bool | true |
menu_show_sublabels |
bool | true |
menu_xmb_*8 keys starting with menu_xmb_.
| Key | Type | Default |
|---|---|---|
menu_xmb_animation_horizontal_highlight |
uint | 0 |
menu_xmb_animation_move_up_down |
uint | 0 |
menu_xmb_animation_opening_main_menu |
uint | 0 |
menu_xmb_show_title_header |
bool | true |
menu_xmb_thumbnail_scale_factor |
uint | 100 |
menu_xmb_title_margin |
int | 5 |
menu_xmb_title_margin_horizontal_offset |
int | 0 |
menu_xmb_vertical_fade_factor |
uint | 100 |
ozone_font_*8 keys starting with ozone_font_.
| Key | Type | Default |
|---|---|---|
ozone_font_scale |
uint | 0 |
ozone_font_scale_factor_footer |
float | 1.0f |
ozone_font_scale_factor_global |
float | 1.0f |
ozone_font_scale_factor_label |
float | 1.0f |
ozone_font_scale_factor_sidebar |
float | 1.0f |
ozone_font_scale_factor_sublabel |
float | 1.0f |
ozone_font_scale_factor_time |
float | 1.0f |
ozone_font_scale_factor_title |
float | 1.0f |
split_joycon_*8 keys starting with split_joycon_.
| Key | Type | Default |
|---|---|---|
split_joycon_p1 |
uint | 0 |
split_joycon_p2 |
uint | 0 |
split_joycon_p3 |
uint | 0 |
split_joycon_p4 |
uint | 0 |
split_joycon_p5 |
uint | 0 |
split_joycon_p6 |
uint | 0 |
split_joycon_p7 |
uint | 0 |
split_joycon_p8 |
uint | 0 |
bottom_font_*6 keys starting with bottom_font_.
| Key | Type | Default |
|---|---|---|
bottom_font_color_blue |
int | 255 |
bottom_font_color_green |
int | 255 |
bottom_font_color_opacity |
int | 255 |
bottom_font_color_red |
int | 255 |
bottom_font_enable |
bool | true |
bottom_font_scale |
float | 1.48f |
menu_disable_*4 keys starting with menu_disable_.
| Key | Type | Default |
|---|---|---|
menu_disable_info_button |
bool | false |
menu_disable_left_analog |
bool | false |
menu_disable_right_analog |
bool | false |
menu_disable_search_button |
bool | false |
| Key | Type | Default |
|---|---|---|
kiosk_mode_enable |
bool | false |
kiosk_mode_password |
path | — |
materialui_auto_rotate_nav_bar |
bool | true |
materialui_dual_thumbnail_list_view_enable |
bool | true |
materialui_icons_enable |
bool | true |
materialui_landscape_layout_optimization |
uint | — |
materialui_menu_color_theme |
uint | MATERIALUI_THEME_OZONE_DARK |
materialui_menu_transition_animation |
uint | — |
materialui_playlist_icons_enable |
bool | true |
materialui_show_nav_bar |
bool | true |
materialui_switch_icons |
bool | true |
materialui_thumbnail_background_enable |
bool | true |
materialui_thumbnail_view_landscape |
uint | — |
materialui_thumbnail_view_portrait |
uint | — |
menu_allow_tabs_back |
bool | true |
menu_battery_level_enable |
bool | true |
menu_core_enable |
bool | true |
menu_driver |
array | — |
menu_dynamic_wallpaper_enable |
bool | true |
menu_enable_widgets |
bool | false |
menu_font_color_blue |
uint | 255 |
menu_font_color_green |
uint | 255 |
menu_font_color_red |
uint | 255 |
menu_footer_opacity |
float | 1.000f |
menu_framebuffer_opacity |
float | 0.900f |
menu_header_opacity |
float | 1.000f |
menu_horizontal_animation |
bool | true |
menu_icon_thumbnails |
uint | 0 |
menu_ignore_missing_assets |
bool | false |
menu_insert_disk_resume |
bool | true |
menu_left_thumbnails |
uint | 0 |
menu_linear_filter |
bool | false |
menu_mouse_enable |
bool | false |
menu_navigation_browser_filter_supported_extensions_enable |
bool | true |
menu_navigation_wraparound_enable |
bool | true |
| Key | Type | Default |
|---|---|---|
menu_pause_libretro |
bool | true |
menu_pointer_enable |
bool | false |
menu_remember_selection |
uint | — |
menu_rgui_full_width_layout |
bool | true |
menu_rgui_shadows |
bool | false |
menu_rgui_transparency |
bool | true |
menu_savestate_resume |
bool | false |
menu_scale_factor |
float | 1.0f |
menu_screensaver_animation |
uint | MENU_SCREENSAVER_BLANK |
menu_screensaver_animation_speed |
float | 1.0f |
menu_screensaver_timeout |
uint | 0 |
menu_scroll_delay |
uint | 256 |
menu_scroll_fast |
bool | false |
menu_singleclick_playlists |
bool | false |
menu_startup_page |
uint | MENU_STARTUP_PAGE_MAIN_MENU |
menu_swap_ok_cancel_buttons |
bool | true |
menu_swap_scroll_buttons |
bool | false |
menu_throttle_framerate |
bool | true |
menu_thumbnail_background_enable |
bool | false |
menu_thumbnail_upscale_threshold |
uint | 0 |
menu_thumbnails |
uint | 3 |
menu_ticker_smooth |
bool | true |
menu_ticker_speed |
float | 2.0f |
menu_ticker_type |
uint | — |
menu_timedate_date_separator |
uint | — |
menu_timedate_enable |
bool | true |
menu_timedate_style |
uint | MENU_TIMEDATE_STYLE_DDMM_HM |
menu_unified_controls |
bool | false |
menu_use_preferred_system_color_theme |
bool | false |
menu_wallpaper |
path | — |
menu_wallpaper_opacity |
float | 0.900f |
menu_widget_scale_auto |
bool | true |
menu_widget_scale_factor |
float | 1.0f |
menu_widget_scale_factor_windowed |
float | 1.0f |
ozone_collapse_sidebar |
bool | false |
| Key | Type | Default |
|---|---|---|
ozone_font |
path | — |
ozone_header_separator |
uint | 1 |
ozone_menu_color_theme |
uint | 1 |
ozone_padding_factor |
float | 1.0f |
ozone_scroll_content_metadata |
bool | false |
ozone_sort_after_truncate_playlist_name |
bool | false |
ozone_thumbnail_scale_factor |
float | 1.0f |
ozone_truncate_playlist_name |
bool | true |
rgui_aspect_ratio |
uint | RGUI_ASPECT_RATIO_4_3 |
rgui_aspect_ratio_lock |
uint | RGUI_ASPECT_RATIO_LOCK_NONE |
rgui_background_filler_thickness_enable |
bool | true |
rgui_border_filler_enable |
bool | true |
rgui_border_filler_thickness_enable |
bool | true |
rgui_extended_ascii ✱ |
bool | false |
rgui_inline_thumbnails |
bool | false |
rgui_internal_upscale_level ✱ |
uint | RGUI_UPSCALE_NONE |
rgui_menu_color_theme |
uint | RGUI_THEME_CLASSIC_GREEN |
rgui_menu_theme_preset |
path | — |
rgui_particle_effect |
uint | RGUI_PARTICLE_EFFECT_NONE |
rgui_particle_effect_screensaver |
bool | true |
rgui_particle_effect_speed |
float | 1.0f |
rgui_show_start_screen |
bool | false /* TODO */ |
rgui_swap_thumbnails |
bool | false |
rgui_switch_icons |
bool | true |
rgui_thumbnail_delay |
uint | 0 |
rgui_thumbnail_downscaler |
uint | RGUI_THUMB_SCALE_POINT |
xmb_alpha_factor |
uint | 90 |
xmb_font |
path | — |
xmb_layout |
uint | 0 |
xmb_menu_color_theme |
uint | XMB_THEME_ELECTRIC_BLUE |
xmb_shadows_enable |
bool | true |
xmb_switch_icons |
bool | true |
xmb_theme |
uint | XMB_ICON_THEME_MONOCHROME |
xmb_vertical_thumbnails |
bool | false |
Anything that does not fit the families above. 130 keys, 12 of them driven by Recalbox.
cloud_sync_*8 keys starting with cloud_sync_.
| Key | Type | Default |
|---|---|---|
cloud_sync_destructive |
bool | false |
cloud_sync_driver ✱ |
array | — |
cloud_sync_enable |
bool | false |
cloud_sync_sync_configs |
bool | true |
cloud_sync_sync_mode |
uint | CLOUD_SYNC_MODE_AUTOMATIC |
cloud_sync_sync_saves |
bool | true |
cloud_sync_sync_system |
bool | false |
cloud_sync_sync_thumbs |
bool | false |
bundle_assets_*4 keys starting with bundle_assets_.
| Key | Type | Default |
|---|---|---|
bundle_assets_dst_path_subdir |
path | — |
bundle_assets_extract_enable |
bool | false |
bundle_assets_extract_last_version |
uint | 0 |
bundle_assets_extract_version_current |
uint | 0 |
custom_viewport_*4 keys starting with custom_viewport_.
| Key | Type | Default |
|---|---|---|
custom_viewport_height ✱ |
uint | 0 /* TODO */ |
custom_viewport_width ✱ |
uint | 0 /* TODO */ |
custom_viewport_x ✱ |
uint | 0 /* TODO */ |
custom_viewport_y ✱ |
uint | 0 /* TODO */ |
| Key | Type | Default |
|---|---|---|
accessibility_enable |
bool | false |
accessibility_narrator_speech_speed |
uint | 5 |
all_users_control_menu |
bool | false |
always_reload_core_on_run_content |
bool | true |
android_input_disconnect_workaround |
bool | false |
app_icon |
array | — |
apply_cheats_after_load |
bool | false |
apply_cheats_after_toggle |
bool | false |
aspect_ratio_index ✱ |
uint | ASPECT_RATIO_CORE |
auto_overrides_enable |
bool | true |
auto_remaps_enable |
bool | true |
auto_screenshot_filename |
bool | true |
bluetooth_driver |
array | — |
bluetooth_ertm_disable |
bool | false |
builtin_imageviewer_enable |
bool | false |
builtin_mediaplayer_enable |
bool | false |
camera_allow |
bool | false |
camera_device |
array | — |
camera_driver |
array | — |
check_firmware_before_loading |
bool | false |
config_save_on_exit |
bool | true |
cpu_main_gov |
array | — |
cpu_max_freq |
uint | ~0U |
cpu_menu_gov |
array | — |
cpu_min_freq |
uint | 1 |
cpu_scaling_mode |
uint | 0 |
d3d10_gpu_index |
int | 0 |
d3d11_gpu_index |
int | 0 |
d3d12_gpu_index |
int | 0 |
desktop_menu_enable |
bool | true |
discord_allow |
bool | false |
discord_app_id |
array | 475456035851599874 |
driver_switch_enable |
bool | true |
enable_device_vibration |
bool | false |
facebook_stream_key |
array | — |
| Key | Type | Default |
|---|---|---|
filter_by_current_core |
bool | false |
fps_show ✱ |
bool | false |
fps_update_interval ✱ |
uint | 256 |
framecount_show |
bool | false |
frontend_log_level |
uint | 1 |
game_specific_options |
bool | true |
gamemode_enable ✱ |
bool | true |
gcdwebserver_alert |
bool | true |
global_core_options |
bool | false |
history_list_enable |
bool | true |
initial_disk_change_enable |
bool | true |
joypad_autoconfig_dir |
path | — |
keyboard_gamepad_enable |
bool | true |
keyboard_gamepad_mapping_type |
uint | 1 |
led_driver |
array | — |
libnx_overclock |
uint | SWITCH_DEFAULT_CPU_PROFILE |
load_dummy_on_core_shutdown |
bool | true |
location_allow |
bool | false |
location_driver |
array | — |
log_dir |
array | — |
log_to_file |
bool | false |
log_to_file_timestamp |
bool | false |
memory_show |
bool | false |
memory_update_interval |
uint | 256 |
network_cmd_enable |
bool | false |
network_cmd_port |
uint | 55355 |
network_on_demand_thumbnails |
bool | false |
network_remote_base_port |
uint | 55400 |
network_remote_enable |
bool | false /* TODO */ |
new3ds_speedup_enable |
bool | true |
pause_nonactive |
bool | true |
pause_on_disconnect |
bool | false |
quit_on_close_content |
uint | — |
quit_press_twice ✱ |
bool | true |
remap_save_on_exit |
bool | true |
| Key | Type | Default |
|---|---|---|
replay_auto_index |
bool | true |
replay_checkpoint_deserialize |
bool | true |
replay_checkpoint_interval |
uint | 0 |
replay_max_keep |
uint | 0 |
replay_slot |
int | 0 |
savestates_in_content_dir |
bool | false |
screen_brightness |
uint | 100 |
screen_orientation |
uint | ORIENTATION_NORMAL |
screenshots_in_content_dir |
bool | false |
show_hidden_files |
bool | false |
small_keyboard_enable |
bool | false |
sort_savefiles_by_content_enable |
bool | false |
sort_savefiles_enable ✱ |
bool | true |
sort_savestates_by_content_enable |
bool | false |
sort_savestates_enable ✱ |
bool | true |
sort_screenshots_by_content_enable |
bool | false |
state_slot |
int | 0 |
statistics_show |
bool | false |
stdin_cmd_enable |
bool | false |
steam_rich_presence_enable |
bool | false |
steam_rich_presence_format |
uint | — |
suspend_screensaver_enable |
bool | true |
sustained_performance_mode |
bool | false |
switch_cec |
bool | true |
switch_oc |
bool | false |
systemfiles_in_content_dir |
bool | false |
test_input_file_general |
path | — |
test_input_file_joypad |
path | — |
threaded_data_runloop_enable |
bool | false |
twitch_stream_key |
array | — |
ui_companion_enable |
bool | false |
ui_companion_start_on_boot |
bool | true |
ui_companion_toggle |
bool | false |
ui_menubar_enable |
bool | true |
user_language |
uint | — |
| Key | Type | Default |
|---|---|---|
vibrate_on_keypress |
bool | false |
vrr_runloop_enable |
bool | false |
vulkan_gpu_index |
int | 0 |
webdav_password |
array | — |
webdav_url |
array | — |
webdav_username |
array | — |
wifi_driver |
array | — |
wifi_enabled |
bool | true |
youtube_stream_key |
array | — |