============================================================
 TAMPA DE PANELA - RECEPTOR PARA WINDOWS
 Guia rapido de instalacao e conexao
============================================================

Requisitos
----------
- Windows 10 ou Windows 11, 64 bits (x64)
- Celular Android 8.0 ou superior com o app Tampa de Panela
- Celular e PC conectados na MESMA rede Wi-Fi
- Permissao de administrador para instalar o driver ViGEmBus

O que este pacote contem
------------------------
- O receptor Windows completo (codigo-fonte + servidor na porta 5002).
- O script install_vigembus.bat, que baixa e executa o instalador
  oficial do driver ViGEmBus.
- O script start_windows.bat, que inicia o receptor usando Python.
- O script build_windows_exe.py, que compila o executavel autonomo
  TampaDePanela-Server-Windows.exe em um PC com Windows.
- Os guias LEIA-ME.txt, DRIVER-VIGEMBUS.txt, REDE-E-FIREWALL.txt e
  INSTRUCOES.md.

Passo 1 - Instalar o driver ViGEmBus
------------------------------------
1. Clique com o botao direito em install_vigembus.bat e escolha
   "Executar como administrador".
2. O script baixa o instalador x64 mais recente da pagina oficial:
   https://github.com/nefarius/ViGEmBus/releases/latest
3. Aceite a elevacao do Windows e conclua a instalacao.
4. REINICIE o computador para carregar o driver.

Se preferir instalar manualmente, baixe o arquivo x64 (.msi ou .exe)
na pagina oficial, execute como administrador e reinicie o PC.

O ViGEmBus e um driver de codigo aberto (licenca BSD-3-Clause)
mantido pelo projeto Nefarius. Ele nao envia dados para a internet e
permite que programas criem um controle Xbox virtual reconhecido
pelos jogos.

Passo 2 - Iniciar o receptor
----------------------------
Opcao A - Executavel autonomo (sem Python):
  Execute TampaDePanela-Server-Windows.exe. O icone aparece na
  bandeja do sistema, perto do relogio. Clique nele para abrir o
  painel ou ver o endereco.

Opcao B - Pelo codigo-fonte (requer Python 3.10+):
  Execute start_windows.bat. Na primeira vez ele cria um ambiente
  virtual e instala as dependencias; depois e so abrir de novo.

Opcao C - Compilar o seu proprio executavel (requer Python):
  python build_windows_exe.py
  O arquivo final fica em dist\TampaDePanela-Server-Windows.exe.

Ao iniciar, o receptor mostra o endereco e um QR Code, por exemplo:
  ws://192.168.0.10:5002/ws

Passo 3 - Conectar o celular no mesmo Wi-Fi
-------------------------------------------
1. No celular, abra o app Tampa de Panela.
2. Va em Configuracoes e localize o campo de endereco do receptor.
3. Digite o endereco no formato:
     ws://IP-DO-PC:5002/ws
   Exemplo: ws://192.168.0.10:5002/ws
4. Para descobrir o IP do PC, abra o Prompt de Comando e execute:
     ipconfig
   Use o valor de "Endereco IPv4" do adaptador Wi-Fi.
5. Toque em conectar. O HUD do app deve exibir CONECTADO.

Ate dois celulares podem jogar ao mesmo tempo: o primeiro vira P1 e
o segundo vira P2, cada um com seu proprio controle Xbox virtual.

Passo 4 - Pilote
----------------
Com o driver instalado e o celular conectado, o PC reconhece o celular
como um controle Xbox nativo. Abra seu jogo de corrida (Steam, Game
Pass, Epic Games) e o controle ja aparece na lista de dispositivos.

Problemas comuns
----------------
- O app nao conecta: confirme que celular e PC estao na mesma rede e
  que o firewall liberou a porta 5002 (veja REDE-E-FIREWALL.txt).
- O controle nao aparece no jogo: reinicie o PC apos instalar o ViGEmBus
  e confira o Gerenciador de Dispositivos em "Dispositivos de jogo".
- Redes de convidados costumam isolar os aparelhos entre si. Use a rede
  principal da casa.
- O log detalhado fica em:
  %LOCALAPPDATA%\TampaDePanela\logs\receptor.log

Suporte
-------
A versao atualizada deste pacote e do receptor esta sempre na pagina
oficial de downloads do Tampa de Panela.

Licenca do receptor: GPL-3.0.
============================================================
