Selbst betreiben

Ein Programm für einen Windows-PC, in dem alles steckt: der Server mit euren Kampagnen, der Worker, der die Aufnahmen in Text umwandelt und die Kapitel schreibt, und die App. Kein Terminal, kein Einrichtungscode, keine Verwaltung.

Die Spielenden kommen mit ihrem Handy dazu, per QR-Code im selben WLAN.

Dasselbe Programm ist auch der Worker für einen vorhandenen Server: Beim ersten Start wählst du dann „Mit einem Server verbinden“ statt „Alles auf diesem PC“. Ein zweites Programm gibt es nicht.

Was du brauchst

• Einen PC mit Windows 10 oder 11, am besten mit einer NVIDIA-Grafikkarte
• Etwa 25 GB freien Speicherplatz und mindestens 8 GB Arbeitsspeicher
• Ein eigenes WLAN, in dem der PC und die Handys der Runde sind
• Den PC eingeschaltet, solange ihr aufnehmt und die Aufnahme verarbeitet wird

1. 1

   Herunterladen und installieren

   Lade das Programm nur hier oder auf github.com/Taleward herunter und starte es. Kam die Datei auf anderem Weg zu dir, etwa per Mail, im Chat oder auf einem Stick, starte sie nicht. Windows warnt beim ersten Start mit „Der Computer wurde durch Windows geschützt“, weil das Programm vorerst nicht digital signiert ist. Klicke auf „Weitere Informationen“. Steht dort als App der Name der Datei, die du gerade heruntergeladen hast (TalewardWorker-Setup.exe), klicke auf „Trotzdem ausführen“. Steht dort etwas anderes, brich ab. Wer ganz sicher gehen will, vergleicht vorher die Prüfsumme unter dem Knopf. Quelltext und Bauprotokolle jeder Fassung sind öffentlich auf GitHub, Updates kommen danach ohne erneute Warnung. Im Installer kannst du festlegen, dass Taleward mit Windows startet.

   

   
2. 2

   „Alles auf diesem PC“ wählen

   Beim ersten Start wählst du „Alles auf diesem PC“. Hat deine Gruppe schon einen Taleward-Server, nimmst du stattdessen „Mit einem Server verbinden“. Dann arbeitet der PC nur als Worker für diesen Server.

   

   
3. 3

   PC prüfen und KI-Paket laden

   Taleward sieht nach, ob Grafikkarte, Arbeitsspeicher und Platz reichen, und schätzt, wie lange die Verarbeitung einer Runde dauert. Dann lädt es einmalig das KI-Paket, knapp 8 GB. Je nach Internet dauert das 10 bis 30 Minuten, den PC kannst du in der Zeit normal nutzen.

   Am Ende fragt Windows einmal, ob Handys in deinem WLAN Taleward erreichen dürfen. Erlaube es für private Netzwerke.

   

   

   

   
4. 4

   Dein Konto anlegen

   Mit Name und Passwort meldest du dich in Taleward an. Du bist die Spielleitung und legst deine Kampagnen an.

   Taleward ist nur in deinem WLAN erreichbar, und die Verbindung dorthin ist nicht verschlüsselt. Nutze es deshalb im eigenen WLAN, nicht im Café oder in fremden Netzen.

   

   
5. 5

   Taleward öffnen

   Taleward läuft jetzt im Hintergrund. „Taleward öffnen“ zeigt das Programmfenster: links eine Leiste mit Kampagnen, SL-Schirm, Übersicht, Verarbeitung, Sicherung und Einstellungen. Unter „Kampagnen“ legst du Kampagnen an, nimmst am PC auf oder verbindest die Handys der Runde. Wie viel Grafikspeicher Taleward nutzen darf, stellst du mit einem Schieberegler ein, der Rest bleibt fürs Spielen.

   

   

   

   
6. 6

   Die Runde einladen

   In der Kampagne zeigst du den QR-Code. Die Spielenden scannen ihn mit dem Handy, holen sich die App und sind dabei, solange sie im selben WLAN sind.

   

   

Im Alltag

Taleward sitzt unten rechts im Infobereich neben der Uhr, manchmal hinter dem kleinen Pfeil. Ein Doppelklick auf das Zeichen öffnet es. Ein Rechtsklick zeigt das Menü: Taleward öffnen, Einstellungen und Status, Verwaltung, Pausieren und Beenden. Der Punkt am Zeichen zeigt, wie es läuft:

