Tawmae-Installation

Jede Tawmae-Extension kommt als Paket aus zwei Teilen: ein Action-Import-String für Streamer.bot und ein Browser-Source-Bundle (HTML/JS/CSS) für OBS. Beide werden lokal eingerichtet: nichts läuft in der Cloud.

Die Setup-Schritte sind für alle Extensions gleich. Wenn du eine spezifische Extension installierst, folge zusätzlich der Anleitung die du beim Kauf bekommst: manche Extensions brauchen zusätzliche API-Keys (Spotify, Twitch-Scopes) oder eigene Globals.

Was du vor dem Setup hast

Streamer.bot installiert und mit Twitch verbunden: Installation
OBS Studio 28+ mit aktiviertem WebSocket: OBS-Setup
Bot-Account im eigenen Chat als Mod: sonst können Bot-Replies nicht gesendet werden
Tawmae-Lizenz-Datei oder Activation-Key: bekommst du nach dem Kauf per E-Mail

Schritt 1 · Action-Import in Streamer.bot

Tawmae liefert pro Extension einen langen Import-String (Base64-encoded). Den importierst du wie jeden anderen Cookbook-Action-Import auch.

Top-Right Toolbar Import

Streamer.bot öffnen, oben rechts auf Import klicken
Den kompletten Tawmae-Import-String in das Eingabefeld einfügen
Auf Parse klicken: Streamer.bot zeigt eine Liste aller Actions, Sub-Actions und Triggers die importiert werden
Wichtig: Tawmae-Extensions kommen in einem eigenen Action-Order. Häkchen vor “Replace existing actions with same name” ausschalten, sonst überschreibst du deine eigenen Commands
Import bestätigen

Nach dem Import siehst du im Actions-Pane einen neuen Ordner (z.B. Tawmae · Loyalty Points). Alle Sub-Actions sind dort vorkonfiguriert.

Schritt 2 · Browser-Source in OBS einrichten

Die meisten Tawmae-Extensions kommen mit einem OBS-Overlay (Watchtime-Leaderboard, Spotify-Now-Playing, Subathon-Timer etc.). Das Overlay ist ein HTML-File das du als Browser-Source in OBS einbindest.

Tawmae-Bundle entpacken: du bekommst einen Ordner mit index.html, style.css und ggf. Asset-Files
Diesen Ordner in einen festen Pfad legen: empfohlen: C:\StreamerBot\tawmae-overlays\<extension-name>\. Nicht in Downloads lassen, sonst bricht der Pfad beim nächsten Aufräumen
In OBS in der Scene-Liste + Browser anlegen
Local file ankreuzen, auf den entpackten index.html-Pfad zeigen
Width/Height aus der Tawmae-Doku übernehmen (typisch 1920×1080 für Vollbild-Overlays, 400×200 für Widgets)
CSS im Browser-Source-Dialog leer lassen: Tawmae bringt sein eigenes CSS mit, jede Override-Regel hier bricht das Layout
Häkchen bei Shutdown source when not visible und Refresh browser when scene becomes active setzen: spart RAM und sorgt für sauberen Reconnect bei Scene-Wechsel

Schritt 3 · WebSocket-Verbindung prüfen

Tawmae-Overlays kommunizieren mit Streamer.bot über den eingebauten Streamer.bot WebSocket-Server (nicht zu verwechseln mit dem OBS-WebSocket).

Servers/Clients WebSocket Server

In Streamer.bot Servers/Clients → WebSocket Server öffnen
Status muss Listening sein, Port standardmäßig 8080
In der Browser-Source einmal auf Refresh klicken oder die Scene aus- und wieder einblenden
Im OBS-Browser-Source-Log (oder den Streamer.bot-Logs) sollte ein WebSocket connected from <overlay-name>-Eintrag stehen

Wenn das Overlay nicht verbindet:

Firewall blockt Port 8080: Ausnahme für Streamer.bot eintragen
WebSocket-Server läuft auf anderem Port: Port im Overlay-Config-File anpassen
Browser-Source zeigt schwarzen Inhalt: index.html-Pfad zeigt auf eine Datei die nicht existiert; in OBS Browser-Source neu konfigurieren

Schritt 4 · Trigger verknüpfen

Tawmae-Extensions liefern fertige Triggers (z.B. Command Triggered → !points für Loyalty Points). Du musst sie nur aktivieren:

Im Actions-Pane den importierten Tawmae-Action öffnen
Tab Triggers anklicken
Häkchen vor jedem Trigger der aktiv sein soll
Falls nötig: Command-Sources auf Twitch beschränken (Default ist Twitch+YouTube)

Manche Extensions haben Channel-Point-Reward-Trigger: die musst du erst im Twitch-Dashboard als Reward anlegen, dann in Streamer.bot Platforms → Twitch → Rewards synchronisieren und dann erst den Trigger verknüpfen. Detail in Rewards-Setup.

Schritt 5 · Test-Run

Im eigenen Chat den Hauptcommand testen (typisch !<extension-name> oder das was in der Tawmae-Anleitung steht)
Bot sollte Reply senden, Overlay sollte reagieren
Mod-Permission und Cooldown anpassen: Defaults sind oft auf 30s User-Cooldown gesetzt, je nach Extension

Wenn etwas nicht funktioniert: erst die Tawmae-Discord fragen (Setup-Probleme); für allgemeine Streamer.bot-Probleme die hiesige Troubleshooting-Section checken.

Updates einspielen

Tawmae liefert Updates entweder als neuen Import-String (manuell re-importieren, alte Actions vorher löschen oder via “Replace” überschreiben) oder als Browser-Source-Update (index.html und Assets im selben Pfad austauschen, OBS Browser-Source neu laden).

Nicht funktioniert?

Symptom	Wahrscheinliche Ursache
Overlay zeigt nur weißen Bildschirm	`index.html`-Pfad falsch oder Datei gelöscht
Overlay zeigt “Disconnected”	WebSocket-Server läuft nicht oder Firewall blockt Port
Command feuert nicht	Trigger im Action nicht aktiviert, oder Bot ist nicht im Chat
Reward triggert nicht	Reward in Twitch-Dashboard nicht angelegt oder Sync fehlt
Daten verschwinden nach Restart	Persisted-Globals nicht gespeichert: manuelle `SB.SaveGlobals()`-Sub-Action am Action-Ende einfügen
Animation ruckelt in OBS	GPU-Hardware-Acceleration in OBS-Browser-Source deaktivieren

Bei lizenzspezifischen Problemen (Activation, Renewal) ist Tawmae-Support zuständig: wir können da nichts beitragen.