Installation

~5 Min

Was du lernst

• Streamer.bot herunterladen und entpacken
• Twitch-OAuth und OBS-WebSocket verbinden

Streamer.bot ist Portable-Software. Kein Installer, kein Registry-Eintrag. Du entpackst ein Archiv und startest die .exe. Das dauert fünf Minuten. Den Rest der Zeit verbringst du mit dem Twitch-OAuth-Flow und der OBS-Verbindung.

System-Voraussetzungen

Plattform	Status	Hinweis
Windows 10 / 11	Voll supported	Empfohlene Plattform
macOS 12+	Beta (ab v1.1)	Manche Sub-Actions sind Windows-only, z.B. Streamlabs-Bridge
Linux	Community-Build	Über Wine oder native Build; weniger getestet
Streamer.bot Version	v1.0.4 oder neuer	Die Sub-Action-Pfade in diesem Cookbook gelten ab v1.0.4
OBS Studio (optional)	28 oder neuer	obs-websocket v5 ist ab OBS 28 eingebaut

v2.0 ist in Arbeit

Streamer.bot v2.0 wird viele Sub-Action-Pfade umbenennen. Wenn du heute startest, nimm v1.0.4+. Migrations-Hinweise kommen sobald v2.0 stabil ist.

1. Download

Es gibt nur eine offizielle Quelle:

Quelle	URL
Offizielle Site	streamer.bot
Direkt-Download	streamer.bot/download
Discord (für Beta-Builds)	discord.streamer.bot

Lade die ZIP für dein OS herunter (z.B. streamer.bot-1.0.4.zip).

Antivirus-Warnung beim Download

Manche Antivirus-Programme markieren die ZIP false-positive (unsigniertes Indie-Tool). Wenn dein Browser den Download blockt, ladest du erneut und whitelistest die Datei. Eine signierte Build-Variante ist auf der Roadmap.

2. Entpacken

Wähle einen Pfad ohne Leerzeichen und ohne Sonderzeichen: also nicht in Programme (x86) oder OneDrive\Mein Stream. Stattdessen:

D:\Tools\StreamerBot\

Warum: Streamer.bot speichert relative Pfade in den Settings. Leerzeichen plus Sonderzeichen plus OneDrive-Sync ist die Kombination, die später für “Action lädt nicht” sorgt.

Ergebnis nach dem Entpacken:

D:\Tools\StreamerBot\
├── Streamer.bot.exe        ← die starten
├── data\                   ← Settings + Actions landen hier
├── logs\
└── ...

3. Erster Start

Doppelklick auf Streamer.bot.exe. Beim ersten Start:

1. Windows-Defender / SmartScreen fragt eventuell nach Bestätigung: Weitere Informationen → Trotzdem ausführen.
2. Das Hauptfenster öffnet mit leerem Actions-Pane.
3. Unten links siehst du den Connection-Status (alles rot/grau: noch nichts verbunden).

Fenster-Layout

Streamer.bot ist Dockable. Wenn du Panes verschoben hast und das Layout zerschossen ist: F12 öffnet die Konsole, im Hauptmenü View → Reset Layout setzt alles zurück.

4. Twitch-Account verbinden

Hauptmenü → Platforms → Twitch. Es öffnet sich der Platform-Pane mit zwei Account-Slots:

Slot	Wofür	Empfehlung
Broadcaster	Dein Streamer-Account: für Subs/Follows/Stream-Info	Pflicht
Bot	Separater Bot-Account: postet Chat-Nachrichten	Stark empfohlen

Broadcaster verbinden

1. Im Broadcaster-Slot: Button Login.
2. Browser öffnet id.twitch.tv mit Scope-Liste.
3. Du musst eingeloggt sein mit deinem Streamer-Account (nicht Bot!).
4. Scopes durchlesen, Autorisieren klicken.
5. Browser-Tab schließt sich, Streamer.bot ist verbunden: grüner Indikator im Pane.

Bot-Account verbinden

Gleicher Flow, aber mit dem Bot-Account einloggen. Falls du noch keinen Bot-Account hast: Neuer Twitch-Account auf twitch.tv/signup mit eigener Mail. Standard-Username-Konvention: NameBot oder NameOfBot.

Browser-Profil

Twitch erkennt nur den aktuell eingeloggten Account im Browser. Wenn du beide Accounts in einem Browser hast, logge dich vorher manuell mit dem richtigen Account ein: sonst verknüpfst du den Bot-Slot mit deinem Streamer-Account.

Alternative: Anderer Browser, oder Inkognito-Fenster mit Bot-Login.

Bot-Account zum Mod machen

Damit der Bot Mod-Befehle ausführen kann (Timeout, Ban, Slow-Mode):

1. Im eigenen Twitch-Chat eingeben: /mod NameDeinesBots
2. Streamer.bot erkennt das automatisch beim nächsten Reconnect.

5. OBS Studio verbinden (optional)

Wenn du Scene-Switcher, BRB-Modus, Source-Toggle oder Replay-Save willst:

In OBS

1. OBS Studio 28 oder neuer starten.
2. Werkzeuge → obs-websocket-Einstellungen.
3. Häkchen bei WebSocket-Server aktivieren.
4. Port: 4455 (Standard).
5. Authentifizierung aktivieren lassen → Passwort setzen oder das angezeigte generierte Passwort kopieren.

In Streamer.bot

1. Platforms → OBS Studio → Add Connection.
2. Felder:
   • Name: OBS Main (frei wählbar)
   • Host: 127.0.0.1
   • Port: 4455
   • Password: aus OBS kopiert
3. Save → Verbindung wird sofort getestet. Grüner Indikator = verbunden.

Mehrere OBS-Instanzen

Du kannst mehrere OBS-Verbindungen anlegen (Replay-Buffer-OBS + Streaming-OBS getrennt). In allen Sub-Actions die OBS aufrufen kannst du dann pro Sub-Action wählen welche Connection verwendet wird.

6. Sanity-Check

Damit du weißt dass alles funktioniert, baue als nächstes den !hello-Command aus dem Tutorial: Erste Action: !hello.

Troubleshooting

“Twitch-Login öffnet keinen Browser”: Default-Browser ist nicht gesetzt. In Windows-Einstellungen Default-Browser definieren, dann Login nochmal probieren.

“OBS-Verbindung schlägt fehl”: Firewall blockt Port 4455. In Windows-Defender-Firewall eine eingehende Regel für obs64.exe und Streamer.bot.exe anlegen, beide auf Privates Netzwerk erlauben.

“Bot postet nicht im Chat”: Bot-Account ist nicht im eigenen Chat angemeldet. Im Platforms → Twitch → Bot-Slot prüfen ob Connected to Chat: Yes. Falls Nein: Disconnect + neu verbinden.

“Actions feuern nicht”: Trigger nicht verknüpft. In der Action selbst Tab Triggers öffnen und prüfen ob mindestens ein Trigger existiert (z.B. Command Triggered → !hello).

Weitere Details: FAQ.

Nächster Schritt

Streamer.bot läuft, Twitch ist verbunden. Jetzt baust du deinen ersten Command:

→ Erste Action: !hello

Verwandt

• Erste ActionErsten Command bauen.
• OBS-SetupOBS-WebSocket einrichten.
• WillkommenÜbersicht der Doku.