• Grün: läuft, bereit für die nächste Runde.
• Orange: verarbeitet gerade eine Runde oder startet.
• Rot: braucht dich. Öffne Taleward, dort steht, was zu tun ist.
• Graubraun: pausiert oder angehalten, etwa kurz während eines Updates. Fortsetzen geht im selben Menü.

Updates kommen von selbst, wenn gerade nichts läuft. Vorher sichert Taleward alles, und startet eine neue Fassung nicht, geht es auf die alte zurück.

Der PC muss nicht rund um die Uhr laufen. Die Verarbeitung einer Runde kostet nur wenige Cent Strom, ein PC im Dauerbetrieb dagegen grob 4 bis 15 € im Monat. Schalte ihn ein, wenn ihr spielt und die Runde verarbeitet wird, danach darf er schlafen. Solange er schläft, ist Taleward für eure Runde nicht erreichbar.

Unter „Sicherung“ speicherst du alle Kampagnen, Runden und Bilder in eine Datei mit Passwort, etwa auf einem USB-Stick. Damit ziehst du auch auf einen neuen PC um.

Wird eure Gruppe größer, zieht die Kampagne auf einen eigenen Server um, mit allen Kapiteln und der Bibel. Die Freigabe für die Cloud erteilt die SL dort neu.

Ein fertiges Abbild für den Raspberry Pi 4 oder 5 mit 4 bis 8 GB, mit allem, was der Server braucht. Mit dem Raspberry Pi Imager auf die Speicherkarte schreiben, den Pi anschließen, im Browser taleward.local:8000 öffnen und einrichten. Ganz ohne Befehle. Lade das Abbild nur über den Knopf hier von github.com/Taleward herunter.

Die Box läuft im Heimnetz, auch ohne Internet, und aktualisiert sich mit Internet selbst. Transkribieren kann der Pi nicht, das übernimmt ein PC im selben Netz mit Taleward für Windows (als Worker) oder Linux. Die Web-App im Browser geht mit der Box nicht, die Android-App schon.

Programmieren musst du nicht, ein Terminal nach Anleitung zu benutzen reicht. Der Server steht in etwa 20 Minuten.

1. 1

   Server wählen

   Ein Linux-Server mit Docker, 4 GB Arbeitsspeicher reichen: gemietet, im Verein, zu Hause oder unter Windows 11 mit WSL. Wer mietet, braucht einen VPS, ein reiner Webhosting-Tarif reicht nicht.

   Ohne Domain läuft er nur im Heimnetz. Dann geht nur die Android-App, die Web-App im Browser nicht, und unterwegs ist der Server nicht erreichbar.

   Aus dem Internet erreichbar machen

   Dafür braucht der Server eine Domain oder Subdomain, etwa taleward.euer-verein.de, mit einem A-Eintrag auf seine IP-Adresse. Zu Hause geht das über eine Portfreigabe im Router und DynDNS.

   Reicht die Leistung, läuft der Worker gleich mit auf demselben Server.

2. 2

   Installieren

   Öffne ein Terminal auf dem Server und füge diesen Befehl ein. Das Skript fragt, ob der Server aus dem Internet oder nur im Heimnetz erreichbar sein soll, und richtet dann alles selbst ein, beim ersten Mal in 3 bis 5 Minuten.

   curl -fsSL https://raw.githubusercontent.com/Taleward/taleward-server/v0.4.165/install.sh | sudo bash

   Was das Skript dabei macht

   Es installiert Docker und baut den Server. Fürs Internet fragt es nach Adresse und einer E-Mail für das HTTPS-Zertifikat; HTTPS kommt automatisch über Caddy und Let’s Encrypt, am Ende prüft es das Zertifikat. Alle Geheimnisse erzeugt es selbst. Läuft schon ein anderer Webserver, meldet es das und bietet an, ihn abzuschalten. Unter Windows 11 richtet es WSL, Firewall und Autostart mit ein.

3. 3

   Den Einrichtungslink öffnen

   Am Ende zeigt das Skript einen einmaligen Link. Nur wer ihn hat, kann den Server einrichten:

   Im Browser öffnen:  https://taleward.euer-verein.de/verwaltung/einrichtung?code=ABCD-EFGH

   Link verloren? Dieser Befehl zeigt ihn wieder an:

   cd /opt/taleward && sudo docker compose exec server chronik einrichtungscode

