Português
O que é o Switch2Bridge e o que ele faz 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.
O Switch2Bridge, publicado no GitHub como switch2bridge-macos, é um app grátis de barra de menus, escrito em Python sob a licença MIT, que se conecta a um Switch 2 Pro Controller por Bluetooth Low Energy e transforma os botões e sticks dele em teclas. Foi escrito para o emulador Ryujinx, e também roda um servidor DSU que dá ao Dolphin e ao Cemu sticks analógicos de verdade. O próprio readme dele deixa claro que não é um driver: o macOS continua sem listar o controle, e jogos que leem controles não o veem.
Eu faço o InputConfig, um app grátis para Mac que lê o Pro Controller 2 por conta própria, por um cabo USB-C e, como ajuste experimental, por Bluetooth, e o transforma em teclas, mouse e macros em qualquer app. Não testei o Switch2Bridge, então tudo abaixo sobre ele vem do readme dele, que li em 27 de outubro de 2026.
Passos
- Confira que o projeto que você achou é o mlstr0m/switch2bridge-macos, já que outros projetos usam o mesmo nome.
- Baixe a imagem de disco da página Releases dele, mova o app para Aplicativos e permita-o uma vez em Ajustes do Sistema, Privacidade e Segurança, porque ele não é notarizado.
- Permita a Acessibilidade quando ele começar e o Bluetooth na primeira vez que clicar em Connect Controller.
- No Ryujinx, defina Input Device como Keyboard e combine as teclas, ou aponte o Dolphin ou o Cemu para o servidor DSU dele.
- Para outros apps, ou num cabo, feche-o e use o InputConfig no lugar.
Confira qual Switch2Bridge você achou
Vários projetos sem relação dividem o nome, e só um deles é o app de barra de menus em Python que as pessoas costumam querer dizer. Estes são os que achei no GitHub em 27 de outubro de 2026:
| Repositório | O que é | Roda em |
|---|---|---|
| mlstr0m/switch2bridge-macos | O app de barra de menus em Python desta página: Bluetooth Low Energy, teclas e um servidor DSU. Licença MIT. A última versão, 1.4.0, saiu em 28 de setembro de 2026. | macOS 13 Ventura ou posterior |
| SwonDev/Switch2Bridge | Um app de fundo em Swift que leva o Pro Controller 2 a jogos do Windows rodando no Wine, como pelo CrossOver. O readme dele, em espanhol, diz que jogos nativos de Mac não são suportados. | macOS 15 Sequoia ou posterior |
| gessecarneiro/Switch2Bridge | Um programa do Windows para o Pro Controller 2 por USB. | Windows, não um Mac |
Links antigos para aureliendesert/switch2bridge-macos levam ao mesmo repositório que o mlstr0m/switch2bridge-macos, onde moram os downloads dele. Confira o repositório de onde veio um download, porque o nome sozinho não diz qual programa é.
Saiba o que ele lê e o que ele envia
O Switch2Bridge se conecta ao controle diretamente por Bluetooth Low Energy, sem pareá-lo em Ajustes do Sistema, e lê a calibração de fábrica dos sticks do controle quando conecta. O readme dele lista:
- Todo botão. Os botões de ação, o direcional, L, R, ZL e ZR, os cliques de stick, Plus, Minus, Home e Capture, o novo botão C e os botões de empunhadura GL e GR atrás.
- Os dois sticks como teclas. W, A, S e D para o stick esquerdo e I, J, K e L para o direito, com cada stick reduzido a oito direções.
- Botões como teclas. Por padrão o A envia Z, o B envia X, o X envia C e o Y envia V, com o direcional nas teclas de seta e o botão C livre.
- Reconexões. Se o controle dorme ou cai, o app continua tentando por 60 segundos.
- Mais de um controle. Uma cópia do app por controle, cada uma iniciada com o próprio arquivo de mapeamento.
Para mudar uma tecla, você edita um arquivo JSON e escolhe Reload mappings no ícone dele na barra de menus:
Finder, Ir para a Pasta: onde o Switch2Bridge guarda o mapeamento de teclas.
~/Library/Application Support/Switch2Bridge/mappings.jsonO que acontece: O Finder abre o arquivo que o app escreveu na primeira abertura. Cada botão ou direção de stick leva uma tecla.
Saiba o que ele pede do seu Mac
- macOS 13 Ventura ou posterior. Python 3.10 ou posterior só se você roda a partir do código-fonte.
- Um app sobre o qual o macOS avisa. A versão não é notarizada, então o Gatekeeper bloqueia a primeira abertura. No macOS 15 e posteriores você o permite em Ajustes do Sistema, Privacidade e Segurança, com Open Anyway. No macOS 13 e 14 você clica com o direito no app e escolhe Abrir.
- Acessibilidade. Pedida na abertura, porque o app aperta teclas por você.
- Bluetooth. Pedido na primeira vez que você clica em Connect Controller. Rodando pelo código-fonte, a permissão de Bluetooth pertence ao Terminal ou ao seu Python, não ao app.
A Acessibilidade deixa um app apertar teclas em todos os outros apps, então só a dou a apps em que confio. Este é de código aberto, então você pode ler exatamente o que ele faz com ela. Ele não desliga nenhuma das proteções de segurança do Mac, o que é mais do que alguns projetos de Switch 2 podem dizer.
Tenha sticks analógicos no Dolphin e no Cemu por DSU
Teclas são tudo ou nada, e é por isso que um stick enviado como teclas tem só oito direções. Para emuladores que aceitam o DSU, o protocolo cemuhook, o Switch2Bridge também roda um pequeno servidor que lhes entrega o controle com sticks analógicos de verdade. Ele escuta neste endereço por padrão:
Dolphin ou Cemu: o endereço do servidor DSU a adicionar.
127.0.0.1:26760O que acontece: O controle aparece no emulador como um dispositivo de entrada, sticks incluídos.
- Dolphin. Options, Controller Settings, Alternate Input Sources, ligue DSU Client e adicione o endereço.
- Cemu. Nos ajustes de entrada dele, adicione um DSUController com o mesmo endereço.
- Ryujinx. Usa o DSU só para movimento, e o readme diz que o Switch2Bridge ainda não decodifica o movimento, então envia zeros. Botões e sticks no Ryujinx ainda passam pelas teclas.
Do lado do DSU os botões são mapeados por posição, A para Circle, B para Cross e assim por diante, e GL, GR e C não têm para onde ir. Sticks analógicos no Dolphin e no Cemu são o trabalho aqui que o InputConfig não faz, porque ele envia teclas e movimento do mouse, não um feed DSU. Configurar controle no Dolphin num Mac trata dos controles que o Dolphin lê diretamente.
Conheça os limites dele
- Só o Pro Controller 2. O readme não nomeia nenhum outro controle, então não é a ferramenta para o Joy-Con 2 nem para o controle de GameCube do Switch 2.
- Só Bluetooth. Por USB o controle fica em silêncio até receber uma sequência de inicialização, e o readme diz que isso ainda não está embutido no Switch2Bridge.
- Não é um controle de jogo do Mac. Ajustes do Sistema, Controles de Videogame não o lista, e jogos que leem controles pelo macOS, o Steam entre eles, não o veem.
- Teclas, não um pad. Um jogo que aceita só um controle o ignora, e um stick enviado como teclas perde os meios empurrões.
Compare as outras ferramentas de Switch 2 para um Mac
Os controles do Switch 2 chegam a um Mac só por software que fala o protocolo deles. Estes são os projetos que eu olharia, pelo que a página de cada um diz em 27 de outubro de 2026. Não testei nenhum deles.
| Ferramenta | Controles | Conexão | O que outros apps veem | O que ela pede |
|---|---|---|---|---|
| switch2bridge-macos | Pro Controller 2 | Bluetooth | Teclas, mais um feed DSU para emuladores | Acessibilidade, Bluetooth, um app que não é notarizado |
| Peterksharma/switch2mac, um app chamado Finally the Controller Works | Pro Controller 2, Joy-Con 2 sozinhos ou em par, o controle de GameCube | Bluetooth, até quatro ao mesmo tempo | O readme dele diz um controle de jogo padrão que todo app lê, sem rumble nem movimento | macOS 15 ou posterior em Apple silicon, Bluetooth. Marcado como beta, assinado e notarizado |
| AlexmChadwick/Switch-2-Controller-Helper | Pro Controller 2 | Bluetooth | Um gamepad virtual só com um entitlement pago de desenvolvedor Apple ou o SIP desligado, senão teclas | Você o compila no Xcode. O autor o chama de trabalho em andamento |
| procon2-mac | Pro Controller 2 | USB, com o sem fio pedindo mais | Num cabo, o Steam e outros apps podem lê-lo | O sem fio precisa de uma extensão DriverKit que você compila e assina com uma conta de desenvolvedor paga |
| InputConfig | Pro Controller 2, cada Joy-Con 2 sozinho, o controle de GameCube | USB-C, e Bluetooth com um ajuste | Teclas, mouse, macros e funções do sistema | Acessibilidade, e Bluetooth para o ajuste sem fio. Experimental, e a parte de Bluetooth ainda não conferida num controle |
Se o que você precisa é que os jogos vejam o controle como um controle, o readme do switch2mac diz que esse é exatamente o trabalho dele, e o Switch2Bridge diz com clareza que não é. A página do Switch 2 Pro Controller num Mac tem mais sobre cada um, e Joy-Con 2 num Mac trata dos dois projetos JoyCon2Mac.
Leia um Switch 2 Pro Controller com o InputConfig
O InputConfig fala com o controle por conta própria, então não precisa de driver nem de extensão, e não muda nada na segurança do seu Mac. Tudo isso é marcado como experimental no app, porque eu o montei a partir da sequência de inicialização e do layout de relatório publicados pela comunidade, sem o controle em mãos.
Passo 1: Conecte-o
- Você: Feche primeiro o Switch2Bridge, para só um app falar com o controle. Depois ligue o controle ao Mac com um cabo USB-C que leve dados e abra o InputConfig. Para Bluetooth, abra Settings, Devices, ligue Connect Switch 2 Pro, GameCube and Joy-Con 2 controllers over Bluetooth e segure o botão de sincronização do controle até as luzes varrerem. Na primeira vez, o macOS pergunta se o InputConfig pode usar o Bluetooth, então permita.
- InputConfig: Envia ao controle os comandos de inicialização que ele espera, ou o acha por Bluetooth enquanto o app roda, e o lê como qualquer outro pad.
- Confira: A luz de jogador 1 acende, e o controle aparece no alto da barra lateral como Switch 2 Pro Controller (Experimental).
Passo 2: Dê uma tarefa a cada controle
- Você: Abra um preset, adicione uma linha, aperte Scan, aperte um botão e escolha uma tecla, um clique ou uma macro.
- InputConfig: Lê todo botão de ação, os dois sticks, o direcional, L, R, ZL e ZR, Minus, Plus, Home, Capture, C, GL e GR e, desde a 1.8, os sensores de movimento e a calibração dos sticks guardada no controle.
- Confira: Aperte cada controle com o Live Visualizer aberto antes de contar com um layout.
O app rotula o ajuste de Bluetooth como experimental: ainda não conferido num controle, então um cabo continua sendo o caminho mais seguro. Para o Ryujinx, o InputConfig pode enviar as teclas de teclado dele, com Input Device definido como Keyboard, e configurar controle no Ryujinx num Mac lista as teclas padrão para mapear e como conferir que uma chega.
O que o InputConfig não faz aqui
- Fazer dele um controle de jogo do Mac. O macOS continua sem ler o Pro Controller 2, então jogos que leem controles pelo macOS também não o veem com o InputConfig.
- Enviar um feed DSU. Para sticks analógicos dentro do Dolphin ou do Cemu, esse é o trabalho do Switch2Bridge.
- Ler o ZL e o ZR como analógicos. Eles são lidos como ligado ou desligado.
- Rumble e NFC. O InputConfig não usa nenhum dos dois.
O resumo
- Switch2Bridge. Um app grátis de barra de menus em Python para o Pro Controller 2 por Bluetooth que envia teclas, feito para o Ryujinx.
- O melhor truque dele. Um servidor DSU com sticks analógicos de verdade para o Dolphin e o Cemu.
- Os limites dele. Um modelo de controle, só Bluetooth, não notarizado e não é um controle de jogo para o macOS.
- InputConfig. O Pro Controller 2 num cabo ou por Bluetooth, como recurso experimental, mapeado para teclas, mouse e macros em qualquer app.
Escolha o Switch2Bridge para sticks analógicos no Dolphin ou no Cemu, e o InputConfig para tudo o que aceita teclado e mouse, e rode um de cada vez.
Perguntas
O Switch2Bridge é seguro para rodar?
Ele é de código aberto sob a licença MIT, então o código dele pode ser lido, e não desliga nenhuma proteção de segurança do Mac. Não é notarizado, então o macOS avisa na primeira abertura, e ele pede Acessibilidade para apertar teclas. Não o testei nem o auditei.
O Switch2Bridge funciona com o Joy-Con 2?
O readme dele nomeia só o Switch 2 Pro Controller. Para o Joy-Con 2, o readme do switch2mac os lista, e o InputConfig lê cada um sozinho como recurso experimental.
O Switch2Bridge precisa da permissão de Acessibilidade?
Precisa. Ele pede Acessibilidade na abertura porque aperta teclas por você, e Bluetooth na primeira vez que você clica em Connect Controller.
O InputConfig lê o Switch 2 Pro Controller?
Lê, como recurso experimental: num cabo USB-C desde a 1.6, com movimento desde a 1.8 e por Bluetooth desde a 1.8 com Connect Switch 2 Pro, GameCube and Joy-Con 2 controllers over Bluetooth ligado em Settings, Devices. A parte de Bluetooth é rotulada como ainda não conferida num controle.
Por que um Mac não vê o Switch 2 Pro Controller?
O macOS suporta o Switch Pro Controller original, mas não a versão do Switch 2. Por USB ele espera comandos de inicialização que nada num Mac envia, e por Bluetooth usa o protocolo Low Energy próprio da Nintendo, então só apps que o falam conseguem lê-lo.
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, Deutsch, Español, Français, Italiano, 日本語, 한국어, Polski, Русский, ไทย, 繁體中文, 简体中文
Grátis. macOS 14 ou posterior. Sem conta, nada sai do seu Mac. Código aberto no GitHub.