Italiano

Come configurare un controller in Ryujinx su un Mac

Questa app è completamente gratuita. Non devi creare un account. Niente abbonamenti, niente download complicati, e nulla è bloccato. Ottimizzata per Apple Silicon.

Apri Options, Settings in Ryujinx, fai clic su Input, scegli Player 1 e scegli il tuo controller nel menu Input Device. Imposta Controller Type su Pro Controller, controlla che ogni campo dei pulsanti mostri il pulsante che vuoi e fai clic su Save. Un controller PS5, PS4, Xbox, Switch Pro o 8BitDo che il Mac elenca già sotto Controller di solito compare in quel menu senza installare altro, e la maggior parte dei controller che non rispondono si sistema in quell'unica finestra.

Io sviluppo InputConfig, un'app gratuita per Mac che associa i controller a tasti e mouse. Ryujinx legge da solo i controller, quindi non ha bisogno di un mappatore per il pad. Cito InputConfig solo dove aiuta davvero: le scorciatoie che Ryujinx tiene sulla tastiera, e un pad che Ryujinx non riesce a elencare.

La versione 1.7 di InputConfig, prevista per ottobre 2026, sarà disponibile interamente in italiano.

Passaggi

Collega il controller al Mac e controlla che si illumini in Impostazioni di Sistema, Controller.
In Ryujinx, apri Options, Settings e fai clic su Input.
Scegli Player 1, poi scegli il controller nel menu Input Device.
Imposta Controller Type su Pro Controller, controlla ogni campo dei pulsanti e fai clic su Save.
Se un gioco mostra il Controller Applet, fai corrispondere i giocatori e i tipi di controller che elenca, poi riavvia il gioco.

Controlla quale Ryujinx stai usando

Il progetto Ryujinx originale si è fermato a ottobre 2024. Il nome vive in un fork della community, ed è la build da usare nel 2026. Il 22 ottobre 2026 ho letto il suo sito, ryujinx.app, che lo chiama un emulatore Nintendo Switch 1, dice che è open source con licenza MIT sul proprio server Forgejo, e dice che è stato provato su circa 4.300 titoli. La sua pagina di download dice che solo i Mac con Apple Silicon sono supportati come si deve. Il suo server Forgejo e il blog quel giorno non si caricavano, quindi non posso dare un numero di versione.

Una vecchia build del 2024. Le correzioni dell'input da allora sono solo nel fork, quindi aggiorna prima di cercare un problema del controller.
Un Mac Intel. La pagina di download non promette che funzioni bene, e vale la pena saperlo prima di dare la colpa al pad.
Siti di download imitatori. Molte pagine riusano il nome. Scaricalo dal sito del progetto.

Parti da una build attuale del fork, dal suo sito, prima di cambiare una sola impostazione di input. Questa pagina tratta solo i controller, non i file di gioco né le chiavi.

Configura Player 1 nelle impostazioni Input di Ryujinx

Tu: Collega il pad, apri Options, Settings, Input, scegli Player 1 in alto e scegli il pad in Input Device. Imposta Controller Type su Pro Controller.
Ryujinx: Riempie i campi di pulsanti, stick e trigger per quel pad.
Verifica: Fai clic su un campo, come A, e premi il pulsante che vuoi assegnargli. Il campo mostra ciò che ha sentito. Fai clic su Save.

La stessa finestra contiene le impostazioni che la gente non nota:

Refresh input devices. Questo pulsante elenca un pad che hai collegato dopo l'apertura di Ryujinx.
Profile. Dai un nome a un layout con Add, salvalo e caricalo con Load più tardi, così un secondo pad o una reinstallazione richiedono un attimo. Il profilo Default non si può sovrascrivere.
Docked Mode. Attivo, Ryujinx si comporta come una Switch nel dock. Disattivo, si comporta come un portatile, e il gioco allora si aspetta il giocatore Handheld.
Global Input. Nelle impostazioni di un gioco, fa usare a quel gioco il layout globale invece del proprio.
Reset keybinds to default. Rimette a posto ogni campo per il dispositivo selezionato.
Motion e Rumble. Motion ha Use CemuHook Compatible Motion e la sensibilità del giroscopio. Rumble ha moltiplicatori forte e debole, e Enable HD Rumble, che Ryujinx indica come sperimentale e solo per i controller Nintendo di prima parte.

Input Device è l'impostazione che sistema la maggior parte dei controller che non rispondono, perché spesso è ancora su Keyboard o Disabled.

Leggi il Controller Applet quando un gioco lo mostra

Alcuni giochi chiedono i controller all'avvio, e Ryujinx risponde con una finestra intitolata Controller Applet. Elenca Players e Supported Controllers, e dice che la tua configurazione attuale non è valida e che dovresti aprire le impostazioni e riconfigurare gli input, con un pulsante Open Settings Window. Significa che il gioco vuole una configurazione che le tue impostazioni non gli danno.