4. 4

   Den Assistenten durchgehen

   Du legst deinen Zugang zur Verwaltung an. Danach führt ein Assistent durch alles Nötige. Jeder Schritt lässt sich überspringen, offene Punkte zeigt die Übersicht. Die Betriebsart kannst du später unter Einstellungen ändern.

   1. Verein oder Runde
   2. Betriebsart: Nur Cloud, Lokaler Server oder beides
   3. Zusammenfassung
   4. Datenschutzhinweis, mit Vorlage
   5. Sicherung
   6. Erste Spielleitung

   

   
5. 5

   Die SL einladen

   Im Schritt „Erste Spielleitung“ legst du ihr Konto an oder schickst ihr eine Einladung. Sie gibt in der App die Adresse eures Servers ein, etwa taleward.euer-verein.de, meldet sich an und legt in der Grundeinstellung gleich ihre Kampagne an. Ihre Runde lädt sie per Link oder QR-Code ein. Ab hier braucht es dich kaum noch.

   Einen Registrierungscode braucht dafür niemand. Ob sich Leute auch ohne Einladung ein Konto anlegen dürfen, mit einem Code oder ganz offen, und ob neue Spielleitungen erst eine Freigabe brauchen, stellst du in der Verwaltung unter Einstellungen → Neue Konten ein.

   Wer die App nicht installieren will, nutzt die Web-App im Browser unter der Adresse eures Servers mit /app/. Sie braucht HTTPS, also eine Domain; im reinen Heimnetz geht nur die Android-App.

Der Worker wandelt die Aufnahmen in Text um und schreibt auf Wunsch auch die Kapitel. Es gibt ihn auf zwei Wegen, beide lassen sich kombinieren.

In der Verwaltung: alle Worker auf einen Blick. Pausieren geht mit einem Klick, zum Beispiel während ihr am PC spielt.

Auf dem Server selbst

Hat euer Server eine NVIDIA-Grafikkarte, läuft der Worker gleich mit darauf. Das Installationsskript erkennt die Karte und richtet alles ein, auf Wunsch auch ein lokales Sprachmodell für die Kapitel. Ohne Grafikkarte geht es mit dem Prozessor, aber langsam.

Auf einem PC mit Windows oder Linux

Unter Windows nimmst du dasselbe Programm wie oben, Taleward für Windows, und wählst beim ersten Start „Mit einem Server verbinden“. Dann trägst du die Adresse des Servers und den Kopplungscode ein, den es in der Verwaltung unter „Transkription → Weiteren Worker anbinden“ gibt. Den Rest erledigt das Programm. Ein Schieberegler legt fest, wie viel Grafikspeicher Taleward nutzen darf, der Rest bleibt fürs Spielen. Mit „Kapitel auch auf diesem PC schreiben“ übernimmt es auch die Kapitel, ganz ohne Cloud. Zwischen „Alles auf diesem PC“ und „Mit einem Server verbinden“ wechselst du später in den Einstellungen des Programms. Für Linux gibt es ein Skript, siehe unten.

Im Router muss nichts freigegeben werden. Der Worker meldet sich selbst beim Server und fragt nach Arbeit. Ist er aus, warten die Aufnahmen, bis er wieder läuft. Ein Konto bei Hugging Face braucht ihr nicht: Das Modell, das die Stimmen auseinanderhält, lädt der Server geprüft von taleward.org und gibt es an die Worker weiter.

Der PC muss dafür nicht rund um die Uhr laufen. Die Verarbeitung einer Runde kostet nur wenige Cent Strom, ein Spiele-PC im Dauerbetrieb dagegen grob 4 bis 15 € im Monat. Lass ihn nach der Arbeit schlafen oder schalte ihn ein, wenn eine Runde wartet.

curl -fsSL https://raw.githubusercontent.com/Taleward/taleward-worker/worker-v0.3.25/install-linux.sh | bash

Der Taleward-Bot nimmt Online-Runden im Sprachkanal von Discord auf, eine Spur je Person, nur mit Zustimmung jeder einzelnen Person. Der Bot hinter dem Knopf auf taleward.org arbeitet nur mit dem Community-Server. Betreibt ihr einen eigenen Taleward-Server, betreibt ihr auch den Bot selbst. Er gehört dann zu genau eurem Server, und wer ihn betreibt, ist für ihn verantwortlich.

