Skip to content

INSTALL.md

Latest commit

 

History

History
121 lines (92 loc) · 2.57 KB

INSTALL.md

File metadata and controls

121 lines (92 loc) · 2.57 KB

🐧 PenguinTrack - Guia de Instalação Rápida

Instalação em 3 Passos

1. Preparar o Sistema

Ubuntu/Debian:

sudo apt update
sudo apt install python3 python3-pip python3-venv python3-tk

Fedora/CentOS:

sudo dnf install python3 python3-pip python3-tkinter

Arch Linux:

sudo pacman -S python python-pip tk

2. Instalar PenguinTrack

# Navegar para o diretório
cd PenguinTrack

# Executar script de instalação (recomendado)
./start.sh

# OU instalação manual:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. Executar

# Usando script
./start.sh

# OU manualmente
source .venv/bin/activate
python main.py

Teste Rápido

# Teste básico do sistema
python test_basic.py

# Teste completo (inclui câmera)
python test_system.py

# Teste receptor UDP (em terminal separado)
python udp_receiver.py

Configuração Rápida

  1. Conecte sua câmera web
  2. Inicie o PenguinTrack: ./start.sh
  3. Configure câmera: Aba "Câmera" → selecione dispositivo
  4. Ajuste sensibilidade: Aba "Rastreamento" → sensitivity 1.0-2.0
  5. Selecione protocolo: Aba "Saída" → escolha protocolo do jogo
  6. Abra avatar 3D: Clique "Mostrar Avatar" para visualização
  7. Clique "Iniciar Rastreamento"
  8. Posicione-se e clique "Reset Posição"

Solução Rápida de Problemas

❌ Câmera não funciona

# Verificar dispositivos
ls /dev/video*
# Testar câmera
ffplay /dev/video0

❌ Dependências faltando

# Reinstalar dependências
pip install -r requirements.txt --force-reinstall

❌ Detecção ruim

  • Melhore iluminação
  • Evite luz forte atrás
  • Ajuste "Suavização" para 0.3-0.5

❌ Dados não chegam ao jogo

  • FreeTrack: Verifique se jogo suporta
  • UDP: Teste com python udp_receiver.py
  • Mouse: Verifique se movimento do mouse funciona

Jogos Testados

Jogo Protocolo Configuração
DCS World FreeTrack Sensitivity: 1.5
IL-2 Sturmovik FreeTrack Sensitivity: 1.2
War Thunder Mouse Sensitivity: 2.0
Euro Truck Sim UDP IP: 127.0.0.1:4242

Performance

  • CPU mínimo: Intel i3 / AMD equivalent
  • RAM: 4GB mínimo
  • Câmera: Qualquer webcam USB
  • FPS: 30 FPS recomendado
  • Resolução: 640x480 suficiente

Suporte

  • 📖 Manual completo: README.md
  • 🧪 Testes: python test_system.py
  • 🐛 Problemas: Verifique logs no terminal
  • 💡 Dicas: Ajuste filtros para seu ambiente