Recalbox possède un fichier de configuration nommé recalbox.conf qui vous permet de modifier des options qui ne sont pas toutes disponibles dans l'interface.
Pour le modifier, vous pouvez utiliser :
system (\\RECALBOX\system\recalbox.conf) — voir Gestion des fichiers ;/recalbox/share/system/recalbox.conf ;
- Un
;au début d'une ligne signifie que celle-ci est désactivée. Retirez le;pour activer l'option. - Redémarrez la Recalbox (ou au minimum l'interface) pour qu'une modification soit prise en compte. - Utilisateurs de Windows : utilisez un vrai éditeur de texte comme Notepad++ — le Bloc-notes peut corrompre le fichier.
Le fichier d'usine est organisé en sections :
| Section | Contenu |
|---|---|
| A — System Options | Vidéo de démarrage, mode sombre, gestionnaire web, comportement d'EmulationStation, scraper, raccourcis spéciaux, Kodi. |
| B — Network | Nom de la machine, Wi-Fi (jusqu'à 3 réseaux), Samba, virtual gamepads, SSH. |
| C — Audio | Sortie audio, volumes système et musique. |
| D — Controllers | Bluetooth, manettes PS3, GPIO, DB9, gamecon, XArcade, Joy-Con, infrarouge, Wiimotes (Dolphin). |
| E — Language and keyboard | Langue, clavier, fuseau horaire. |
| F — Updates | Mises à jour (activation et canal). |
| G — Global emulator configuration | Réglages appliqués à tous les émulateurs. |
| H — Emulators choices | Réglages par système (surchargent la section G). |
| I/J — Netplay | Jeu en ligne. |
Le contenu exact varie légèrement selon la machine (les Raspberry Pi ont en plus system.power.switch, l'écran TFT secondaire, Hyperion… ; le PC a les options d'écran externe). Les fichiers d'usine de la 10.1 sont consultables sur GitLab : rpi3, rpi4_64, rpi5_64, rpizero2, x86_64, odroidgo2, rg353x. Une copie vierge est aussi conservée sur votre Recalbox : /recalbox/share_init/system/recalbox.conf.
Ces valeurs s'appliquent à tous les émulateurs, sauf si elles sont redéfinies par système (voir plus bas).
| Clé | Rôle | Valeurs |
|---|---|---|
global.videomode |
Résolution en jeu | default (recommandé), ou une résolution 1920x1080… |
global.shaderset |
Jeu de shaders automatique | none, crtcurved, scanlines, retro — voir Configuration des shaders |
global.shaders |
Chemin d'un shader précis (.glslp) |
ex. /recalbox/share_init/shaders/scanline.glslp |
global.integerscale |
Pixel perfect (image recadrée) | 0 / 1 |
global.ratio |
Format d'image | auto, 4/3, 16/9, 16/10, custom… |
global.smooth |
Lissage de l'image | 0 / 1 (défaut 1) |
global.rewind |
Rembobinage en jeu | 0 / 1 (défaut 1) |
global.autosave |
Sauvegarde/chargement auto en quittant/lançant un jeu | 0 / 1 |
global.retroachievements |
RetroAchievements | 0 / 1 + .hardcore, .username, .password, .sounds (10.1) |
global.inputdriver |
Pilote d'entrée RetroArch | auto (recommandé), udev, sdl2 |
global.demo.systemlist |
Systèmes utilisés par l'économiseur d'écran « démo » | liste de systèmes + .duration, .infoscreenduration |
global.translate |
Traduction IA en jeu | 0 / 1 + .from, .to, .apikey, .url |
global.netplay.active |
Netplay | 0 / 1 + .nickname, .port, .relay, .lobby |
global.softpatching |
Softpatching | disable, auto, launchLast, select |
global.quitpresstwice |
Confirmer HK+START pour quitter |
0 / 1 |
global.hdmode, global.widescreenmode |
Modes HD et écran large | 0 / 1 |
global.showfps |
Afficher les FPS en jeu | 0 / 1 |
global.recalboxoverlays |
Overlays Recalbox | 0 / 1 (défaut 1) |
Chaque système peut redéfinir les valeurs globales : remplacez global. par le nom du dossier de roms du système. Exemples :
snes.ratio=4/3
snes.rewind=0
n64.videomode=640x480
S'y ajoutent trois clés propres aux systèmes :
<système>.emulator et <système>.core : forcer l'émulateur et le core utilisés (ex. neogeo.emulator=libretro + neogeo.core=fbneo, valeurs d'usine). Les émulateurs et cores disponibles pour chaque système sont listés en bas de la page wiki de chaque système (section Émulateurs) ;<système>.ignore=1 : masquer complètement un système ;<système>.configfile : charger votre propre fichier de configuration — Recalbox ne génère alors plus rien pour cet émulateur (utilisateurs avancés).Quelques clés qui n'ont pas d'entrée dans les menus de l'interface :
| Clé | Rôle | Défaut |
|---|---|---|
system.darkmode |
Nouveauté 10.1 — assombrit l'écran de démarrage (pratique dans une pièce sombre) | 0 |
controllers.bluetooth.autopaironboot |
Appairage Bluetooth automatique au démarrage | 1 |
music.remoteplaylist.enable |
Musiques d'interface distantes (playlist Recalbox, Jukebox) | 1 |
updates.type |
Canal de mise à jour (stable par défaut ; patron sur les images Patreon — ne changez pas cette valeur à la main) |
stable |
patron.privatekey |
Clé privée Patreon (remplie via le menu PATRON) |
vide |
emulationstation.virtualkeyboard |
Type de clavier virtuel : wheel, classic, simplified |
wheel |
autorun.enabled / autorun.path |
Démarrer directement sur un jeu précis (bornes, consoles dédiées) | — |
wifi2.ssid / wifi2.key (et wifi3.*) |
Réseaux Wi-Fi de secours (le premier disponible est utilisé) | — |
system.emulators.specialkeys |
Raccourcis HOTKEY en jeu : default, nomenu, none — voir Commandes spéciales |
default |
Certaines clés présentes dans le fichier d'usine sont des reliquats sans effet en 10.1 : c'est le cas de
emulationstation.videosnaps.*et du blocemulationstation.arcade.*(remplacé par les optionsemulationstation.virtualarcade*, réglables depuisOPTIONS DES LISTES (SYSTEMES / JEUX), sectionsSYSTÈMES ARCADEetJEUX ARCADE). Inutile de les modifier.
| Vous voulez… | Direction |
|---|---|
| Régler ces options sans éditer de fichier | L'interface et le gestionnaire web |
| Configurer les shaders | Configuration des shaders |
| Repartir d'une configuration propre | Restaurer les paramètres d'usine |