La partition de démarrage de Recalbox (/boot, visible sous le nom RECALBOX quand vous insérez la carte dans un ordinateur) contient les fichiers lus avant le démarrage du système. C'est là que se règlent l'affichage bas niveau, l'overclocking, les overlays matériels et la détection du stockage.
Ces réglages ne concernent que le Raspberry Pi et les consoles portables, sauf
recalbox-boot.confqui s'applique à toutes les machines, PC compris.
| Fichier | Rôle | Modifiable ? |
|---|---|---|
recalbox-user-config.txt |
Vos réglages bas niveau Raspberry Pi : mode vidéo, overlays (dtoverlay=), paramètres (dtparam=), overscan… |
✅ C'est ici qu'il faut écrire |
recalbox-boot.conf |
Où trouver la partition SHARE, montages réseau, temps d'attente du stockage |
✅ Oui |
config.txt |
Configuration de démarrage de Recalbox elle-même | ❌ Non — écrasé à chaque mise à jour |
recalbox-oc-config.txt |
Réglages d'overclocking | ❌ Non — géré par le menu PARAMÈTRES AVANCÉS → OVERCLOCK |
cmdline.txt |
Paramètres passés au noyau Linux | ❌ Non, sauf instruction explicite du support |
N'ajoutez jamais rien dans
config.txt. Ce fichier est régénéré à chaque mise à jour de Recalbox : vos ajouts disparaîtraient. Sa dernière ligne chargerecalbox-user-config.txt, dont le contenu surcharge tout le reste — c'est donc le bon endroit pour vos réglages, et ils survivent aux mises à jour.
recalbox-user-config.txtRECALBOX apparaît.recalbox-user-config.txt avec un éditeur de texte simple (Bloc-notes, Notepad++, TextEdit, nano…).Si la partition
RECALBOXn'apparaît pas, voyez La partition « SHARE » n'apparaît pas dans Windows — la même procédure s'applique.
Connectez-vous en SSH.
Passez la partition de démarrage en écriture :
mount -o remount,rw /boot
Éditez le fichier :
nano /boot/recalbox-user-config.txt
Enregistrez (Ctrl+X, Y, Entrée) puis redémarrez avec reboot.
Le fichier livré avec Recalbox contient déjà des exemples commentés. Quelques usages courants :
# Forcer un mode vidéo VGA sur un vieil écran
#hdmi_group=1
#hdmi_mode=1
# Forcer la sortie son sur le HDMI (2) ou le DVI (1)
#hdmi_drive=2
# Sortie composite PAL
#sdtv_mode=2
# Image absente sur HDMI : mode « sûr »
#hdmi_safe=1
# Écran chinois à l'image brouillée ou lente
#hdmi_ignore_edid=0xa5000080
# Raspberry Pi 5 : passer le port M.2 en PCI Express 3
dtparam=pciex1_gen=3
Retirez le # devant la ligne pour l'activer. La syntaxe est celle du config.txt du Raspberry Pi : la documentation officielle fait référence.
Une erreur dans ce fichier peut empêcher le démarrage ou l'affichage. Gardez une copie de la version d'origine sur votre ordinateur avant de modifier quoi que ce soit.
recalbox-boot.confCe fichier indique à Recalbox où trouver vos données avant même que le système ne démarre. Les options les plus utiles :
# Où se trouve la partition SHARE :
# INTERNAL -> la partition suivant /boot sur le même support (défaut)
# ANYEXTERNAL -> n'importe quel support autre que celui de démarrage
# DEV <FSUUID> -> le support portant cet identifiant précis
# NETWORK -> un partage réseau (voir sharenetwork_* ci-dessous)
# RAM -> un disque en mémoire (à vos risques et périls)
sharedevice=ANYEXTERNAL
# Temps d'attente maximal du stockage, en secondes
# (utile pour les disques USB lents ou les montages réseau)
sharewait=30
# Montage réseau simple (NFS ou SMB)
sharenetwork_smb=SHARE@192.168.0.1:Documents/recalbox:guest
sharenetwork_nfs=ROMS@192.168.0.1:/Documents/recalbox/roms
Les lignes commençant par ; ou # sont des commentaires : retirez le caractère pour activer l'option.
Les clés
sharenetwork_*acceptent aussi une commande complète avecsharenetwork_cmd=. Ce n'est plus nécessaire pour monter un disque USB, SATA ou NVMe : depuis Recalbox 10, ces supports sont détectés et montés automatiquement — voir Utiliser un SSD NVMe comme stockage.
Sur les machines x86_64, il n'y a ni config.txt ni recalbox-user-config.txt : ces fichiers sont propres au Raspberry Pi. Seul recalbox-boot.conf est présent et utilisable. Les réglages d'affichage se font depuis l'interface (START → PARAMÈTRES AVANCÉS → RÉSOLUTIONS).