Français

Comment régler une manette dans Ryujinx sur un Mac

Cette app est entièrement gratuite. Pas besoin de créer un compte. Pas d'abonnement, pas de téléchargement compliqué, et rien n'est verrouillé. Optimisée pour Apple Silicon.

Ouvrez Options, Settings dans Ryujinx, cliquez sur Input, choisissez Player 1, et choisissez votre manette dans le menu Input Device. Réglez Controller Type sur Pro Controller, vérifiez que chaque champ de bouton affiche le bouton voulu, et cliquez sur Save. Une manette PS5, PS4, Xbox, Switch Pro ou 8BitDo que le Mac liste déjà sous Manettes de jeu apparaît normalement dans ce menu sans rien installer d'autre, et la plupart des manettes inertes se réparent dans cette seule fenêtre.

Je développe InputConfig, une app Mac gratuite qui affecte les manettes à des touches et à la souris. Ryujinx lit lui-même les manettes, il n'a donc pas besoin d'un outil d'affectation pour la manette. Je ne parle d'InputConfig que là où il aide vraiment : les raccourcis que Ryujinx garde au clavier, et une manette que Ryujinx ne peut pas lister.

La version 1.7 d'InputConfig, prévue pour octobre 2026, sera entièrement disponible en français.

Étapes

Connectez la manette au Mac et vérifiez qu'elle s'allume dans Réglages Système, Manettes de jeu.
Dans Ryujinx, ouvrez Options, Settings, et cliquez sur Input.
Choisissez Player 1, puis choisissez votre manette dans le menu Input Device.
Réglez Controller Type sur Pro Controller, vérifiez chaque champ de bouton, et cliquez sur Save.
Si un jeu affiche le Controller Applet, faites correspondre les joueurs et les types de manette qu'il liste, puis relancez le jeu.

Vérifier quel Ryujinx vous utilisez

Le projet Ryujinx d'origine s'est arrêté en octobre 2024. Le nom survit dans un fork communautaire, et c'est la version à utiliser en 2026. Le 22 octobre 2026, j'ai lu son site, ryujinx.app, qui l'appelle un émulateur de Nintendo Switch 1, dit qu'il est open source sous licence MIT sur son propre serveur Forgejo, et dit qu'il a été testé sur environ 4 300 titres. Sa page de téléchargement dit que seuls les Mac Apple Silicon sont correctement pris en charge. Son serveur Forgejo et son blog ne se sont pas chargés pour moi ce jour-là, donc je ne peux pas donner de numéro de version.

Une ancienne version de 2024. Les corrections d'entrée depuis lors ne sont que dans le fork, donc mettez à jour avant de chercher un problème de manette.
Un Mac Intel. La page de téléchargement ne promet pas qu'il fonctionne bien, et c'est bon à savoir avant d'accuser la manette.
Sites de téléchargement imitateurs. De nombreuses pages reprennent le nom. Téléchargez-le depuis le site du projet lui-même.

Partez d'une version actuelle du fork, depuis son propre site, avant de changer le moindre réglage d'entrée. Cette page ne traite que des manettes, pas des fichiers de jeu ni des clés.

Régler Player 1 dans les réglages d'entrée de Ryujinx

Vous : Connectez la manette, ouvrez Options, Settings, Input, choisissez Player 1 en haut, et choisissez la manette dans Input Device. Réglez Controller Type sur Pro Controller.
Ryujinx : Remplit les champs de boutons, de sticks et de gâchettes pour cette manette.
Vérifiez : Cliquez sur un champ, comme A, et appuyez sur le bouton voulu. Le champ affiche ce qu'il a entendu. Cliquez sur Save.

La même fenêtre contient les réglages que l'on rate :

