Direkt zum Inhalt springen
OBSBot und Giveaway-System im Überblick

Was StreamWizard für deinen Kanal übernimmt

Zwei Teile, eine Lizenz: OBSBot hält deinen Kanal in deinem OBS rund um die Uhr auf Sendung, auch wenn du nicht davorsitzt. Das Giveaway-System verlost Preise an deine Zuschauer und führt Teilnehmer, Ziehungen und Gewinn-Abholung von allein. Unten steht für beide Teile, wie sie im Detail arbeiten.

OBSBot

Playlist, OBS, Plattformen und Steuerung im Betriebsmodus

Der OBSBot arbeitet mit einem festen Video-Stammverzeichnis, erstellt daraus automatisch rotierende Playlists, spielt die Inhalte in OBS ein und hält Twitch-/Kick-Chat-Integration, Streaming auf anderen Plattformen ohne Chat-Integration, Token-Status, Discord-Steuerung, Webfrontend und Recovery in einem belastbaren 24/7-Setup zusammen.

Optional spielt das Plugin eigene oder ausdrücklich freigegebene öffentliche YouTube-Videos direkt über den offiziellen Einbettungsplayer ab - es wird nichts heruntergeladen. Der vorgesehene Rechte- und Datenschutzpfad ist unter YouTube im OBS-Plugin beschrieben.

  • Playlist-Aufbau aus dem Video-Stammverzeichnis mit Unterordnern, Rotation und automatischer Neuerstellung
  • Plattformspezifische Abläufe mit Twitch- und Kick-Chat-Integration; andere Plattformen laufen ohne Chat-Integration direkt über OBS weiter
  • Optionale YouTube-Wiedergabe nur für eigene oder ausdrücklich freigegebene öffentliche Videos - über den Einbettungsplayer, ohne Herunterladen
  • Discord-, Webfrontend- und Chat-Steuerung für Bot-Start, Updates, Neustart, Skip, Voteskip, Logs und Markierungen
Giveaway-System

Giveaways, StreamSeries und Preisprozesse

Das Giveaway-System bildet den kompletten Giveaway-Ablauf ab: von der Preisfreigabe in Discord über den Ticketkauf mit gesammelten Punkten im Twitch-Chat bis zu automatischen Ziehungen, Claims, Erinnerungen, StreamSeries-Boni und einer fairen Gewinnlogik.

  • Ticketkauf mit gesammelten Punkten im Twitch-Chat, gepflegte Teilnehmerlisten, Claim-Fristen und automatische Ziehungen im laufenden Stream
  • Preislogik mit Discord-Einreichung, Moderationsfreigabe, Live-Status und sauberer Gewinnerzuordnung
  • StreamSeries-Erkennung mit Dedup, Cooldown, Bonus-Stars und adaptiver Pity-Logik
OBSBot – 24/7 Stream

Die drei Systeme, die den OBSBot tragen

StreamWizard verbindet OBS, Twitch/Kick, weitere Plattformpfade ohne Chat-Integration, Discord und Webfrontend zu einem Setup, das nicht nur streamt, sondern Playlists automatisch aufbaut, sich überwacht und aus der Ferne steuern lässt.

OBS-PLUGIN

Wiedergabe & Steuerung

Das Plugin läuft als Modul in OBS Studio. Es steuert die Video-Quelle, wechselt Szenen und startet die Wiedergabe direkt über die OBS-Schnittstelle – ohne Netzverbindung, ohne Port, ohne Passwort.

  • Erreichbarkeitsprüfung von Verzeichnis und Datei vor jedem Video
  • Szene und Medienquelle werden beim ersten Start angelegt, falls sie fehlen
  • Exponentielles Backoff, wenn das Videoverzeichnis nicht erreichbar ist – 5 Sekunden, verdoppelnd bis 60
TWITCH / KICK API

Token, Titel & Chat

