# Projektstruktur & README

## 📁 Empfohlene Ordnerstruktur (Best Practice)
```text
bg1ee-tts/
├── README.md
├── docs/
│   ├── architecture.md
│   ├── extraction-guide.md
│   ├── tools-installation.md
│   └── lua-hook-spec.md
├── data/
│   ├── raw/
│   │   ├── tlk/
│   │   │   ├── dialog_de.tlk
│   │   │   └── dialog_en.tlk
│   │   └── dlg/
│   ├── processed/
│   │   └── dialogs.json
│   └── mappings/
│       └── npc_map.json
├── scripts/
│   ├── extract_tlk.py
│   ├── parse_dlg.py
│   ├── build_database.py
│   └── selftest.py
├── tts-service/
│   ├── app/
│   │   ├── main.py
│   │   ├── engines/
│   │   ├── cache/
│   │   └── playback/
│   ├── tests/
│   └── requirements.txt
├── lua-hook/
│   ├── bg1ee_tts_hook/
│   │   ├── dialog.lua
│   │   └── mod.ini
│   └── build_instructions.md
├── audio/
│   ├── de/
│   └── en/
└── tools/
    ├── NearInfinity.jar
    └── weidu/
```

---

# 📘 README.md

## 🎯 BG1EE Dual‑Language TTS Projekt
Dieses Repository enthält die vollständige Infrastruktur, um **Baldur's Gate Enhanced Edition (Steam)** automatisch in **Deutsch** und **Englisch** zu vertonen – live während des Spielens, mit Umschaltung per Hotkey.

Ziel: Dialog erscheint im Spiel → ID wird abgefangen → TTS erzeugt Audio → Audio wird abgespielt.

---

## 🚀 Features
- Extraktion aller BG1EE‑Texte (DE & EN)
- Parser für TLK + DLG Dateien → JSON‑Datenbank
- TTS‑Backend mit mehreren Engines (Melo, Kokoro, F5‑TTS, Piper)
- Live‑Integration via Lua‑Dialoghook
- Plattformunabhängig (Linux: Entwicklung / Windows: Spielen)

---

## 🧩 Voraussetzungen
Du benötigst:
- **Baldur's Gate: Enhanced Edition (Steam)**
- **Java 17+** (für Near Infinity)
- **Python 3.10+**
- **FastAPI**
- Optional: GPU‑TTS Engines

---

## 🔧 Installation externer Tools
### Near Infinity (TLK + DLG Viewer/Exporter)
Download:
https://github.com/Argent77/NearInfinity

```
wget https://github.com/Argent77/NearInfinity/releases/latest/download/NearInfinity.jar
```

### WeiDU (Modding Toolkit)
Download:
https://github.com/WeiDUorg/weidu

---

## 📥 BG1EE Dateien finden (Steam)
Linux‑Pfad:
```
~/.steam/steam/steamapps/common/Baldur's Gate Enhanced Edition/data/
```
Windows‑Pfad:
```
C:\Program Files (x86)\Steam\steamapps\common\Baldur's Gate Enhanced Edition\data
```

Relevante Dateien:
- `lang/de_DE/dialog.tlk`
- `lang/en_US/dialog.tlk`
- `dialog.bif`
- sämtliche `.dlg` Dateien

---

## 🏗️ Projektaufbau
1. **TLK & DLG exportieren** (Near Infinity)
2. **Parser ausführen** → erzeugt `dialogs.json`
3. **TTS‑Service starten** (`uvicorn app.main:app`)
4. **Lua‑Hook als Mod installieren**
5. Spiel starten → Vertonung läuft automatisch

---

## 📚 Dokumentation
- [docs/architecture.md](docs/architecture.md)
- [docs/extraction-guide.md](docs/extraction-guide.md)
- [docs/tools-installation.md](docs/tools-installation.md)
- [lua-hook-spec.md](docs/lua-hook-spec.md)

---

## 📜 Rechtliches
Dieses Projekt enthält **keine Originalspieldateien**.  
Alle Extraktionen müssen lokal auf einem legal erworbenen BGEE‑Spiel erfolgen.  
Siehe:
- Baldur's Gate EE Copyright © Beamdog
- https://store.steampowered.com/app/228280

Quellenverlinkungen enthalten nur **offizielle** Hersteller‑Seiten.

---

## 🤝 Mitwirken
PRs, Issues und Erweiterungen willkommen. Dies ist ein technisches Forschungs‑ und Hobbyprojekt.

---

Fertig!