Refresh input devices. Ce bouton liste une manette connectée après l'ouverture de Ryujinx.
Profile. Nommez une disposition avec Add, enregistrez-la et chargez-la avec Load plus tard, pour qu'une deuxième manette ou une réinstallation prenne un instant. Le profil Default ne peut pas être écrasé.
Docked Mode. Activé, Ryujinx se comporte comme une Switch en dock. Désactivé, il se comporte comme une console portable, et le jeu attend alors le joueur Handheld.
Global Input. Dans les réglages propres à un jeu, il fait utiliser à ce jeu la disposition globale au lieu de la sienne.
Reset keybinds to default. Remet chaque champ en place pour l'appareil sélectionné.
Motion et Rumble. Motion a Use CemuHook Compatible Motion et la sensibilité du gyroscope. Rumble a des multiplicateurs fort et faible, et Enable HD Rumble, que Ryujinx marque comme expérimental et réservé aux manettes Nintendo d'origine.

Input Device est le réglage qui répare la plupart des manettes inertes, car il est souvent encore sur Keyboard ou Disabled.

Lire le Controller Applet quand un jeu l'affiche

Certains jeux demandent des manettes au démarrage, et Ryujinx répond avec une fenêtre intitulée Controller Applet. Elle liste Players et Supported Controllers, et dit que votre configuration actuelle est invalide et que vous devez ouvrir les réglages et reconfigurer vos entrées, avec un bouton Open Settings Window. Cela veut dire que le jeu veut une configuration que vos réglages ne lui donnent pas.

Faites correspondre le type de manette. Si la liste n'inclut pas Pro Controller, choisissez l'un des types qu'elle liste, comme JoyCon Pair, dans Controller Type pour Player 1.
Faites correspondre le nombre de joueurs. Un jeu qui veut deux joueurs demande aussi un appareil pour Player 2.
Faites correspondre dock et portable. Si l'applet dit que le mode dock est réglé et que la commande portable doit être désactivée, laissez Handheld sur Disabled et utilisez Player 1.

System, Hacks a Ignore Controller Applet, qui empêche la fenêtre d'apparaître quand une manette se déconnecte en pleine partie. Le conseil de Ryujinx lui-même dit de le laisser désactivé en cas de doute, et je le ferais. L'applet vous dit exactement ce que veut le jeu, donc lisez ses deux listes avant de changer autre chose.

Si la manette ne fait toujours rien

Montez cette échelle, du plus petit pas au plus grand :

Vérifiez le Mac. Réglages Système, Manettes de jeu doit lister la manette et allumer chaque bouton. Sinon, le problème est l'association, et manette non reconnue sur Mac commence par là.
Actualisez la liste des appareils. Appuyez sur Refresh input devices, ou quittez et rouvrez Ryujinx avec la manette déjà connectée.
Choisissez la manette, pas le clavier. Input Device pour Player 1 doit nommer votre manette.
Enregistrez, puis relancez le jeu. Un jeu qui a affiché le Controller Applet redemande des manettes au démarrage.
Vérifiez la perte de focus. On Emulator Focus Loss dans les réglages Interface peut bloquer l'entrée quand une autre fenêtre est au premier plan. Cliquez sur la fenêtre du jeu.
Quittez Steam. Steam Input peut transformer la manette en touches qui lui sont propres, donc les appuis arrivent deux fois ou au mauvais endroit.
Boutons échangés ou inertes. Cliquez sur le champ dans Input et appuyez sur le bouton voulu. Le champ prend ce que la manette envoie, quoi qu'il soit imprimé dessus.

Une manette qui marche dans Manettes de jeu et dans la fenêtre Input mais pas dans le jeu est presque toujours un problème de Controller Applet ou de joueur. Une manette d'émulateur qui ne marche pas sur Mac couvre les mêmes vérifications pour d'autres émulateurs.

Savoir quelles manettes il lit sur un Mac

Le code source de Ryujinx lit les manettes via SDL3, donc il voit les manettes que le Mac voit. Je n'ai pas testé moi-même chaque manette ci-dessous dans Ryujinx. Ce qui compte, c'est la façon dont chacune arrive au Mac :

