# PoE Auth Tool

Standalone-Tool zum Authentifizieren mit Path of Exile (GGG OAuth) und Übertragen des Tokens an den POB AI Chat-Server.

**Version:** 1.0.0  
**Datum:** 2026-06-23  
**Geändert:** 2026-06-23  
**Autor:** Marco Hansen

## Beschreibung

Das Tool öffnet einen lokalen OAuth 2.0 PKCE Flow mit den GGG-Servern, fängt den Callback ab, tauscht den Authorization Code gegen einen Access Token und sendet diesen an den konfigurierten POB AI Chat-Server. Es ist keine eigene GGG-App-Registrierung nötig – es verwendet die `client_id` des Path of Building 2 Clients.

## Voraussetzungen

- Python 3.8 oder neuer
- `tkinter` (auf Windows in Python enthalten; auf Linux: `apt install python3-tk`)
- `requests`-Bibliothek

## Windows

### Einfach (empfohlen)
1. ZIP herunterladen und entpacken
2. `PoE-Auth-Tool.exe` starten
3. Optional einen Username eingeben und "Mit PoE anmelden" klicken

### Mit Python
1. `pip install requests`
2. `python poe-auth-tool.py`

## Linux

```bash
sudo apt install python3-tk
pip install requests
python3 poe-auth-tool.py
```

## Verwendung

1. Optional einen **Username** eingeben
2. Button **"Mit Path of Exile anmelden"** klicken
3. Browser öffnet sich → bei GGG einloggen und Berechtigungen bestätigen
4. Tool überträgt den Token automatisch an `https://poecheck.taz-clan.de`

## Parameter / Konfiguration

| Feld | Beschreibung | Standard |
|------|-------------|---------|
| Username | Optionaler Anzeigename im Chat | *(leer)* |

Der Chat-Server ist fest auf `https://poecheck.taz-clan.de` eingestellt.

## OAuth-Details

| Parameter | Wert |
|-----------|------|
| `client_id` | `pob` |
| Flow | PKCE (kein client_secret) |
| Scopes | `account:profile account:leagues account:characters account:trade` |
| Callback-Ports | `49082`, `49083`, `49084` (erster freier Port wird verwendet) |
| Timeout | 5 Minuten |

## Troubleshooting

**Browser öffnet sich nicht**  
Die OAuth-URL wird im Status-Feld angezeigt. URL manuell kopieren und im Browser öffnen.

**Port bereits belegt**  
Das Tool versucht automatisch alle drei Ports (49082–49084). Wenn alle belegt sind, erscheint eine Fehlermeldung.

**Chat-Server nicht erreichbar**  
Prüfen ob `https://poecheck.taz-clan.de` erreichbar ist.

**Token-Fehler von GGG**  
Seite neu laden und Vorgang wiederholen. Bei wiederholten Fehlern GGG-Serverstatus prüfen.

## Build zu .exe (Windows)

```bash
pip install pyinstaller
pyinstaller --onefile --noconsole poe-auth-tool.py
```

Die fertige `.exe` befindet sich im `dist/`-Ordner und läuft ohne Python-Installation.

## Dateien

| Datei | Beschreibung |
|-------|-------------|
| `poe-auth-tool.py` | Hauptscript mit GUI und OAuth Flow |
| `requirements.txt` | Python-Abhängigkeiten |
| `README.md` | Diese Anleitung |
