updated md files

This commit is contained in:
2025-12-07 19:47:40 +01:00
parent 7e54fc2260
commit 23c68a7e6a
8 changed files with 467 additions and 33 deletions

View File

@ -1,6 +1,7 @@
# Projektstruktur & README
## 📁 Empfohlene Ordnerstruktur (Best Practice)
```text
bg1ee-tts/
├── README.md
@ -50,6 +51,7 @@ bg1ee-tts/
# 📘 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.
@ -57,58 +59,70 @@ Ziel: Dialog erscheint im Spiel → ID wird abgefangen → TTS erzeugt Audio →
---
## 🚀 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)
* 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
* **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
[https://github.com/Argent77/NearInfinity](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
[https://github.com/WeiDUorg/weidu](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
* `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`)
@ -118,28 +132,31 @@ Relevante Dateien:
---
## 📚 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)
* [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.
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
* Baldur's Gate EE Copyright © Beamdog
* [https://store.steampowered.com/app/228280](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!