StillHammer
94ad6b4a22
Lightweight Windows build option using MinGW-w64 instead of Visual Studio: Size Comparison: - Visual Studio: 10-20 GB install - MinGW: ~500 MB install (20x smaller!) New Files: - setup_mingw.bat: One-click installer for all tools - Chocolatey (package manager) - MinGW-w64 (GCC compiler) - CMake, Ninja, Git - vcpkg integration - build_mingw.bat: Build script for MinGW - Auto-detection of GCC - Debug/Release modes - Clean build support - User-friendly error messages - WINDOWS_MINGW.md: Complete MinGW guide - Installation instructions - Troubleshooting - Performance comparison MSVC vs GCC - Distribution guide CMake Updates: - Added mingw-debug and mingw-release presets - GCC compiler flags: -O3 -Wall -Wextra - Static linking for portable .exe Documentation: - Updated WINDOWS_QUICK_START.md with MinGW option - Comparison table: MinGW vs Visual Studio - Recommendation: MinGW for most users Benefits: - 20x smaller download (500MB vs 10-20GB) - 5-10 min install vs 30-60 min - Same performance as MSVC - Portable standalone .exe - Perfect for users without Visual Studio Usage: 1. Run setup_mingw.bat (one time) 2. Restart terminal 3. Run build_mingw.bat --release 4. Done! Output: build/mingw-release/SecondVoice.exe 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
192 lines
3.7 KiB
Markdown
192 lines
3.7 KiB
Markdown
# 🚀 Windows Quick Start Guide
|
|
|
|
**Get SecondVoice running on Windows in 5 steps!**
|
|
|
|
---
|
|
|
|
## 💡 Choose Your Compiler
|
|
|
|
You have **two options**:
|
|
|
|
| Option | Size | Install Time | Recommended For |
|
|
|--------|------|--------------|----------------|
|
|
| **MinGW** (GCC) | ~500 MB | 5-10 min | ⭐ **Most users** |
|
|
| Visual Studio (MSVC) | 10-20 GB | 30-60 min | Professional devs |
|
|
|
|
**Recommendation**: Use **MinGW** - it's 20x smaller and works perfectly!
|
|
|
|
---
|
|
|
|
## ⚡ Option A: MinGW (Recommended - 500MB)
|
|
|
|
### One-Click Setup
|
|
|
|
Open **PowerShell as Administrator**:
|
|
|
|
```powershell
|
|
cd "E:\Users\Alexis Trouvé\Documents\Projets\secondvoice"
|
|
.\setup_mingw.bat
|
|
```
|
|
|
|
This installs everything automatically. Then:
|
|
|
|
```powershell
|
|
# Restart PowerShell
|
|
copy .env.example .env
|
|
notepad .env # Add API keys
|
|
.\build_mingw.bat --release
|
|
cd build\mingw-release
|
|
.\SecondVoice.exe
|
|
```
|
|
|
|
**Done!** See [WINDOWS_MINGW.md](WINDOWS_MINGW.md) for details.
|
|
|
|
---
|
|
|
|
## ⚡ Option B: Visual Studio (10-20GB)
|
|
|
|
### 1. Install Visual Studio 2022 Community (Free)
|
|
👉 https://visualstudio.microsoft.com/downloads/
|
|
|
|
During installation, select:
|
|
- ✅ **Desktop development with C++**
|
|
|
|
### 2. Install vcpkg
|
|
Open **PowerShell as Administrator**:
|
|
```powershell
|
|
cd C:\
|
|
git clone https://github.com/microsoft/vcpkg.git
|
|
cd vcpkg
|
|
.\bootstrap-vcpkg.bat
|
|
setx VCPKG_ROOT "C:\vcpkg"
|
|
```
|
|
|
|
**⚠️ Important**: Close and reopen PowerShell after setting `VCPKG_ROOT`
|
|
|
|
---
|
|
|
|
## 🔧 Build SecondVoice (1-2 minutes)
|
|
|
|
### 1. Clone the project
|
|
```powershell
|
|
cd "E:\Users\Alexis Trouvé\Documents\Projets"
|
|
git clone <repository-url> secondvoice
|
|
cd secondvoice
|
|
```
|
|
|
|
### 2. Create your API keys file
|
|
```powershell
|
|
copy .env.example .env
|
|
notepad .env
|
|
```
|
|
|
|
Add your keys:
|
|
```
|
|
OPENAI_API_KEY=sk-...
|
|
ANTHROPIC_API_KEY=sk-ant-...
|
|
```
|
|
|
|
### 3. Build!
|
|
```powershell
|
|
build.bat --release
|
|
```
|
|
|
|
**First build takes 5-10 minutes** (downloads dependencies).
|
|
|
|
---
|
|
|
|
## ▶️ Run SecondVoice
|
|
|
|
```powershell
|
|
cd build\windows-release\Release
|
|
SecondVoice.exe
|
|
```
|
|
|
|
**That's it!** 🎉
|
|
|
|
---
|
|
|
|
## 🎯 What to Expect
|
|
|
|
1. **ImGui window opens** with "SecondVoice - Live Translation"
|
|
2. **Recording starts** automatically
|
|
3. **Speak Chinese** into your microphone
|
|
4. **Transcription appears** in blue (中文)
|
|
5. **Translation appears** in green (FR)
|
|
6. **Click "STOP RECORDING"** when done
|
|
7. **Audio saved** to `recordings/` folder
|
|
|
|
---
|
|
|
|
## ⚙️ Quick Configuration
|
|
|
|
Edit `config.json` to customize:
|
|
|
|
```json
|
|
{
|
|
"audio": {
|
|
"chunk_duration_seconds": 10 // Lower = faster updates (5-30s)
|
|
},
|
|
"whisper": {
|
|
"model": "gpt-4o-mini-transcribe", // Or "gpt-4o-transcribe" for best quality
|
|
"prompt": "Add your context here (names, topics, etc.)"
|
|
}
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 🐛 Troubleshooting
|
|
|
|
### "VCPKG_ROOT not set"
|
|
```powershell
|
|
setx VCPKG_ROOT "C:\vcpkg"
|
|
# Restart PowerShell
|
|
```
|
|
|
|
### "cl.exe not found"
|
|
Open **Visual Studio Developer Command Prompt** instead of regular PowerShell.
|
|
|
|
### "No audio device found"
|
|
1. Check microphone is connected
|
|
2. Go to **Settings → Sound → Input**
|
|
3. Test your microphone
|
|
|
|
### Build fails with dependency errors
|
|
```powershell
|
|
build.bat --clean --release
|
|
```
|
|
|
|
---
|
|
|
|
## 📊 Costs
|
|
|
|
- **Whisper API**: $0.006/minute (~$0.36/hour)
|
|
- **Claude API**: ~$0.04/hour
|
|
- **Total**: **~$0.40/hour** of recording
|
|
|
|
Very affordable for the value! 💰
|
|
|
|
---
|
|
|
|
## 📚 Need More Help?
|
|
|
|
- **Full Windows guide**: `docs/build_windows.md`
|
|
- **General docs**: `docs/next_steps.md`
|
|
- **Whisper upgrade**: `docs/whisper_upgrade.md`
|
|
|
|
---
|
|
|
|
## 🎉 You're Ready!
|
|
|
|
Test it with:
|
|
1. **Sample Chinese audio** (YouTube, recordings)
|
|
2. **Real conversation** with Chinese speakers
|
|
3. **Important meeting** where you need translation
|
|
|
|
Good luck with your first meeting! 🚀
|
|
|
|
---
|
|
|
|
*Quick start version - Last updated: 20 novembre 2025*
|