Quasiment toutes les manettes du commerce fonctionnent sur Recalbox 10.1, et la plupart sans aucune configuration : on branche (ou on appaire), on joue.
Cette page explique pourquoi, liste les familles de manettes reconnues d'office, et signale les quelques cas particuliers qui demandent une attention.
Vous cherchez la marche à suivre pour brancher ou appairer votre manette ? C'est sur Première utilisation d'une manette. Pour la configurer bouton par bouton, voir Configurer une manette.
Recalbox 10.1 empile trois niveaux de reconnaissance, du plus automatique au plus manuel. Une manette qui échoue au niveau 1 passe au niveau 2, et ainsi de suite : il n'y a donc jamais de cul-de-sac.
| Niveau | Mécanisme | Ce qu'il couvre |
|---|---|---|
| 1 | es_input.cfg embarqué — 18 mappings livrés avec le système |
Les contrôles intégrés des machines portables et des boîtiers, plus quelques manettes que la base SDL décrit mal (Xbox, Joy-Con, manettes Nintendo Switch Online, Steam Deck, GunCon 2…) |
| 2 | Auto-mapping SDL — la base communautaire de mappings de la SDL | La très grande majorité des manettes USB, Bluetooth et 2,4 GHz du marché : Xbox, DualShock/DualSense, Switch Pro, 8BitDo, Logitech, Thrustmaster, PowerA, Retro-Bit… |
| 3 | Le configurateur visuel | Tout le reste : manettes exotiques, encodeurs arcade, panels de bartop, clones sans marque |
Concrètement : si votre manette est reconnue aux niveaux 1 ou 2, elle est jouable dès l'allumage, sans écran de configuration. Sinon, le configurateur visuel se lance de lui-même dès que vous pressez un bouton, affiche une image de manette et vous fait presser les boutons un par un.
Changement depuis Recalbox 9 : la longue liste de mappings maintenue à la main dans
es_input.cfga été retirée au profit de la base SDL et du configurateur visuel. Une manette « qui marchait avant » et qui demande aujourd'hui trente secondes de configuration n'est donc pas un bug : c'est le nouveau fonctionnement, et le résultat est enregistré une fois pour toutes.
| Manette | Filaire USB | Sans fil |
|---|---|---|
| Xbox 360 | ✅ | ✅ via le récepteur sans fil Xbox 360 |
| Xbox One / Series X|S | ✅ | ✅ Bluetooth (pilote xpadneo) ou dongle sans fil Microsoft (pilote xone) |
| Xbox Elite / Adaptive Controller | ✅ | ✅ Bluetooth |
| Manettes « X-Input » génériques (PowerA, Hori, PDP…) | ✅ | ✅ selon le modèle |
Recalbox embarque xpadneo (Bluetooth, vibrations comprises), xone (dongle sans fil Microsoft) et xpad-noone (USB). Rien à installer ni à activer.
Ces pilotes ne sont pas tous présents sur toutes les images : xpadneo est fourni sur Raspberry Pi (Zero 2, 3, 4, 5) et PC ; xone et xpad-noone sur ces mêmes machines et sur les Anbernic RG353. Sur Odroid Go Advance/Super, la manette est intégrée à la machine et ces pilotes ne sont pas embarqués.
| Manette | Filaire USB | Bluetooth |
|---|---|---|
| DualShock 3 (PS3) | ✅ | ✅ après appairage en USB |
| DualShock 4 (PS4) | ✅ | ✅ |
| DualSense (PS5) | ✅ | ✅ |
| Manettes tierces PS4/PS5 (Hori, Nacon, Razer…) | ✅ | selon le modèle |
Les DualShock 4 et DualSense sont reconnues nativement par le noyau, pavé tactile et voyant lumineux compris. L'appairage Bluetooth se fait avec SHARE + PS (CREATE + PS sur DualSense) — voir Première utilisation d'une manette.
Les capteurs de mouvement (gyroscope/accéléromètre) des manettes PS3, PS4 et PS5 sont volontairement désactivés par Recalbox : ils étaient vus comme des joysticks supplémentaires et perturbaient l'attribution des joueurs.
| Manette | Filaire USB | Bluetooth |
|---|---|---|
| Switch Pro Controller | ✅ | ✅ |
| Joy-Con gauche ou droit, seul | — | ✅ (mapping embarqué) |
| Paire de Joy-Con combinée | — | ✅ (mapping embarqué, vue comme une seule manette) |
| Manettes Nintendo Switch Online : NES (gauche/droite), SNES, N64, Mega Drive | — | ✅ (mappings embarqués) |
Le démon joycond gère les Joy-Con : appairez-les l'un après l'autre, ils sont ensuite fusionnés automatiquement en une manette unique. Il est présent sur toutes les images sauf Odroid Go Advance/Super.
Le bouton SYNC (sur la tranche pour les Joy-Con, au dos pour la Pro Controller) met la manette en mode appairage.
Les manettes 8BitDo sont parmi les mieux prises en charge : la plupart sont reconnues par la base SDL, et plusieurs modèles ont un mapping embarqué.
Le point d'attention n'est pas la compatibilité mais le mode de démarrage : chaque manette 8BitDo peut se présenter comme une manette Android (D-Input), Xbox (X-Input), Switch ou Mac, avec un mapping différent à chaque fois. Privilégiez le mode D-Input (Android), et si cela coince, essayez X-Input.
➡️ La liste complète modèle par modèle, avec le mode de démarrage, la combinaison d'appairage et la procédure de réinitialisation, est sur 8BitDo sur Recalbox.
Deux modèles courants disponibles sur la boutique officielle :
Les sticks arcade du commerce (Mayflash F300/F500, Hori Fighting Stick, Qanba, 8BitDo Arcade Stick…) se présentent comme des manettes USB ou X-Input classiques et sont reconnus comme telles.
Les encodeurs USB qui équipent les bartops et panels DIY (DragonRise, Zero Delay, Xin-Mo, Juyao…) sont vus comme des joysticks génériques : le configurateur visuel propose des visuels de panels 4, 6 ou 8 boutons pour les configurer confortablement.
➡️ Détail des encodeurs, encodeurs clavier (iPAC, J-PAC), spinners et trackballs : Périphériques d'entrée. Pour un montage complet : configuration d'un bartop / d'une borne.
Les manettes USB « no name », les répliques de manettes rétro (Retro-Bit, Retroflag, iBuffalo, Retro Games Ltd) et les manettes 2,4 GHz avec dongle fonctionnent, soit via la base SDL, soit via le configurateur visuel.
Les adaptateurs qui convertissent des manettes d'époque en USB (Mayflash DB9 pour Mega Drive/Atari, adaptateurs SNES/N64/PSX vers USB) sont eux aussi vus comme des joysticks standards.
| Matériel | Situation en 10.1 |
|---|---|
| Dongle sans fil Xbox (Microsoft) | Pris en charge par xone — branchez le dongle, allumez la manette, appuyez sur son bouton d'appairage. |
| Récepteur Xbox 360 sans fil | Pris en charge, un mapping dédié est embarqué. |
| Adaptateur manettes GameCube (Wii U / Switch) | Pris en charge par wii-u-gc-adapter sur RPi Zero 2, RPi 3, RPi 4, PC et RG353. |
| Steam Controller (dongle) | Pris en charge par le démon steamcontroller sur RPi Zero 2, RPi 3 et PC. |
| Contrôles intégrés du Steam Deck | Mappings embarqués pour les modèles LCD et OLED. |
| Wiimote | Reconnue comme manette (Wii Remote seule ou avec Classic Controller). C'est surtout le pistolet de référence de Recalbox, via une barre DolphinBar — voir le lightgun sur Recalbox. |
| GunCon 2 | Reconnue, avec séparation automatique des parties joystick et souris — voir le lightgun sur Recalbox. |
| Manettes mal déclarées (NVIDIA Shield, iPEGA PG-90xx, Neo-Geo X, Mad Catz C.T.R.L.R, OUYA) | Forcées en mode joystick par Recalbox, elles fonctionnent directement. |
| Anbernic RG353 | Les contrôles intégrés sont pilotés par retrogame_joypad et reconnus d'origine : rien à configurer. |
| PiBoy DMG / XRS | Le boîtier est détecté au démarrage, son pilote de contrôles chargé, et la manette reconnue sans configuration. |
| GPi Case, GPi Case 2 et 2W | L'installation du boîtier met en place sa propre configuration de manette, restaurée à l'identique si vous le retirez. |
| Contrôleurs GPIO | Les montages maison passent par le configurateur visuel — voir les contrôleurs GPIO. |
Manettes sans SELECT ni HOTKEY |
Recalbox émule les touches manquantes par des combinaisons à partir de START. |
Manettes Bluetooth et Raspberry Pi : le Bluetooth intégré du Raspberry Pi partage son antenne avec le Wi-Fi. Si vous multipliez les manettes sans fil et que le signal devient capricieux, un dongle Bluetooth USB règle généralement le problème, tout comme un raccordement filaire.
Recalbox suit jusqu'à 10 manettes simultanément. L'attribution manette → joueur se règle dans START → OPTIONS DES MANETTES → ❶ JOUEUR 1, ❷ JOUEUR 2, etc.
En pratique, la limite vient du matériel et de l'émulateur : nombre de ports USB, nombre de joueurs géré par le système émulé, et pour le Bluetooth, capacité de l'adaptateur (4 à 5 manettes simultanées sont un maximum raisonnable sur le Bluetooth intégré d'un Raspberry Pi).
START → OPTIONS DES MANETTES → CONFIGURER UNE MANETTE.START → OPTIONS DES MANETTES → OUBLIER LES MANETTES BLUETOOTH, puis ré-appairez.START → OPTIONS DES MANETTES → TEST A CONTROLLER allume à l'écran chaque bouton pressé.Toujours rien ? Venez sur le Discord Recalbox avec le nom exact du modèle et, si vous l'avez, le nom que la manette annonce dans le configurateur : la liste des manettes testées vit grâce à ces retours.