Manettes PS5 et PS4. Elles s'associent en Bluetooth dans Réglages Système. Voir connecter une manette PS5.
Manettes Xbox Wireless. Elles s'associent en Bluetooth. Une manette Xbox 360 filaire n'est pas du tout prise en charge par macOS.
La Switch Pro Controller. Elle s'associe en Bluetooth, et c'est la manette que les jeux Switch attendent, donc Pro Controller dans Ryujinx lui correspond le mieux.
Joy-Con. macOS associe chacun séparément. Ryujinx a les types JoyCon Pair, JoyCon Left et JoyCon Right, mais je n'ai pas vérifié comment il réunit deux Joy-Con associés au Mac en une paire.
Manettes 8BitDo. Seulement dans le mode que 8BitDo liste pour les appareils Apple, D sur la plupart des modèles. Les manettes 8BitDo sur Mac détaille chaque modèle.

Si le Mac liste une manette sous Manettes de jeu, elle vaut la peine d'être choisie dans le menu Input Device de Ryujinx.

Mettre les raccourcis de Ryujinx sur des boutons libres

Ryujinx garde ses raccourcis au clavier, sous Settings, Hotkeys. Par défaut, F1 bascule le VSync, F2 coupe le son, F4 affiche ou masque l'interface, F5 met en pause et F8 prend une capture d'écran. Le mode turbo, le volume et l'échelle de résolution n'ont aucune touche au départ, donc donnez-leur d'abord une touche là. InputConfig peut appuyer sur ces touches depuis des boutons que Ryujinx laisse libres, comme le bouton Create ou Share, le clic du pavé tactile de la DualSense, ou une palette de DualSense Edge.

Vous : Faites un préréglage pour Ryujinx, ajoutez une ligne, appuyez sur Scanner (Scan) et appuyez sur le bouton libre. Réglez la sortie sur Keyboard Key et choisissez F5.
InputConfig : Envoie F5 chaque fois que vous appuyez sur ce bouton, à côté de la manette que Ryujinx lit.
Vérifiez : Dans un jeu, appuyez sur le bouton. Le jeu se met en pause. Je n'ai pas testé moi-même Ryujinx avec des touches envoyées par InputConfig, donc vérifiez une touche avant d'en construire d'autres.

L'éditeur d'InputConfig avec des lignes qui envoient les flèches, Control, Option, Espace et Échap depuis des boutons de manette. — Figure 1. Chaque ligne envoie une touche depuis un bouton. Pour Ryujinx, vous utiliseriez des lignes comme celles-ci avec F4, F5 et F8 sur des boutons que l'émulateur laisse libres.

Listez Ryujinx sous Activate when these apps are in front, et le préréglage ne s'active que lorsque Ryujinx est au premier plan. Affectez seulement des boutons que Ryujinx n'utilise pas, sinon chaque appui fait deux choses à la fois.

La section Automation and Gaming Utilities d'un préréglage dans InputConfig, avec une app listée sous Activate when these apps are in front. — Figure 2. La liste d'apps d'un préréglage. Ajoutez Ryujinx ici et les boutons de raccourcis ne marchent que lorsqu'il est au premier plan.

Piloter un profil clavier depuis une manette que Ryujinx ne peut pas lister

Quelques manettes n'apparaissent jamais dans le menu Input Device, souvent de simples manettes USB que macOS ne traite pas comme des manettes de jeu. Si le Live Visualizer d'InputConfig allume les boutons de la manette, InputConfig peut la transformer en touches de clavier que Ryujinx utilise déjà pour Player 1 avec Keyboard sélectionné :

Commande Switch	Touche par défaut de Ryujinx	À mettre sur
Stick gauche	W, A, S, D, et F pour cliquer dessus	Le stick gauche de la manette
Croix directionnelle	Les flèches	La croix directionnelle
A, B, X, Y	Z, X, C, V	Les boutons de face droit, bas, haut et gauche, les positions de la Switch
L, R, ZL, ZR	E, U, Q, O	Les boutons d'épaule et les gâchettes
Stick droit	I, J, K, L, et H pour cliquer dessus	Le stick droit