OAuth2-Token-Lifecycle mit automatischem Refresh. Auf Twitch und Kick laufen Chat-Integrationen über die Plattformanbindung; andere Plattformen nutzt der Bot weiter über OBS ohne Chat-Integration.

  • Twitch über das Dashboard, Kick per Code
  • Automatischer Token-Refresh im laufenden Betrieb
  • Viewer-Count-Abfrage (alle 5 Min.)
DISCORD BOT

Fernbedienung & Logging

Der Mod-Channel und das Webfrontend sind die Kommandozentralen – der Slash-Befehl /obs stellt ein Bedienfeld hinein, in dem Start, Stopp, Überspringen, Protokoll und Status zusammenlaufen.

  • Mod- und Log-Channel getrennt
  • Embed-Nachrichten mit Farbcodes
  • Automatischer Reconnect

Playlist-Engine für örtliche Dateien und YouTube-Videos im 24/7-Betrieb

Hier entscheidet sich, ob dein Kanal wie ein echter Dauerstream oder wie eine stumpfe Dauerschleife wirkt.

Automatische Playlist-Erstellung

Beim Start scannt der Bot das konfigurierte Video-Stammverzeichnis mit seinen Unterordnern nach Videodateien (.mp4, .mkv, .mov, .avi, .webm, .flv, .ts, .m4v) und erstellt daraus die playlist.json. Jedes Video wird mit Pfad, Name und Dauer erfasst. Optional kommen YouTube-Videos deines Kanals dazu - sie laufen über den offiziellen Einbettungsplayer, nicht als Datei.

Rotation & Shuffle

Jedes Video wird als „gespielt" markiert. Sind alle durch, wird die Playlist komplett neu aufgebaut. Örtliche Dateien behalten dabei ihre feste Reihenfolge – aus einem Manifest oder alphabetisch nach Dateiname. Nur die Cluster aus deinem YouTube-Kanal werden bei jedem Aufbau neu gemischt; die Folgen innerhalb einer Serie bleiben in ihrer Reihenfolge.

Twitch-Titel pro Video - über StreamElements

Der Bot baut zu jedem Video einen Titel aus Titel-Anfang, Datei- oder Ordnername und Titel-Ende zusammen und sagt ihn im Chat an. Den Stream-Titel setzt daraus StreamElements per Befehl !aktuell mit ${settitle ${2:}} - diesen Befehl legst du einmalig selbst an, Userlevel moderator. Ohne ihn bleibt es bei der Ansage im Chat.

TeilQuelleBeispiel
Titel AnfangKonfigurationsfeld🎬 Jetzt läuft:
Video-NameDatei- oder Ordnername (ohne .mp4)Best of Stream #42
Titel EndeKonfigurationsfeld| 24/7 Rerun

Twitch-Anbindung ohne eigenes Token

Das Plugin hält für Twitch kein eigenes Token mehr. Der Chat läuft über den zentralen System-Bot – es gibt nichts, was bei dir ablaufen könnte.

1

Twitch im Dashboard verbinden

Im Dashboard unter „OBS-Plugin“ auf „Mit Twitch verbinden“. Das war es – es gibt keinen Code mehr, den du irgendwohin kopieren musst.

2

System-Bot wird Moderator

Beim Verbinden wird der System-Bot Moderator in deinem Kanal und schreibt dort die Ansagen. Dein eigenes Twitch-Konto hält dafür kein Token.

3

Auffrischung serverseitig

Die Auffrischung läuft auf unseren Servern, nicht bei dir. Du merkst davon nichts.

4

Status & Monitoring

Per !tokenstatus siehst du jederzeit den Zustand der Kick-Anbindung. Bei Problemen wird der Discord-Log-Channel benachrichtigt.

Recovery, Reconnects und Stabilität im Dauerbetrieb

Diese Mechaniken machen aus einer einfachen OBS-Automation einen OBSBot, der Probleme erkennt und nicht beim ersten Fehler liegen bleibt.

Recover auf Knopfdruck

„Recover“ löst du selbst aus – über den Discord-Knopf oder das Dashboard: Bot stoppen, Playlist verwerfen, neu starten, Playlist neu aufbauen. Von allein greift die Aufsicht: einen toten Wiedergabe-Thread startet sie neu, einen hängenden meldet sie rot nach Discord und lässt ihn bewusst stehen – ein Neustart nähme OBS mitten im Stream mit.

