# Moschee Live-Übersetzung – Einrichtungsanleitung (Deutsch → Urdu)

## Übersicht

Das System besteht aus drei Teilen:

1. **Icecast-Server** – verteilt den Audiostream an alle Zuhörer
2. **BUTT (Broadcast Using This Tool)** – Software für den Dolmetscher zum Senden
3. **Diese Webseite** – Zuhörer öffnen sie und hören zu

```
Dolmetscher (BUTT + Mikrofon)
        │
        ▼
   Icecast-Server (VPS / Raspberry Pi)
        │
        ▼
   Webseite ← Zuhörer (Handy + Kopfhörer)
```

---

## Schritt 1: Server einrichten

### Hetzner Cloud VPS (empfohlen, ca. 4,50 €/Monat)

1. Hetzner-Konto erstellen: https://www.hetzner.com/cloud
2. Neuen Server: Ubuntu 24.04, CX22 (kleinster)
3. Per SSH verbinden: `ssh root@DEINE-SERVER-IP`
4. Icecast installieren: `apt update && apt install -y icecast2`
5. Bei der Installation Source- und Admin-Passwort vergeben
6. Mitgelieferte `icecast.xml` nach `/etc/icecast2/icecast.xml` kopieren und Passwörter eintragen
7. Starten: `systemctl enable icecast2 && systemctl start icecast2`
8. Firewall: `ufw allow 8000`
9. Testen: `http://DEINE-IP:8000` im Browser → Icecast-Statusseite

---

## Schritt 2: HTTPS einrichten

Moderne Browser blockieren Mixed Content. Webseite **und** Stream müssen per HTTPS laufen.

```bash
apt install -y nginx certbot python3-certbot-nginx
```

`/etc/nginx/sites-available/translation`:

```nginx
server {
    server_name uebersetzung.eure-moschee.de;

    location / {
        root /var/www/translation;
        index index.html;
    }

    location /stream/ {
        proxy_pass http://127.0.0.1:8000/;
        proxy_set_header Host $host;
        proxy_buffering off;
        proxy_read_timeout 86400s;
    }
}
```

```bash
ln -s /etc/nginx/sites-available/translation /etc/nginx/sites-enabled/
certbot --nginx -d uebersetzung.eure-moschee.de
systemctl restart nginx
```

Stream-URL ist dann: `https://uebersetzung.eure-moschee.de/stream/urdu`

---

## Schritt 3: Stream-URL in die Webseite eintragen

In der Datei `src/lib/stream-config.ts` die Zeile

```ts
streamUrl: "https://DEIN-SERVER/stream/urdu",
```

durch eure echte URL ersetzen und neu veröffentlichen.

---

## Schritt 4: Dolmetscher einrichten (BUTT)

### Download
https://danielnoethen.de/butt/ (Windows, macOS, Linux)

### Konfigurieren

1. BUTT öffnen → **Settings**
2. Tab **Main → Server → Add**:
   - Type: Icecast
   - Address: eure Domain (z.B. `uebersetzung.eure-moschee.de`)
   - Port: `443` (mit SSL) oder `8000` (direkt)
   - Password: das Source-Passwort
   - Mountpoint: `/urdu`
   - Icecast User: `source`
3. Tab **Audio**:
   - Audio Device: Mikrofon des Dolmetschers
   - Codec: **MP3** (beste Browser-Kompatibilität) oder Opus
   - Bitrate: 64 kbps reicht für Sprache
   - Samplerate: 44100
4. Großen **Play**-Button drücken → "Connected"

---

## Schritt 5: QR-Code für die Moschee

1. Auf https://qr.io eure Webseiten-URL eingeben
2. QR-Code ausdrucken und am Eingang aufhängen mit Text:
   > „Für Übersetzung ins Urdu: QR-Code scannen, Kopfhörer anschließen, Play drücken."

---

## Checkliste

- [ ] Server läuft, Icecast-Statusseite erreichbar
- [ ] HTTPS-Zertifikat aktiv
- [ ] Stream-URL in der Webseite eingetragen
- [ ] BUTT verbindet sich erfolgreich („Connected")
- [ ] Audio kommt im Handy-Browser an
- [ ] WLAN in der Moschee stabil
- [ ] QR-Code gedruckt und aufgehängt
- [ ] Dolmetscher eingewiesen

---

## Fehlerbehebung

**Kein Ton?**
- BUTT zeigt „Connected"?
- `https://eure-domain/stream/urdu` direkt im Browser öffnen – kommt Ton?
- Stream-URL in `stream-config.ts` korrekt?

**Abbrüche?**
- BUTT → Settings → Main → Reconnect aktivieren
- Internetverbindung des Dolmetschers prüfen

**Latenz zu hoch?**
- BUTT-Buffer minimieren
- Icecast `burst-size` reduzieren
- Codec auf Opus stellen