Very useful (Tutorial PT-BR)

[edn9]

I’d like to thank you for this program. It worked great here on my PC; I tested it both on ShadPS4 playing Bloodborne and on Steam playing Nightreign. To be honest, there seems to be a tiny bit of delay, but that might just be the standard response when playing wireless (the same thing happened to me when using an 8bitdo or a PS4 controller).

It’s really weird that Nintendo hasn’t released a patch to fix wireless PC gaming yet. For such an expensive controller, you’d expect this to work out of the box, not just on the console itself. Anyway, I’m leaving some instructions in PT-BR below for anyone who wants to install this but isn't very tech-savvy. That’s it, thanks a lot!

Instruções — Switch 2 Controllers no PC

Guia testado no Windows 11 com Nintendo Switch 2 Pro Controller — Resident Evil Requiem Edition.

Este app conecta o controle via Bluetooth e o expõe no Windows como um Xbox 360 Controller (para jogos, Steam, etc.).

---

O que você precisa

• Windows 10 ou 11 com Bluetooth ativo
• Python 3.10 ou superior
• ViGEmBus v1.22.0 instalado (obrigatório — ver Passo 1)
• Controle Switch 2 (Requiem Edition = Pro Controller 2, funciona normalmente)

---

Passo 1 — Instalar o ViGEmBus

O app usa vgamepad, que depende desse driver para criar o Xbox 360 virtual. Sem ele, o controle conecta no app, mas os jogos não veem gamepad.

Versão a baixar: ViGEmBus v1.22.0
Arquivo: ViGEmBus_Setup_1.22.0_x64_x86_arm64.exe

Por que esta versão:

• Última release oficial (nov/2023) — o projeto foi arquivado e não recebe mais updates
• Remove o auto-updater (versões antigas checavam um domínio que não pertence mais ao autor)
• Compatível com Windows 10/11 — é a que este app espera via vgamepad

1. Baixe somente a v1.22.0 no link acima (ignore pre-releases)
2. Execute como administrador
3. Reinicie o PC (caso necessario)

---

Passo 2 — Preparar o controle

1. Se o controle já estiver pareado no Bluetooth do Windows, remova-o em:
   • Configurações → Bluetooth e dispositivos → Dispositivos
2. Mantenha o Bluetooth ligado no PC
3. Desligue o Switch 2 ou desative o Bluetooth dele (evita conflito de conexão)

Não pareie o controle pelo Windows. O app faz o pareamento sozinho.

---

Passo 3 — Instalar o programa

Abra o terminal (Git Bash, PowerShell ou CMD) na pasta do projeto (substitua SEU_USUARIO pelo seu usuário do Windows):

cd C:\Users\SEU_USUARIO\Downloads\switch2-controllers

Crie e ative o ambiente virtual:

python -m venv .venv
.venv\Scripts\activate

Instale as dependências:

pip install -r requirements.txt

---

Passo 4 — Executar

Com o ambiente virtual ativo:

python gui.py

A janela Switch2 Controllers deve abrir.

---

Passo 5 — Conectar o controle

Primeira vez

1. Segure o botão Sync (ao lado da porta USB-C) até os LEDs piscarem
2. Aguarde o app detectar e conectar
3. O controle passa a aparecer no Windows como Xbox 360 Controller

Próximas vezes

• Basta apertar qualquer botão no controle para reconectar

---

Passo 6 — Usar nos jogos

• No Steam: ative suporte a controle nas configurações do jogo
• Em outros jogos: selecione Xbox 360 Controller nas opções de input
• Verifique em Configurações → Bluetooth e dispositivos → Controle se o gamepad aparece

---

Voltar a usar no Switch 2

1. Emparelhe o controle novamente no console (botão Sync + pareamento no Switch)
2. O pareamento com o PC não é permanente — é reversível

---

Configuração opcional

Edite resources\config.yaml se quiser ajustar:

• combine_joycons — juntar Joy-Cons L+R (não se aplica ao Pro Controller)
• mouse.enabled — modo mouse nos Joy-Cons
• buttons — remapeamento de botões
• deadzone — zona morta dos analógicos

---

Problemas comuns

Problema	Solução
Erro do vgamepad	Instale a ViGEmBus v1.22.0 (link no Passo 1)
Controle não conecta	Remova do Bluetooth do Windows e use o botão Sync
pip install falha	Instale Visual Studio Build Tools com C++
Jogo não reconhece	Confirme se o Xbox 360 Controller aparece no Windows

---

Resumo rápido

cd C:\Users\SEU_USUARIO\Downloads\switch2-controllers
.venv\Scripts\activate
python gui.py

Segure Sync no controle → LEDs piscam → pronto.

[Nadeflore]

Thank you writing this guide.
I'm sorry, I didn't realize people were actually using this. I started working on this project one year ago when the switch 2 was released, but never finished it. and kind of forgot about it.
But it makes me really happy to see people are enjoying this.
I will try to find some time to improve this project and actually release a version that is easier to use.

[Nadeflore]

Also, about the input delay, I tried to reduce it the best I could, but this is mainly due to the implementation of the bluetooth BLE by windows. I found a way to reduce the polling rate, which is not perfect, but way better than the polling rate windows uses by default (going from 60 ms to more like 10-20ms) but there there are some spikes where the polling rate can get as high as 50ms) there might be a way to reduce this by setting the bluetooth configuration directly by calling lower level methods instead of relying on some preset windows defines for bluetooth BLE. But wasnt able to do it yet.

This is actually the reason I stopped working on this project, I wasn't able to get the input lag to reach a point the satisfies me. But I guess, if people are using it in this state, it's that it's not that bad.

[Nadeflore]

I just found out there is this fork, which seems to be pretty popular : https://github.com/TommyWabg/Switch2Connect/releases
It seems to be pretty advanced, and added a lots of features.
So I'm not sure there is a need to work on this original project anymore.

May I ask you why you're not using this fork ? maybe you didn't know about it is there any problem with this fork ?