Recalbox vérifie tout seul si une nouvelle version est disponible et vous propose de l'installer en quelques clics : téléchargement, redémarrage, installation automatique — comptez 5 à 10 minutes hors téléchargement.
Le support n'est assuré que sur la dernière version de Recalbox : si une mise à jour vous est proposée, installez-la avant de demander de l'aide.
¶ La notification de mise à jour
Peu après le démarrage (puis une fois par heure), dès que le réseau est disponible, Recalbox compare votre version à la dernière version publiée. Si une mise à jour existe :
- Une petite notification apparaît en haut à droite de l'écran avec le numéro de la nouvelle version. Elle n'est pas désactivable — vous saurez toujours qu'une mise à jour vous attend.
- Un popup des notes de version s'ouvre par-dessus l'interface : il affiche la version proposée et la liste des nouveautés, avec deux boutons —
PLUS TARDpour le fermer,METTRE À JOURpour lancer la mise à jour immédiatement.
Seul ce grand popup peut être désactivé (option
VÉRIFIER LES MISES À JOUR PÉRIODIQUEMENTci-dessous). La vérification elle-même et la petite notification restent toujours actives.
¶ Le menu MISES À JOUR
Appuyez sur START pour ouvrir le MENU PRINCIPAL, puis allez dans MISES À JOUR :
| Ligne | Rôle |
|---|---|
MISE À JOUR DISPONIBLE |
la version proposée, ou NON si vous êtes à jour. |
VÉRIFIER LES MISES À JOUR PÉRIODIQUEMENT |
active ou désactive le popup des notes de version. |
TYPE DE MISE À JOUR |
le canal de mise à jour — visible uniquement pour les Patrons (voir Le canal patron). |
VÉRIFIER LES MISES À JOUR MAINTENANT |
bouton VÉRIFIER : force une vérification immédiate. |
VOIR LES NOUVEAUTÉS DE LA MISE À JOUR |
bouton AFFICHER : ré-affiche les notes de version de la mise à jour proposée. |
TÉLÉCHARGER ET METTRE À JOUR MA RECALBOX |
bouton ALLEZ ! : lance la mise à jour. Grisé tant qu'aucune mise à jour n'est disponible. |
¶ Déroulé d'une mise à jour en ligne
- Lancez la mise à jour, depuis le popup (
METTRE À JOUR) ou le menu (TÉLÉCHARGER ET METTRE À JOUR MA RECALBOX). - Un écran de téléchargement s'affiche : « Nous téléchargeons Recalbox version X.X.X ! », avec la progression. Recalbox vérifie au passage qu'il y a assez d'espace libre pour installer la nouvelle version.
- Téléchargement terminé, votre Recalbox redémarre automatiquement (
REDÉMARRAGE DANS…). - L'installation se fait au redémarrage : un écran de progression avec 7 barres qui passent en blanc au fur et à mesure. Comptez 5 à 10 minutes.
- Au redémarrage suivant, vous êtes sur la nouvelle version.
N'éteignez et ne redémarrez jamais votre Recalbox pendant l'installation. Si les barres passent au rouge, notez le nombre de barres blanches affichées et demandez de l'aide sur le Discord Recalbox.
¶ Mise à jour hors ligne
Pas de connexion Internet sur votre Recalbox ? Vous pouvez la mettre à jour avec des fichiers téléchargés depuis un ordinateur :
- Sur www.recalbox.com, téléchargez l'image correspondant à votre machine (
recalbox-<votre-board>.img.xz) ainsi que le fichier de contrôlerecalbox-<votre-board>.img.xz.sha1. - Copiez les deux fichiers dans le dossier
update/de la partition de démarrage :- soit en insérant la carte SD/le disque de votre Recalbox éteinte dans votre ordinateur : ouvrez le lecteur nommé
RECALBOXet déposez les fichiers dans son dossierupdate/; - soit par le réseau, dans
/boot/update/(la partition/bootdoit être remontée en lecture/écriture).
- soit en insérant la carte SD/le disque de votre Recalbox éteinte dans votre ordinateur : ouvrez le lecteur nommé
- Démarrez (ou redémarrez) votre Recalbox : elle détecte les fichiers, vérifie la somme de contrôle SHA1 et installe la mise à jour (écran
OFFLINE INSTALL - PLEASE WAIT, 5 à 10 minutes).
Si la somme de contrôle ne correspond pas (téléchargement corrompu), la mise à jour est abandonnée et les fichiers sont nettoyés : re-téléchargez l'image et recommencez.
¶ Le canal patron
Les Patrons de Recalbox ont accès aux versions en avant-première via un canal de mise à jour dédié. Une fois votre statut patron activé, la ligne TYPE DE MISE À JOUR apparaît dans le menu MISES À JOUR :
stable: les versions officielles, pour tout le monde (par défaut) ;patron: les versions en avant-première réservées aux Patrons ;patron-alpha: les versions de test, encore plus en amont — à réserver aux aventuriers.
Les canaux
patronetpatron-alphanécessitent une clé Patreon reconnue : sans elle, Recalbox reste sur les versionsstable.
¶ Dans recalbox.conf
| Clé | Valeur par défaut | Rôle |
|---|---|---|
updates.enabled |
1 |
affiche le popup des notes de version quand une mise à jour est disponible. |
Besoin d'aide ? Rejoignez le Discord Recalbox.