Recalbox se met normalement à jour toute seule — voir le Gestionnaire de mise à jour. Cette page détaille la méthode manuelle, utile dans trois cas :
Il vous faut exactement deux fichiers, aux noms précis :
recalbox-<arch>.img.xz ;recalbox-<arch>.img.xz.sha1, qui permet à Recalbox de vérifier que l'image n'est pas corrompue.<arch> est le nom interne de votre machine :
| Machine | <arch> |
Fichier image |
|---|---|---|
| Raspberry Pi 5 | rpi5_64 |
recalbox-rpi5_64.img.xz |
| Raspberry Pi 4 / 400 | rpi4_64 |
recalbox-rpi4_64.img.xz |
| Raspberry Pi 3 | rpi3 |
recalbox-rpi3.img.xz |
| Raspberry Pi Zero 2 | rpizero2 |
recalbox-rpizero2.img.xz |
| PC (x86 64 bits) | x86_64 |
recalbox-x86_64.img.xz |
| Odroid Go Advance / Super | odroidgo2 |
recalbox-odroidgo2.img.xz |
| Anbernic RG353 | rg353x |
recalbox-rg353x.img.xz |
Les deux fichiers doivent porter exactement ces noms (celui de l'arch de votre machine) : un fichier renommé ou un
.sha1manquant, et la mise à jour sera ignorée ou refusée. En cas de doute, le nom exact de votre arch est dans le fichier/recalbox/recalbox.archde votre Recalbox.
Sur un ordinateur, téléchargez l'image de la dernière version pour votre machine et son fichier .sha1 depuis www.recalbox.com/download/stable/allimages/ (ou utilisez les fichiers fournis par l'équipe si l'on vous a demandé de tester une image particulière).
update/Les deux fichiers doivent atterrir dans le dossier update/ de la partition de démarrage de votre Recalbox (la partition nommée RECALBOX). Deux façons de faire :
RECALBOX (lisible sous Windows et macOS).recalbox-<arch>.img.xz et recalbox-<arch>.img.xz.sha1 dans son dossier update/.mount -o remount,rw /boot
/boot/update/.Démarrez (ou redémarrez) votre Recalbox :
OFFLINE INSTALL, avec une barre de progression et la mention PLEASE WAIT (comptez 5 à 10 minutes).MENU PRINCIPAL → RÉGLAGES SYSTÈME.N'éteignez jamais votre Recalbox pendant l'installation. Si un écran d'erreur apparaît puis que la machine redémarre sur l'ancienne version : l'image était corrompue ou incomplète, et les fichiers ont été automatiquement nettoyés — re-téléchargez les deux fichiers et recommencez.
recalbox.conf, partition SHARE) ne sont pas touchés — c'est une mise à jour, pas une réinstallation.recalbox-user-config.txt, recalbox-boot.conf, configuration CRT) sont conservés.SHARE pour décompresser temporairement l'image (quelques Go) : faites de la place si elle est pleine à ras bord.Cette méthode est exactement celle qu'utilise la mise à jour en ligne — seul le transport des fichiers change. Retrouvez le déroulé complet côté menus dans le Gestionnaire de mise à jour.
Besoin d'aide ? Rejoignez le Discord Recalbox.