Fai corrispondere il tipo di controller. Se l'elenco non include Pro Controller, scegli uno dei tipi che elenca, come JoyCon Pair, in Controller Type per Player 1.
Fai corrispondere il numero di giocatori. Un gioco che vuole due giocatori richiede che anche Player 2 sia impostato su un dispositivo.
Fai corrispondere dock e portatile. Se l'applet dice che la modalità dock è impostata e il controllo handheld va disattivato, lascia Handheld su Disabled e usa Player 1.

System, Hacks ha Ignore Controller Applet, che impedisce alla finestra di comparire quando un pad si scollega a metà gioco. Il consiglio di Ryujinx stesso è di lasciarlo disattivato se non sei sicuro, e lo farei anch'io. L'applet ti dice esattamente cosa vuole il gioco, quindi leggi le sue due liste prima di cambiare altro.

Se il controller continua a non fare nulla

Sali questa scala, partendo dal passo più piccolo:

Controlla il Mac. Impostazioni di Sistema, Controller deve elencare il pad e illuminare ogni pulsante. Se non lo fa, il problema è l'accoppiamento, e controller non riconosciuto su un Mac parte da lì.
Aggiorna l'elenco dei dispositivi. Premi Refresh input devices, oppure chiudi e riapri Ryujinx con il pad già collegato.
Scegli il pad, non la tastiera. Input Device per Player 1 deve nominare il tuo controller.
Salva, poi riavvia il gioco. Un gioco che mostrava il Controller Applet chiede di nuovo i controller quando parte.
Controlla la perdita di focus. On Emulator Focus Loss nelle impostazioni Interface può bloccare l'input quando un'altra finestra è in primo piano. Fai clic sulla finestra del gioco.
Chiudi Steam. Steam Input può trasformare il pad in tasti propri, così le pressioni arrivano due volte o nel posto sbagliato.
Pulsanti scambiati o morti. Fai clic sul campo in Input e premi il pulsante che vuoi. Il campo prende ciò che il pad invia, qualunque cosa sia stampata sopra.

Un pad che funziona in Controller e nella finestra Input ma non nel gioco è quasi sempre un'impostazione del Controller Applet o dei giocatori. Controller dell'emulatore che non funziona su un Mac tratta gli stessi controlli per altri emulatori.

Quali controller legge su un Mac

Il codice sorgente di Ryujinx legge i controller tramite SDL3, quindi vede i pad che vede il Mac. Non ho provato personalmente in Ryujinx tutti i pad qui sotto. Conta come ciascuno arriva al Mac:

Controller PS5 e PS4. Si accoppiano via Bluetooth in Impostazioni di Sistema. Vedi collegare un controller PS5.
Xbox Wireless Controller. Si accoppiano via Bluetooth. Un pad Xbox 360 con cavo non è supportato affatto da macOS.
Lo Switch Pro Controller. Si accoppia via Bluetooth, ed è il controller che i giochi Switch si aspettano, quindi Pro Controller in Ryujinx gli corrisponde meglio.
Joy-Con. macOS accoppia ciascuno da solo. Ryujinx ha i tipi JoyCon Pair, JoyCon Left e JoyCon Right, ma non ho verificato come unisca in una coppia due Joy-Con accoppiati al Mac.
Pad 8BitDo. Solo nella modalità che 8BitDo elenca per i dispositivi Apple, D sulla maggior parte dei modelli. I controller 8BitDo su un Mac ha ogni modello.

Se il Mac elenca un pad sotto Controller, vale la pena sceglierlo nel menu Input Device di Ryujinx.

Mettere le scorciatoie di Ryujinx su pulsanti liberi

Ryujinx tiene le sue scorciatoie sulla tastiera, sotto Settings, Hotkeys. Per impostazione predefinita F1 attiva e disattiva il VSync, F2 silenzia, F4 mostra o nasconde l'interfaccia, F5 mette in pausa e F8 fa uno screenshot. Turbo Mode, il volume e la scala della risoluzione partono senza associazione, quindi assegna loro prima un tasto lì. InputConfig può premere quei tasti da pulsanti che Ryujinx lascia liberi, come il pulsante Create o Share, il clic del touchpad del DualSense, o un paddle del DualSense Edge.

Tu: Crea un preset per Ryujinx, aggiungi una riga, premi Scan e premi il pulsante libero. Imposta l'uscita su Keyboard Key e scegli F5.
InputConfig: Invia F5 ogni volta che premi quel pulsante, insieme al pad che Ryujinx sta leggendo.
Verifica: In un gioco, premi il pulsante. Il gioco va in pausa. Non ho provato personalmente Ryujinx con i tasti inviati da InputConfig, quindi controlla un tasto prima di costruirne altri.

L'editor di InputConfig con righe che inviano i tasti freccia, Control, Option, Spazio e Escape da pulsanti del controller. — Figure 1. Ogni riga invia un tasto da un pulsante. Per Ryujinx useresti righe come queste con F4, F5 e F8 su pulsanti che l'emulatore lascia liberi.