Moins et Plus ont aussi des valeurs par défaut : regardez quelles touches la fenêtre Input de Ryujinx affiche pour eux et affectez-les. Testez ensuite de la façon rapide : avec Keyboard comme Input Device, cliquez sur un champ et appuyez sur le bouton de la manette. Si le champ se remplit avec la touche, Ryujinx reçoit les touches d'InputConfig. Un stick envoyé en touches est soit poussé à fond, soit pas du tout, donc c'est un recours pour les manettes que Ryujinx ne voit pas, jamais un remplacement pour une manette qu'il voit.

Ce qu'elle ne fait pas

Pas de manette virtuelle. InputConfig envoie des touches et des événements de souris. Il ne peut pas faire passer une manette pour une autre manette auprès de Ryujinx.
Pas d'analogique via les touches. La voie du clavier perd les demi-inclinaisons des sticks et des gâchettes.
Pas de gyroscope ni de vibration par ce biais. Le mouvement et la vibration ne fonctionnent qu'avec la prise en charge propre des manettes de Ryujinx.

Je laisserais Ryujinx lire la manette et garderais InputConfig pour les touches autour.

La version courte

Le réglage. Allez dans Options, Settings, Input, choisissez Player 1, choisissez la manette dans Input Device, choisissez Pro Controller, et cliquez sur Save.
Lisez l'applet. Faites correspondre les joueurs et les types de manette que le Controller Applet liste.
Ajoutez les raccourcis. Un préréglage InputConfig met F4, F5 et F8 sur des boutons que Ryujinx laisse libres.

Si le Mac allume la manette dans Manettes de jeu, la solution est presque toujours dans la fenêtre Input de Ryujinx.

Questions

Pourquoi ma manette ne fonctionne-t-elle pas dans Ryujinx sur un Mac ?

Le plus souvent, Input Device pour Player 1 est encore sur Keyboard ou Disabled, ou la manette a été connectée après l'ouverture de Ryujinx. Appuyez sur Refresh input devices, choisissez la manette, réglez Controller Type sur Pro Controller et cliquez sur Save.

Qu'est-ce que le Controller Applet dans Ryujinx ?

Une fenêtre que certains jeux ouvrent pour demander des manettes. Elle liste les joueurs et les types de manette que le jeu prend en charge. Faites-les correspondre dans Settings, Input, puis relancez le jeu.

Une manette PS5 fonctionne-t-elle avec Ryujinx sur un Mac ?

Ryujinx lit les manettes via SDL3, qui lit une DualSense associée dans Réglages Système, Bluetooth. Choisissez-la dans le menu Input Device pour Player 1 et vérifiez les champs de boutons.

Quelles sont les commandes clavier par défaut de Ryujinx ?

W, A, S et D pour le stick gauche, les flèches pour la croix directionnelle, Z, X, C et V pour A, B, X et Y, et E, U, Q et O pour L, R, ZL et ZR. Le stick droit est I, J, K et L.

Ryujinx est-il encore développé en 2026 ?

Le projet d'origine s'est arrêté en 2024. Un fork communautaire continue sur ryujinx.app, qui se décrivait le 22 octobre 2026 comme open source sous licence MIT et correctement pris en charge seulement sur les Mac Apple Silicon.

Guides détaillés, en anglais

Qui écrit. Ryleigh Newman développe InputConfig et pilote son propre Mac chaque jour avec une manette, parce que ses mains fonctionnent mal. Cette page est traduite de l'anglais. Les principaux boutons et menus de l'app s'affichent en français quand le Mac est réglé en français ; cette page les nomme ainsi, avec le nom anglais entre parenthèses. Le reste de l'app et du site est en anglais.

Cette page dans d'autres langues : English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文, 简体中文

Gratuit. macOS 14 ou ultérieur. Sans compte, rien ne quitte votre Mac. Open source sur GitHub.