Quelque chose ne fonctionne pas ? Cette page donne les premiers réflexes, les solutions aux problèmes les plus courants, et la bonne façon de demander de l'aide.
SELECT → REDÉMARRER sur la liste des systèmes) : cela règle plus de cas qu'on ne l'imagine.Tous les logs sont dans share/system/logs, accessibles directement par le partage réseau \\RECALBOX\logs (voir Gestion des fichiers).
| Fichier | Contenu |
|---|---|
frontend.log |
Le journal de l'interface (EmulationStation) — y compris la trace d'un éventuel plantage. Les démarrages précédents sont dans frontend.backup*. |
es_launch_stdout.log / es_launch_stderr.log |
Tout ce qui s'est passé au lancement du dernier jeu : le premier réflexe quand un jeu ne se lance pas ou se ferme aussitôt. Écrasés à chaque lancement. |
recalbox.log |
Les messages des scripts système (démarrage, stockage, réseau…). |
web-server.log |
Le journal du gestionnaire web. |
Pour des logs plus bavards : START → PARAMÈTRES AVANCÉS → ACTIVER LES LOGS DE DEBUG, puis reproduisez le problème.
L'archive de support rassemble en un fichier tout ce dont l'équipe a besoin pour vous aider : version, configuration, logs, matériel détecté, manettes… Les données sensibles (clés Wi-Fi, mots de passe des comptes) sont automatiquement masquées.
http://recalbox.local depuis un navigateur) : le bouton rond en bas à droite déplie le menu d'actions → Archive de support. L'archive est générée puis téléchargée par votre navigateur./recalbox/scripts/recalbox-support.sh — le chemin de l'archive s'affiche.Dans les deux cas, l'archive (recalbox-support-<date>.tar.gz) est déposée dans le dossier share/saves. C'est le fichier à joindre quand vous demandez de l'aide.
Reconfigurez-la : START → OPTIONS DES MANETTES → CONFIGURER UNE MANETTE. Depuis la 10.1, l'assistant est visuel — suivez le guide Configurer une manette.
es_launch_stderr.log juste après la tentative.START → VÉRIFICATION DES BIOS — voir Vérification des bios._lisezmoi.txt du dossier de roms du système liste les extensions acceptées.PS.Si elle semble complètement morte, réinitialisez-la : un petit bouton se cache dans un trou au dos de la manette (accessible avec un trombone).
Réglez d'abord votre téléviseur : cherchez dans son menu image l'option de taille « 1:1 », « Plein » ou « Ajusté à l'écran » (le sur-balayage des TV est la cause n° 1). Pour aller plus loin : les tutoriels vidéo.
system.ssh.enabled=1), utilisateur root, mot de passe recalboxroot — voir Accès root.F4 quitte l'interface, puis ALT + F2 ouvre un terminal. Tapez es start (ou redémarrez) pour retrouver l'interface.Le support se passe sur Discord : la communauté et l'équipe y répondent tous les jours. Pour une réponse rapide, donnez d'emblée :
START → RÉGLAGES SYSTÈME) ;Recalbox 9.x et antérieurs ne sont plus supportés : commencez par mettre à jour ou réinstaller en 10.1.
Vos réglages ont disparu sans que vous ayez rien demandé, et le script d'extinction de votre boîtier ne répond plus ? C'est une protection automatique qui s'est déclenchée.
Recalbox compte les démarrages qui n'aboutissent pas. Au septième consécutif, elle considère qu'une modification du système empêche le démarrage et remet ce système à neuf : le dossier de surcharge est mis de côté et la configuration de boîtier est désactivée. Le compteur est remis à zéro dès qu'un démarrage aboutit — il faut donc sept échecs d'affilée pour en arriver là.
Ce que vous perdez : les modifications système que vous aviez faites hors de la partition SHARE — paquets installés à la main, fichiers modifiés dans /etc, scripts ajoutés au démarrage. Vos jeux, sauvegardes, bios et votre recalbox.conf ne sont pas concernés : ils vivent sur SHARE.
Ce qui est récupérable : l'ancien contenu est déposé dans /overlay/upper.old, accessible en SSH.
Cette sauvegarde ne survit pas à un second nettoyage : le
upper.oldprécédent est effacé avant d'être remplacé. Si ça vous arrive deux fois, ce que vous aviez la première fois est définitivement perdu.
Le boîtier : si vous utilisez un boîtier avec extinction gérée (Argon, NESPi, SuperPi…), sa configuration est retirée en même temps. Reprenez la procédure de votre boîtier pour la réactiver.
Pourquoi ça s'est déclenché : parce que sept démarrages de suite ne sont pas allés au bout. Un problème d'alimentation, une carte SD fatiguée ou une coupure de courant répétée produisent le même effet qu'une modification système bancale.
Vous copiez des jeux, vous configurez des choses, et tout est reparti au démarrage suivant ? Le stockage configuré n'a pas pu être monté, et Recalbox est repartie sur un disque en mémoire.
C'est un repli automatique : plutôt que de refuser de démarrer, Recalbox monte un espace temporaire de 128 Mo à la place du share. L'interface fonctionne normalement, mais rien n'est écrit sur un support physique — tout disparaît à l'extinction.
Le vérifier, en SSH :
mount | grep /recalbox/share
Si la ligne commence par tmpfs, c'est le cas. Une installation saine affiche le périphérique réel (/dev/mmcblk0p2, /dev/sda1…).
Les causes habituelles : carte SD en fin de vie ou mal insérée, partition SHARE corrompue, ou périphérique externe absent alors que le share a été configuré dessus. Le gestionnaire de fichiers et le partage réseau fonctionnent malgré tout, ce qui rend la panne d'autant plus déroutante : les fichiers copiés semblent arriver, puis s'évaporent.
Ne copiez plus rien tant que le montage n'est pas réparé : ce que vous transférez se perd, y compris de gros téléchargements.