Português
Como configurar um controle no Ryujinx num Mac
Este app é totalmente gratuito. Você não precisa criar uma conta. Não há assinaturas nem downloads complicados, e nada fica bloqueado. Otimizado para Apple Silicon.
Abra Options, Settings no Ryujinx, clique em Input, escolha Player 1 e selecione seu controle no menu Input Device. Defina Controller Type como Pro Controller, confira se cada campo de botão mostra o botão que você quer e clique em Save. Um controle de PS5, PS4, Xbox, Switch Pro ou 8BitDo que o Mac já lista em Controles de Videogame normalmente aparece nesse menu sem mais nada instalado, e a maioria dos controles mortos se resolve nessa janela.
Eu faço o InputConfig, um app grátis para Mac que mapeia controles para teclas e para o mouse. O Ryujinx lê controles por conta própria, então não precisa de um mapeador para o pad. Só menciono o InputConfig onde ele realmente ajuda: as teclas de atalho que o Ryujinx deixa no teclado, e um pad que o Ryujinx não consegue listar.
A versão 1.7 do InputConfig, prevista para outubro de 2026, estará totalmente disponível em português.
Passos
- Conecte o controle ao Mac e confira se ele acende em Ajustes do Sistema, Controles de Videogame.
- No Ryujinx, abra Options, Settings e clique em Input.
- Escolha Player 1 e selecione seu controle no menu Input Device.
- Defina Controller Type como Pro Controller, confira cada campo de botão e clique em Save.
- Se um jogo mostrar o Controller Applet, combine os jogadores e os tipos de controle que ele lista e inicie o jogo de novo.
Confira qual Ryujinx você está rodando
O projeto Ryujinx original parou em outubro de 2024. O nome continua num fork da comunidade, e esse é o build a usar em 2026. Em 22 de outubro de 2026 li o site dele, ryujinx.app, que o chama de emulador de Nintendo Switch 1, diz que é de código aberto sob a licença MIT no próprio servidor Forgejo e diz que foi testado em cerca de 4.300 títulos. A página de download dele diz que só Macs com Apple Silicon são suportados direito. O servidor Forgejo e o blog dele não carregaram para mim naquele dia, então não posso dar um número de versão.
- Um build antigo de 2024. As correções de entrada desde então estão só no fork, então atualize antes de caçar um problema de controle.
- Um Mac Intel. A página de download não promete que funcione bem, e vale saber disso antes de culpar o pad.
- Sites de download imitadores. Muitas páginas reusam o nome. Baixe do site do próprio projeto.
Comece de um build atual do fork, vindo do site dele, antes de mudar um único ajuste de entrada. Esta página trata só de controles, não de arquivos de jogo nem de chaves.
Configure o Player 1 nos ajustes de Input do Ryujinx
- Você: Conecte o pad, abra Options, Settings, Input, escolha Player 1 no topo e selecione o pad em Input Device. Defina Controller Type como Pro Controller.
- Ryujinx: Preenche os campos de botão, analógico e gatilho para esse pad.
- Confira: Clique num campo, como A, e aperte o botão que você quer nele. O campo mostra o que ouviu. Clique em Save.
A mesma janela guarda os ajustes que as pessoas perdem:
- Refresh input devices. Este botão lista um pad que você conectou depois de o Ryujinx abrir.
- Profile. Dê nome a um layout com Add, salve-o e use Load depois, para que um segundo pad ou uma reinstalação leve um instante. O perfil Default não pode ser sobrescrito.
- Docked Mode. Ligado, o Ryujinx se comporta como um Switch no dock. Desligado, como um portátil, e o jogo então espera o jogador Handheld.
- Global Input. Nos ajustes próprios de um jogo, faz esse jogo usar o layout global em vez do seu.
- Reset keybinds to default. Devolve cada campo ao padrão do dispositivo selecionado.
- Motion e Rumble. Motion tem Use CemuHook Compatible Motion e a sensibilidade do giroscópio. Rumble tem multiplicadores forte e fraco, e Enable HD Rumble, que o Ryujinx marca como experimental e só para controles Nintendo originais.
Input Device é o ajuste que conserta a maioria dos controles mortos, porque muitas vezes ainda está em Keyboard ou Disabled.
Leia o Controller Applet quando um jogo o mostrar
Alguns jogos pedem controles ao começar, e o Ryujinx responde com uma janela intitulada Controller Applet. Ela lista Players e Supported Controllers, e diz que sua configuração atual é inválida e que você deve abrir os ajustes e reconfigurar suas entradas, com um botão Open Settings Window. Isso significa que o jogo quer uma configuração que seus ajustes não dão.
- Combine o tipo de controle. Se a lista não inclui Pro Controller, escolha um dos tipos que ela lista, como JoyCon Pair, em Controller Type para o Player 1.
- Combine o número de jogadores. Um jogo que quer dois jogadores precisa que o Player 2 também tenha um dispositivo.
- Combine o modo dock e o portátil. Se o applet diz que o modo dock está definido e o controle Handheld deve ficar desativado, deixe Handheld em Disabled e use o Player 1.
System, Hacks tem Ignore Controller Applet, que impede a janela de aparecer quando um pad desconecta no meio do jogo. A própria dica do Ryujinx diz para deixar desligado se você não tem certeza, e eu deixaria. O applet diz exatamente o que o jogo quer, então leia as duas listas dele antes de mudar qualquer outra coisa.
Se o controle ainda não faz nada
Suba esta escada, do menor passo ao maior:
- Confira o Mac. Ajustes do Sistema, Controles de Videogame deve listar o pad e acender cada botão. Se não lista, o problema é o pareamento, e controle não reconhecido num Mac começa por aí.
- Atualize a lista de dispositivos. Aperte Refresh input devices, ou feche e abra o Ryujinx com o pad já conectado.
- Escolha o pad, não o teclado. Input Device do Player 1 precisa nomear seu controle.
- Salve, depois inicie o jogo de novo. Um jogo que mostrou o Controller Applet pede controles de novo quando começa.
- Confira a perda de foco. On Emulator Focus Loss nos ajustes de Interface pode bloquear a entrada quando outra janela está na frente. Clique na janela do jogo.
- Feche o Steam. O Steam Input pode transformar o pad em teclas próprias, então os apertos chegam em dobro ou vão ao lugar errado.
- Botões trocados ou mortos. Clique no campo em Input e aperte o botão que você quer. O campo aceita o que o pad enviar, seja o que for que está impresso nele.
Um pad que funciona em Controles de Videogame e na janela Input mas não no jogo é quase sempre um ajuste do Controller Applet ou de jogador. Controle de emulador não funciona num Mac trata das mesmas verificações para outros emuladores.
Saiba quais controles ele lê num Mac
O código do Ryujinx lê controles pelo SDL3, então ele vê os pads que o Mac vê. Não testei no Ryujinx todos os pads abaixo. O que importa é como cada um chega ao Mac:
- Controles de PS5 e PS4. Pareiam por Bluetooth em Ajustes do Sistema. Veja conectar um controle de PS5.
- Xbox Wireless Controllers. Pareiam por Bluetooth. Um pad de Xbox 360 com fio não é suportado pelo macOS de jeito nenhum.
- O Switch Pro Controller. Pareia por Bluetooth, e é o controle que os jogos de Switch esperam, então Pro Controller no Ryujinx combina melhor com ele.
- Joy-Cons. O macOS pareia cada um sozinho. O Ryujinx tem os tipos JoyCon Pair, JoyCon Left e JoyCon Right, mas não verifiquei como ele junta dois Joy-Cons pareados no Mac num par.
- Pads da 8BitDo. Só no modo que a 8BitDo lista para dispositivos Apple, D na maioria dos modelos. Controles 8BitDo num Mac tem cada modelo.
Se o Mac lista um pad em Controles de Videogame, vale escolhê-lo no menu Input Device do Ryujinx.
Ponha as teclas de atalho do Ryujinx em botões sobrando
O Ryujinx guarda as teclas de atalho no teclado, em Settings, Hotkeys. Por padrão F1 alterna o VSync, F2 silencia, F4 mostra ou esconde a interface, F5 pausa e F8 tira uma captura de tela. Turbo Mode, volume e escala de resolução começam sem tecla, então dê a eles uma tecla ali primeiro. O InputConfig pode apertar essas teclas a partir de botões que o Ryujinx deixa sem ligação, como o botão Create ou Share, o clique do touchpad do DualSense ou um paddle do DualSense Edge.
- Você: Faça um preset para o Ryujinx, adicione uma linha, clique em Escanear (Scan) e aperte o botão sobrando. Defina a saída como Keyboard Key e escolha F5.
- InputConfig: Envia F5 toda vez que você aperta esse botão, junto com o pad que o Ryujinx está lendo.
- Confira: Num jogo, aperte o botão. O jogo pausa. Não testei o Ryujinx com teclas enviadas pelo InputConfig, então confira uma tecla antes de montar mais.
Liste o Ryujinx em Activate when these apps are in front, e o preset liga só enquanto o Ryujinx está na frente. Mapeie só botões que o Ryujinx não usa, ou cada aperto faz duas coisas ao mesmo tempo.
Conduza um perfil de teclado a partir de um pad que o Ryujinx não lista
Alguns pads nunca aparecem no menu Input Device, muitas vezes pads USB simples que o macOS não trata como controles de jogo. Se o Live Visualizer do InputConfig acende os botões do pad, o InputConfig pode transformá-lo nas teclas de teclado que o Ryujinx já usa para o Player 1 com Keyboard selecionado:
| Controle do Switch | Tecla padrão do Ryujinx | Ponha em |
|---|---|---|
| Analógico esquerdo | W, A, S, D, e F para clicá-lo | O analógico esquerdo do pad |
| Direcional | As setas | O direcional |
| A, B, X, Y | Z, X, C, V | Os botões frontais direito, de baixo, de cima e esquerdo, as posições do Switch |
| L, R, ZL, ZR | E, U, Q, O | Os bumpers e gatilhos |
| Analógico direito | I, J, K, L, e H para clicá-lo | O analógico direito |
Minus e Plus também têm padrões: confira quais teclas a janela Input do Ryujinx mostra para eles e ligue essas. Depois teste do jeito rápido: com Keyboard como Input Device, clique num campo e aperte o botão do pad. Se o campo se preenche com a tecla, o Ryujinx está recebendo as teclas do InputConfig. Um analógico enviado como teclas está todo empurrado ou nada, então isto é um recurso de reserva para pads que o Ryujinx não vê, nunca um substituto para um que ele vê.
O que ele não faz
- Nenhum controle virtual. O InputConfig envia teclas e eventos de mouse. Ele não consegue fazer um pad parecer outro gamepad ao Ryujinx.
- Nenhum analógico por teclas. O caminho do teclado perde as inclinações pela metade dos analógicos e gatilhos.
- Nenhum giroscópio nem rumble por ele. Movimento e rumble só funcionam pelo suporte a controle do próprio Ryujinx.
Eu deixaria o Ryujinx ler o pad e reservaria o InputConfig para as teclas ao redor.
O resumo
- Configure. Vá a Options, Settings, Input, escolha Player 1, selecione o pad em Input Device, escolha Pro Controller e clique em Save.
- Leia o applet. Combine os jogadores e os tipos de controle que o Controller Applet lista.
- Acrescente as teclas de atalho. Um preset do InputConfig põe F4, F5 e F8 em botões que o Ryujinx deixa livres.
Se o Mac acende o pad em Controles de Videogame, a correção está quase sempre dentro da janela Input do Ryujinx.
Perguntas
Por que meu controle não funciona no Ryujinx num Mac?
Na maioria das vezes Input Device do Player 1 ainda está em Keyboard ou Disabled, ou o pad foi conectado depois de o Ryujinx abrir. Aperte Refresh input devices, escolha o pad, defina Controller Type como Pro Controller e clique em Save.
O que é o Controller Applet no Ryujinx?
Uma janela que alguns jogos abrem para pedir controles. Ela lista os jogadores e os tipos de controle que o jogo suporta. Combine-os em Settings, Input, depois inicie o jogo de novo.
Um controle de PS5 funciona com o Ryujinx num Mac?
O Ryujinx lê controles pelo SDL3, que lê um DualSense pareado em Ajustes do Sistema, Bluetooth. Escolha-o no menu Input Device do Player 1 e confira os campos de botão.
Quais são os controles de teclado padrão do Ryujinx?
W, A, S e D para o analógico esquerdo, as setas para o direcional, Z, X, C e V para A, B, X e Y, e E, U, Q e O para L, R, ZL e ZR. O analógico direito é I, J, K e L.
O Ryujinx ainda está em desenvolvimento em 2026?
O projeto original parou em 2024. Um fork da comunidade continua em ryujinx.app, que em 22 de outubro de 2026 se descrevia como de código aberto sob a licença MIT e suportado direito só em Macs com Apple Silicon.
Mais em português
Guias completos, em inglês
Quem escreve. Ryleigh Newman desenvolve o InputConfig e usa o próprio Mac todos os dias com um controle, porque as mãos não funcionam bem. Esta página foi traduzida do inglês. Os principais botões e menus do app aparecem em português quando o Mac está em português; esta página os chama assim, com o nome em inglês entre parênteses. O restante do app e do site está em inglês.
Esta página em outros idiomas: English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文, 简体中文
Grátis. macOS 14 ou posterior. Sem conta, nada sai do seu Mac. Código aberto no GitHub.