Elenca Ryujinx sotto Activate when these apps are in front, e il preset si attiva solo mentre Ryujinx è in primo piano. Associa solo pulsanti che Ryujinx non usa, o ogni pressione fa due cose insieme.

La sezione Automation and Gaming Utilities di un preset in InputConfig, con un'app nell'elenco sotto Activate when these apps are in front. — Figure 2. L'elenco delle app su un preset. Aggiungi qui Ryujinx e i pulsanti delle scorciatoie funzionano solo mentre è in primo piano.

Guidare un profilo tastiera da un pad che Ryujinx non riesce a elencare

Alcuni pad non compaiono mai nel menu Input Device, spesso semplici pad USB che macOS non tratta come controller di gioco. Se il Live Visualizer di InputConfig illumina i pulsanti del pad, InputConfig può trasformarlo nei tasti della tastiera che Ryujinx usa già per Player 1 con Keyboard selezionato:

Controllo Switch	Tasto predefinito di Ryujinx	Mettilo su
Stick sinistro	W, A, S, D, e F per il clic	Lo stick sinistro del pad
Croce direzionale	I tasti freccia	La croce direzionale
A, B, X, Y	Z, X, C, V	I pulsanti frontali destro, inferiore, superiore e sinistro, le posizioni della Switch
L, R, ZL, ZR	E, U, Q, O	I dorsali e i trigger
Stick destro	I, J, K, L, e H per il clic	Lo stick destro

Anche Minus e Plus hanno dei predefiniti: controlla quali tasti mostra la finestra Input di Ryujinx per loro e associa quelli. Poi provalo nel modo rapido: con Keyboard come Input Device, fai clic su un campo e premi il pulsante del pad. Se il campo si riempie con il tasto, Ryujinx sta ricevendo i tasti di InputConfig. Uno stick inviato come tasti è spinto del tutto o per niente, quindi questa è una soluzione di riserva per i pad che Ryujinx non vede, mai un sostituto di uno che vede.

Cosa non può fare

Nessun controller virtuale. InputConfig invia tasti ed eventi del mouse. Non può far sembrare un pad un altro gamepad a Ryujinx.
Nessun analogico tramite tasti. La strada della tastiera perde le inclinazioni a metà di stick e trigger.
Nessun giroscopio né vibrazione tramite essa. Movimento e vibrazione funzionano solo con il supporto controller di Ryujinx.

Lascerei che Ryujinx legga il pad e terrei InputConfig per i tasti intorno.

In breve

Configuralo. Vai in Options, Settings, Input, scegli Player 1, scegli il pad in Input Device, scegli Pro Controller e fai clic su Save.
Leggi l'applet. Fai corrispondere i giocatori e i tipi di controller che elenca il Controller Applet.
Aggiungi le scorciatoie. Un preset di InputConfig mette F4, F5 e F8 su pulsanti che Ryujinx lascia liberi.

Se il Mac illumina il pad in Controller, la soluzione è quasi sempre dentro la finestra Input di Ryujinx.

Domande

Perché il mio controller non funziona in Ryujinx su un Mac?

Più spesso Input Device per Player 1 è ancora su Keyboard o Disabled, oppure il pad è stato collegato dopo l'apertura di Ryujinx. Premi Refresh input devices, scegli il pad, imposta Controller Type su Pro Controller e fai clic su Save.

Cos'è il Controller Applet in Ryujinx?

Una finestra che alcuni giochi aprono per chiedere i controller. Elenca i giocatori e i tipi di controller che il gioco supporta. Falli corrispondere in Settings, Input, poi riavvia il gioco.

Un controller PS5 funziona con Ryujinx su un Mac?

Ryujinx legge i controller tramite SDL3, che legge un DualSense accoppiato in Impostazioni di Sistema, Bluetooth. Sceglilo nel menu Input Device per Player 1 e controlla i campi dei pulsanti.

Quali sono i controlli da tastiera predefiniti di Ryujinx?

W, A, S e D per lo stick sinistro, i tasti freccia per la croce direzionale, Z, X, C e V per A, B, X e Y, ed E, U, Q e O per L, R, ZL e ZR. Lo stick destro è I, J, K e L.

Ryujinx è ancora in sviluppo nel 2026?

Il progetto originale si è fermato nel 2024. Un fork della community continua su ryujinx.app, che il 22 ottobre 2026 si descriveva come open source con licenza MIT e supportato come si deve solo sui Mac con Apple Silicon.

Altro in italiano

Guide complete, in inglese

Chi scrive. Ryleigh Newman sviluppa InputConfig e ogni giorno usa il proprio Mac con un controller, perché le mani non funzionano bene. Questa pagina è tradotta dall'inglese. I pulsanti e i menu principali dell'app compaiono in italiano quando il Mac è impostato in italiano; questa pagina li chiama così, con il nome inglese tra parentesi. Il resto dell'app e del sito è in inglese.

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

Gratis. macOS 14 o versioni successive. Senza account, niente lascia il tuo Mac. Open source su GitHub.