Das braucht ihr

• Euren Taleward-Server ab Fassung 0.4.162, unter einer https-Adresse
• Eine Linux-Maschine mit Docker. Der Server, auf dem Taleward läuft, reicht.
• Eine eigene Anwendung im Entwicklerportal von Discord
• Den Bot-Schlüssel aus der Verwaltung (Discord-Bot → Schlüssel erzeugen)
• Etwa 30 Minuten

Datenschutzerklärung und Nutzungsbedingungen für den Bot bringt euer Server als Vorlage mit, ihr passt sie in der Verwaltung an. Der Bot ist freie Software (AGPL-3.0) wie App und Server.

Die Betriebsart legt fest, wo eure Runden verarbeitet werden. Du wählst sie im Assistenten und kannst sie später unter Einstellungen ändern. Für Cloud-Dienste gilt immer: Die SL erlaubt sie je Kampagne, standardmäßig sind sie aus.

• Lokaler Server

  Euer Server und ein Worker, zum Beispiel ein PC mit Grafikkarte im Verein oder zu Hause, verarbeiten alles. Mit Taleward für Windows steckt beides in einem PC. Nichts geht nach außen. So ist Taleward gedacht.

  Nur Strom, wenige Cent je Runde.

  Das braucht ihr

  • Einen Server (Box oder Linux mit Docker) und mindestens einen Worker: auf dem Server selbst oder auf einem PC mit Taleward für Windows oder Linux
  • Am besten eine NVIDIA-Grafikkarte ab der GTX-10-Reihe mit Treiber ab Version 528: ab 2 GB, gut ab 6 GB. Ohne sie rechnet der Prozessor, grob 4 bis 10 Stunden für 4 Stunden Aufnahme
  • Für Kapitel ohne Cloud: ein lokales Sprachmodell, ab 6 GB Grafikspeicher oder 16 GB Arbeitsspeicher; Skript oder Taleward für Windows richten es ein

• Lokaler Server, Cloud als Ausweichlösung

  Der lokale Server macht die Arbeit. Ist er länger nicht erreichbar, springt die Cloud ein, sofern die Kampagne es erlaubt.

  Kosten nur, wenn die Cloud einspringt, dann etwa 1 € je Runde.

  Das braucht ihr

  • Alles aus „Lokaler Server“
  • Dazu einen Mistral-Schlüssel, für die Zusammenfassung wahlweise einen anderen Anbieter
  • Die Erlaubnis der SL je Kampagne, dass die Cloud einspringen darf

• Nur Cloud

  Transkription über Mistral (EU), Zusammenfassung über Mistral oder einen anderen Anbieter. Kein lokaler Server nötig.

  Etwa 1 € je Runde von vier Stunden, mit monatlichem Kostenlimit, dazu die Miete für den Server.

  Das braucht ihr

  • Den Server wie bei „Lokaler Server“, aber ohne Worker
  • Einen Schlüssel von Mistral (EU) für die Transkription; für die Zusammenfassung Mistral oder einen anderen Anbieter
  • Ein monatliches Kostenlimit, das du im Assistenten festlegst

Der Server aktualisiert sich nachts selbst auf die neueste freigegebene Fassung, mit Sicherung vorher und Rückweg, falls die neue Fassung nicht startet. Abschalten oder sofort aktualisieren geht unter Verwaltung → Updates. Von Hand auf dem Server:

cd /opt/taleward && sudo ./aktualisieren.sh --jetzt

App und Worker kommen ebenfalls über euren Server. Worker aktualisieren sich dann selbst, die App zeigt einen Hinweis.

Jede Nacht sichert der Server alle Daten, die letzten 14 Tage bleiben, allerdings auf demselben Server. Lade deshalb regelmäßig eine Sicherung herunter (Verwaltung → Übersicht → Sicherung).

Mit zweitem Faktor (Verwaltung → Anmeldung) fragt die Verwaltung nach dem Passwort einen Code aus der Authenticator-App ab. Statt des Codes geht auch ein Passkey: Windows Hello am PC, Fingerabdruck oder Gesicht am Handy oder ein Sicherheitsschlüssel. Das geht nur, wenn der Server unter einer https-Adresse läuft.