Cette page liste les clés les plus utiles à placer dans un fichier de surcharge .retroarch.cfg (voir Surcharge de configuration pour le principe et le nommage des fichiers). Ces clés n'agissent que si le jeu est lancé avec un core RetroArch (émulateurs Libretro).
La liste complète des clés est sur la page Référence : toutes les options RetroArch — les 799 clés de RetroArch 1.22.2, avec leur type, leur valeur par défaut, et celles que Recalbox pilote lui-même.
Un ✱ signale un réglage qui peut aussi se faire via une surcharge
.recalbox.conf(clésglobal.*/<système>.*), souvent plus simple.
video_rotation = "1" : pivote le rendu — 0 = normal, 1 = 90°, 2 = 180°, 3 = 270° (attention au ratio).aspect_ratio_index = "23" : index du ratio d'affichage (23 = personnalisé). ✱video_scale_integer = "true" : mise à l'échelle par valeurs entières. ✱fps_show = "true" : afficher les FPS en jeu. ✱audio_enable = "false" : couper complètement l'audio.audio_volume = "0.0" : gain du volume en dB (0 = volume normal).Voir aussi la page Overlays — pour simplement activer/désactiver les overlays Recalbox, préférez la clé recalboxoverlays en .recalbox.conf. ✱
input_overlay = "/chemin/vers/overlay.cfg" : fichier d'overlay à utiliser.input_overlay_enable = "true" : activation de l'overlay.input_overlay_hide_in_menu = "true" : masquer l'overlay dans le menu RetroArch.custom_viewport_width, custom_viewport_height, custom_viewport_x, custom_viewport_y : cadrage de l'image du jeu dans l'overlay (avec aspect_ratio_index = "23").savefile_directory = "" : dossier des sauvegardes.savestate_directory = "" : dossier des sauvegardes instantanées.screenshot_directory = "" : dossier des captures d'écran.recording_output_directory = "" : dossier des enregistrements vidéo.Voir la page Traduction IA en jeu.
ai_service_enable = "true" : activer le service de traduction. ✱ai_service_mode = "0" : 0 = image traduite, 1 = lecture vocale.ai_service_source_lang = "0" : langue du jeu (0 = auto-détection).ai_service_target_lang = "1" : langue cible (1 = anglais, 3 = français). ✱ai_service_url = "" : URL du service de traduction. ✱netplay_nickname = "" : pseudo affiché en netplay. ✱input_playerN_analog_dpad_mode associe ou dissocie la croix directionnelle et les sticks du joueur N :
"0" : dissociés (requis par certains jeux N64 comme GoldenEye 007) ;"1" : croix associée au stick gauche ;"2" : croix associée au stick droit ;"3" / "4" : association forcée au stick gauche / droit.menu_driver = "ozone" : interface du menu RetroArch (ozone par défaut, rgui sur les petits écrans type GPi Case).menu_enable_widgets = "false" : remplacer les notifications animées par du texte simple.quick_menu_show_save_core_overrides = "false", quick_menu_show_save_content_dir_overrides = "false", quick_menu_show_save_game_overrides = "false" : masquer, dans le menu rapide, les options « remplacements de configuration » propres à RetroArch.RetroArch possède son propre système de « remplacements de configuration » (core/dossier/jeu) sauvegardé depuis son menu. Dans Recalbox, préférez les fichiers de surcharge : ils vivent avec vos roms et ne seront pas écrasés par une mise à jour ou un retour aux paramètres d'usine.
Chaque raccourci (quitter, capture, save state…) peut être déplacé sur un autre bouton pour un jeu ou un dossier :
input_enable_hotkey_btn : bouton Hotkey.input_exit_emulator_btn : quitter le jeu.input_screenshot_btn : capture d'écran.input_save_state_btn / input_load_state_btn : sauvegarde / chargement instantané.input_menu_toggle_btn : ouvrir le menu RetroArch.input_reset_btn : redémarrer le jeu.input_ai_service_btn : traduire l'écran actuel.La valeur à donner est le numéro du bouton tel que votre manette le déclare. Pour le trouver, ouvrez /recalbox/share/system/configs/retroarch/retroarchcustom.cfg (généré au lancement d'un jeu) et relevez la valeur de la clé correspondant au bouton voulu : input_player1_a_btn, input_player1_r_btn, input_player1_l_y_minus_axis (stick gauche vers le haut), etc.
Exemple : The Legend of Zelda: Link's Awakening (Game Boy) sauvegarde via Start+Select+A+B. Si votre hotkey est sur Select, cette combinaison déclenche vos raccourcis au lieu de sauvegarder. Si input_player1_r_btn = "4" dans le fichier ci-dessus, déplacez la hotkey sur R pour ce jeu uniquement avec, dans Legend of Zelda, The - Link's Awakening (France).zip.retroarch.cfg :
input_enable_hotkey_btn = "4"
Ces numéros dépendent de la manette configurée : si vous changez de manette, la surcharge peut ne plus correspondre.
Les options des menus Recalbox (RUN AHEAD, LATENCE RÉDUITE, REMBOBINAGE…) sont écrites dans la configuration RetroArch à chaque lancement de jeu. C'est pourquoi les désactiver depuis le menu de RetroArch ne tient pas : le réglage est réécrit à la partie suivante.
Une surcharge .retroarch.cfg, elle, est appliquée en dernier — après tout ce que Recalbox a généré. Elle gagne donc sur ces options, et permet de les désactiver pour un seul jeu ou un seul système sans y toucher globalement.
Le tableau donne, pour chaque option, les clés à poser dans votre fichier de surcharge :
| Option Recalbox | Clés à mettre dans le .retroarch.cfg pour la désactiver |
|---|---|
RUN AHEAD |
run_ahead_enabled = "false" |
LATENCE RÉDUITE |
video_max_swapchain_images = "3" |
REMBOBINAGE |
rewind_enable = "false" |
SAUVEGARDE AUTOMATIQUE |
savestate_auto_save = "false" et savestate_auto_load = "false" |
MISE À L'ÉCHELLE ENTIÈRE |
video_scale_integer = "false" |
AFFICHER LES FPS |
fps_show = "false" |
LISSAGE |
video_smooth = "false" |
QUITTER EN DEUX PRESSIONS |
quit_press_twice = "false" |
Pour activer une option au lieu de la désactiver, mettez "true" — sauf pour la latence réduite, dont la valeur active est video_max_swapchain_images = "2".
RUN AHEAD rejoue une frame d'avance pour gagner en réactivité, mais certains jeux le supportent mal. Pour le couper sur vos jeux d'arcade sans le désactiver partout, créez /recalbox/share/roms/fbneo/.retroarch.cfg :
run_ahead_enabled = "false"
video_max_swapchain_images = "3"
Pour un seul jeu, le même contenu dans un fichier portant le nom exact de la rom : ddonpach.zip.retroarch.cfg.
RUN AHEADetLATENCE RÉDUITEne s'appliquent de toute façon qu'aux systèmessnes,megadrive,mastersystem,nes,gb,gbc,gamegearet au corefbneo. Sur les autres, les activer dans les menus ne change rien.
Sur une sortie CRT — Recalbox RGB Dual ou RGB JAMMA — l'option FORMAT JEUX n'apparaît pas dans les menus. C'est normal : la résolution de sortie est déjà celle d'origine du jeu, le format est donc connu et imposé. Rien à régler, et rien à chercher dans les menus.
Pour recadrer ou rétrécir l'image, l'outil prévu est la calibration CRT de RetroArch (HOTKEY + B → Quick Menu → CRT Calibration), qui règle centrage et largeur avec une sauvegarde par jeu, par système ou globale. Voir la notice RGB DUAL 2.
Forcer un ratio casse le pixel parfait, quoi que vous fassiez, et peut introduire du tearing. Sur CRT, l'intérêt d'un ratio forcé est donc très limité — la calibration ci-dessus répond à la plupart des besoins. Ce qui suit est pour ceux qui savent ce qu'ils y perdent.
Si vous voulez tout de même l'imposer, cela passe par une surcharge, comme n'importe quel autre réglage RetroArch. Dans un fichier .retroarch.cfg posé à côté de la rom ou dans le dossier du système :
aspect_ratio_index = "23"
custom_viewport_width = "1280"
custom_viewport_height = "960"
custom_viewport_x = "0"
custom_viewport_y = "0"
aspect_ratio_index = "23" sélectionne le format personnalisé ; les quatre clés custom_viewport_* définissent alors la taille et la position de l'image, en pixels. Les autres index correspondent aux formats prédéfinis — la référence complète les liste.
La surcharge est appliquée en dernier, donc elle gagne sur ce que Recalbox a calculé pour votre écran. C'est précisément ce qui casse le pixel parfait : vous remplacez un cadrage calculé pour votre résolution par des valeurs fixes.