Le Gestionnaire web (WebManager) est une application web embarquée dans votre Recalbox : depuis n'importe quel navigateur du même réseau (ordinateur, tablette, téléphone), vous consultez et modifiez la configuration, parcourez vos jeux et vos bios, gérez vos captures d'écran et surveillez la machine — sans quitter votre canapé.
Nouveauté Recalbox 10.1 : les réglages modifiés dans le Gestionnaire web sont désormais appliqués immédiatement dans l'interface de votre Recalbox, sans redémarrage. Voir la section La synchronisation plus bas.
¶ Y accéder
Votre Recalbox allumée et connectée au réseau, saisissez simplement son nom dans la barre d'adresse de votre navigateur :
- Sous Windows : http://recalbox/
- Sous Linux, macOS, Android ou iOS : http://recalbox.local/
Si cela ne fonctionne pas, utilisez directement l'adresse IP de votre Recalbox, par exemple http://192.168.1.34/. Pour la connaître : START → OPTIONS RÉSEAU → ligne ADRESSE IP.
Si vous avez changé le nom de votre Recalbox (
OPTIONS RÉSEAU→NOM SUR LE RÉSEAU), utilisez ce nom à la place derecalbox.
¶ Ce que vous pouvez faire
- Accueil : la version de votre Recalbox, le système parcouru et, le cas échéant, le jeu en cours d'exécution.
- Monitoring : température, charge des cœurs du processeur et occupation du stockage, en temps réel.
- Réglages : les grandes options de Recalbox, réparties en onglets (système, audio, réseau, EmulationStation, scraper, Kodi, Hyperion).
- Émulation : options globales (ratio, shaders, rembobinage…), netplay, RetroAchievements, la liste de vos systèmes et de leurs jeux, l'état de vos bios (mêmes verdicts que la vérification des BIOS) et les options de manettes.
- Captures : visionnez, téléchargez ou supprimez vos captures d'écran et vidéos, et prenez une capture à distance — pratique pour capturer un écran d'EmulationStation sans manipulation sur la machine.
- Manettes virtuelles : un clavier, un pavé tactile et une manette virtuels utilisables depuis le navigateur — votre téléphone devient une manette d'appoint pour naviguer dans les menus.
- Patreon : saisissez votre clé de Patron et gérez les options associées.
- Support : créez une archive de support (les journaux système à joindre à une demande d'aide), redémarrez ou arrêtez EmulationStation, remise à zéro usine.
Besoin d'aide pour lire l'écran des bios ? Tout est expliqué dans Vérification des BIOS.
¶ La synchronisation (nouveauté 10.1)
Jusqu'à Recalbox 10.0, un réglage modifié dans le Gestionnaire web pendant qu'EmulationStation tournait pouvait être ignoré, voire écrasé au prochain enregistrement de la configuration. Depuis Recalbox 10.1, chaque modification faite dans le Gestionnaire web est transmise à EmulationStation et appliquée immédiatement : activez par exemple l'affichage des jeux cachés depuis votre navigateur, et la liste de jeux se met à jour à l'écran dans la foulée, sans redémarrage.
La synchronisation fonctionne pour l'instant en écriture seulement : du navigateur vers la Recalbox. Dans l'autre sens, un réglage modifié dans les menus d'EmulationStation n'actualise pas tout seul une page du Gestionnaire web déjà ouverte — rechargez la page pour voir les valeurs à jour.
¶ Désactiver le Gestionnaire web
Le Gestionnaire web démarre automatiquement avec votre Recalbox. Pour le désactiver :
- Dans EmulationStation, appuyez sur
STARTpour ouvrir leMENU PRINCIPAL. - Allez dans
PARAMÈTRES AVANCÉS. - Passez l'interrupteur
ACTIVER LE GESTIONNAIRE WEBsur OFF.
L'option correspond à la clé system.manager.enabled de recalbox.conf (1 par défaut).
¶ Pour les curieux
- La page web est servie sur le port 80 (l'adresse
http://recalbox/sans préciser de port). - L'interface s'appuie sur l'API REST d'EmulationStation, servie sur le port 81 — c'est elle qui porte la synchronisation des réglages.
- Le monitoring, le suivi du jeu en cours et les manettes virtuelles passent par MQTT en websocket sur le port 18833.
Si votre Recalbox est derrière un pare-feu local, ces trois ports doivent être accessibles pour que tout fonctionne.
Besoin d'aide ? Rejoignez le Discord Recalbox.