Einrichtungsanleitung

Konto bei Hetzner Cloud erstellen, neuen Server mit Ubuntu 24.04 (CX22 ≈ 4,50 €/Monat).

Per SSH verbinden und Icecast installieren:

ssh root@DEINE-SERVER-IP
apt update && apt install -y icecast2

Bei der Installation Source- und Admin-Passwort vergeben. Die mitgelieferte icecast.xml nach /etc/icecast2/icecast.xml kopieren, Passwörter eintragen, dann:

systemctl enable icecast2
systemctl start icecast2
ufw allow 8000

Test: http://DEINE-IP:8000 im Browser öffnen.

Wichtig fürs Handy – sonst blockiert der Browser den Audio-Stream.

apt install -y nginx certbot python3-certbot-nginx

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

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;
    }
}

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

In src/lib/stream-config.ts die Zeile ändern:

streamUrl: "https://uebersetzung.eure-moschee.de/stream/urdu"

Dann das Projekt neu veröffentlichen.

BUTT herunterladen: danielnoethen.de/butt (Windows, macOS, Linux).

Settings → 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

Settings → Audio: Mikrofon wählen, Codec MP3, Bitrate 64 kbps, Samplerate 44100.

Großen Play-Knopf drücken → „Connected".

Auf qr.io die Webseiten-URL eingeben, QR-Code ausdrucken und mit Kurzanleitung am Eingang aufhängen:

„Für Urdu-Übersetzung: QR-Code scannen, Kopfhörer anschließen, Play drücken."

• ☐Server läuft, Icecast-Statusseite erreichbar
• ☐HTTPS-Zertifikat aktiv
• ☐Stream-URL in der Webseite eingetragen
• ☐BUTT auf Dolmetscher-Laptop zeigt „Connected“
• ☐Test-Wiedergabe auf einem Handy erfolgreich
• ☐WLAN in der Moschee stabil
• ☐QR-Code gedruckt und aufgehängt
• ☐Leih-Kopfhörer (optional) vorbereitet

Kein Ton im Browser? Prüfen, ob BUTT „Connected" zeigt und ob https://eure-domain/stream/urdu direkt im Browser Audio liefert.

Stream bricht ab? In BUTT → Settings → Main die Auto-Reconnect-Funktion aktivieren.

Latenz zu hoch? BUTT-Buffer minimieren, in Icecast burst-size reduzieren, oder Codec auf Opus stellen.