secondvoice/WINDOWS_BUILD.md
StillHammer ddf34db2a0 feat: Add GLAD OpenGL loader and NVIDIA GPU forcing
Changes:
- Add GLAD dependency via vcpkg for proper OpenGL function loading
- Force NVIDIA GPU usage with game-style exports (NvOptimusEnablement)
- Create working console version (SecondVoice_Console.exe)
- Add dual executable build (UI + Console versions)
- Update to OpenGL 4.6 Core Profile with GLSL 460
- Add GPU detection and logging
- Fix GLFW header conflicts with GLFW_INCLUDE_NONE

Note: OpenGL shaders still failing to compile despite GLAD integration.
Console version is fully functional for audio capture and translation.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-21 15:18:54 +08:00

2.8 KiB

SecondVoice - Windows Build Guide

Status

Build réussi - L'application compile et s'exécute ⚠️ Problème GPU - Utilise le GPU AMD intégré au lieu du NVIDIA RTX 4060

Ce qui fonctionne

  • Compilation MinGW sans Visual Studio
  • Chargement de la configuration (config.json)
  • Initialisation de PortAudio (capture audio)
  • Création de la fenêtre GLFW
  • Pipeline de traduction démarré
  • Build statique (exe standalone de 6.5 MB)

Problème actuel : Shaders OpenGL

Les shaders GLSL ne compilent pas car Windows utilise le GPU AMD intégré au lieu du NVIDIA RTX 4060.

Diagnostic

Lancez test_opengl.exe dans build\mingw-Release\ pour voir quel GPU est utilisé :

cd build\mingw-Release
test_opengl.exe

Résultat actuel : AMD Radeon Graphics (devrait être NVIDIA GeForce RTX 4060)

Solutions

Solution 1: Lancer depuis Windows (pas depuis bash)

Le GPU NVIDIA ne sera utilisé que si vous lancez depuis Windows natif, pas depuis bash/terminal.

Double-cliquez sur le raccourci "SecondVoice" sur votre bureau créé automatiquement.

OU allez dans l'explorateur Windows :

C:\Users\alexi\Documents\projects\secondvoice\build\mingw-Release\SecondVoice.exe

Solution 2: Configuration Windows manuelle

Si le problème persiste :

  1. Windows Settings (Win + I)
  2. SystèmeAffichageGraphiques
  3. Cliquez Parcourir et sélectionnez :
    C:\Users\alexi\Documents\projects\secondvoice\build\mingw-Release\SecondVoice.exe
    
  4. Cliquez OptionsHautes performances
  5. Enregistrer

Solution 3: NVIDIA Control Panel

  1. Clic droit sur le bureau → Panneau de configuration NVIDIA
  2. Gérer les paramètres 3DParamètres du programme
  3. Ajouter → Sélectionnez SecondVoice.exe
  4. Processeur graphiqueNVIDIA haute performance
  5. Appliquer

Build

Rebuild complet

.\build_mingw.bat --clean

Build incrémental

.\build_mingw.bat

Configuration GPU (déjà fait)

powershell -ExecutionPolicy Bypass -File set_gpu.ps1

Prérequis pour exécution

  1. Clés API dans .env :

    OPENAI_API_KEY=sk-...
    ANTHROPIC_API_KEY=sk-ant-...
    
  2. Microphone connecté

  3. config.json (copié automatiquement dans build/)

Fichiers importants

  • build\mingw-Release\SecondVoice.exe - Exécutable principal (6.5 MB)
  • build\mingw-Release\test_opengl.exe - Outil de diagnostic GPU
  • build\mingw-Release\config.json - Configuration
  • build\mingw-Release\.env - Clés API (à créer)

Scripts utiles

  • build_mingw.bat - Build l'application
  • set_gpu.ps1 - Configure le GPU NVIDIA
  • create_shortcut.ps1 - Crée un raccourci bureau
  • run_secondvoice.bat - Lance l'application