Verzeichnisprüfung vor jedem Video

Vor jedem Video wird geprüft, ob Videoverzeichnis und Datei erreichbar sind. Ist das Verzeichnis weg - schlafende Platte, abgerissener Netz-Mount - wartet der Bot 5 Sekunden, dann verdoppelnd bis 60 Sekunden, statt den Sendeplan leerzulaufen. Eine Verbindung zu OBS kann nicht ausfallen: das Plugin läuft im OBS-Prozess selbst.

Netzwerk-Monitor

Ein separater Monitor überwacht die Internetverbindung. Kommt sie zurück, meldet sich das Plugin bei den Discord-Kanälen neu an und prüft die Kick-Abos erneut. Für Twitch gibt es nichts wiederherzustellen – den Chat hält der zentrale System-Bot.

OBSBot-Commands für Betrieb und Eingriffe

Diese Befehle gehören direkt zum 24/7-Betrieb: Bot starten, Playlist neu aufbauen, Updates übernehmen, Token pflegen, Status prüfen und in laufende Inhalte eingreifen. Dasselbe Steuerungsmodell wird zusätzlich über das Webfrontend ergänzt.

Discord-Mod-Channel

CommandFunktionDetails
!bothelpCommands anzeigenListet verfügbare OBSBot-Befehle mit Kurzbeschreibung.
!logBot-Log sendenSchickt die letzten Logzeilen gekürzt als Codeblock in den Kanal, in dem der Befehl steht – im Regelfall also in den Mod-Channel.
!system_infoSysteminfo anzeigenZeigt Maschine, Laufzeiten und Playlist - der Embed für die Fehlersuche.
!settwitchcode <code>Ohne FunktionAntwortet nur noch mit dem Hinweis, dass Twitch keinen Code mehr braucht – die Verbindung stellst du im Dashboard her.
!tokenstatusTokenstatus prüfenZeigt den Zustand der Kick-Anbindung.
!refreshRefresh erzwingenStartet sofort eine manuelle Token-Erneuerung.
!updateUpdate prüfenPrüft sofort auf eine neue Plugin-Fassung und legt sie bereit. Übernommen wird sie beim nächsten Start von OBS.
!restartBot neu startenSetzt die Wiedergabe neu auf - OBS selbst läuft dabei weiter.

Twitch- und Kick-Chat im OBSBot-Betrieb

CommandFunktionDetails
!voteskipSkip-Voting startenÖffnet eine Abstimmung zum Überspringen des aktuellen Videos.
!voteAm Voting teilnehmenAb einer definierten Schwelle wird das laufende Video übersprungen.
!mark <grund>Video markierenMarkiert problematische Inhalte für spätere Prüfung durch Mods.

Systemanforderungen und Konfiguration

Hier siehst du die technische Basis für den Betrieb des Plugins - auf dem Streaming-PC wie auf einem Server im Dauerbetrieb.

Voraussetzungen

  • OBS Studio – das Plugin läuft als Modul darin, ein zweites Programm gibt es nicht
  • Twitch-Account mit Streaming-Rechten

Konfigurationsfelder

  • Video-Stammpfad
  • Szenename / Quellenname
  • Lizenzschlüssel

Betriebsmodi für Desktop und Server

Eingerichtet wird einmalig im Dock in OBS, gesteuert wird danach aus der Ferne über Discord und das Dashboard.

Dock in OBS

Das Dock sitzt neben deinen anderen OBS-Fenstern: Betrieb, Videos, Plattformen und Einrichtung in Reitern, dazu das laufende Protokoll.

Headless-Modus

Das Plugin läuft überall dort, wo OBS Studio läuft - auf dem Streaming-PC wie auf einem Server im Dauerbetrieb.

OBSBot im Detail prüfen und einrichten

Wenn du den 24/7-Betrieb planst, sind genau diese Bereiche für Setup, Stabilität und laufende Steuerung relevant.