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

Technik kompakt getrennt

OBSBot deckt den 24/7-Streambetrieb mit Playlist, OBS-Steuerung, Twitch- und Kick-Chat-Integration, Streaming auf anderen Plattformen ohne Chat-Integration, Discord- und Webfrontend-Steuerung, lokalen und exportierten YouTube-Videos sowie Recovery ab. Giveaway-System kümmert sich um Giveaways, Community-Preise, StreamSeries, Claims und die dazugehörigen Discord-Prozesse. Die Features bleiben getrennt beschrieben, weil es zwei eigenständige Produktteile sind.

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 kann der OBSBot eigene oder ausdrücklich freigegebene öffentliche YouTube-Videos über Google Data Portability lokal in den Playlist-Betrieb übernehmen. Der vorgesehene Rechte- und Datenschutzpfad ist unter OBSBot YouTube-Workflow 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
  • Optionaler YouTube-Import nur für eigene oder ausdrücklich freigegebene öffentliche Videos über Google Data Portability
  • Discord-, Webfrontend- und Chat-Steuerung für Bot-Start, Updates, Neustart, Skip, Voteskip, Logs und Markierungen
Giveaway-System

Giveaways, StreamSeries und Preisprozesse

Der Giveaway-System bildet den kompletten Giveaway-Ablauf ab: von der Preisfreigabe in Discord über die Registrierung per Twitch-Direktnachricht mit !ticket an den eingerichteten Bot-Account bis zu automatischen Ziehungen, Claims, Erinnerungen, StreamSeries-Boni und einer fairen Gewinnlogik.

  • Registrierung per Twitch-Direktnachricht mit !ticket, 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 WEBSOCKET

Wiedergabe & Steuerung

Der Bot verbindet sich per WebSocket (v5) mit OBS Studio. Er steuert die Video-Quelle, wechselt Szenen und startet die Wiedergabe – alles programmatisch.

  • TCP-Reachability-Check vor jedem Video
  • Konfigurierbarer Port & Passwort
  • Exponentielles Backoff bei Verbindungsverlust
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.

  • OAuth2 Authorization Code Flow
  • Automatischer Token-Refresh (alle 180s geprüft)
  • Viewer-Count-Abfrage (alle 5 Min.)
DISCORD BOT

Fernbedienung & Logging

Über JDA (Java Discord API) verbunden. Der Mod-Channel und das Webfrontend sind die Kommandozentralen – Commands, Logs, Status-Meldungen und Fernsteuerung laufen hier zusammen.

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

Playlist-Engine für lokale und exportierte 24/7-Inhalte

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 MP4-Dateien und erstellt daraus die playlist.json. Jedes Video wird mit Pfad, Name und Dauer erfasst. Optional kommen exportierte YouTube-Videos aus dem vorgesehenen Importpfad dazu.

Rotation & Shuffle

Jedes Video wird als „gespielt" markiert. Sind alle durch, wird die Playlist komplett neu erstellt – mit zufälliger Reihenfolge. So wiederholt sich nichts vorhersehbar.

Automatische Twitch-Titel pro Video

Damit Zuschauer und Twitch-Kategorie sofort sehen, was gerade läuft, setzt der Bot den Streamtitel dynamisch aus Titel-Anfang, Datei- oder Ordnername und Titel-Ende zusammen.

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

Twitch-Token-Lifecycle ohne manuelles Nachpflegen

Der Token-Flow ist so aufgebaut, dass dein 24/7-Twitch-Bot nicht wegen abgelaufener Authentifizierung stillsteht.

1

Code nach Bot-Neustart erzeugen

Sobald der Bot im privaten Discord-Mod-Channel meldet, dass der Token fehlt oder abgelaufen ist, öffnest du den Link zum OAuth2 Authorization Code Flow. Ein state-Parameter schützt gegen CSRF.

2

Code an Bot senden

Per !settwitchcode <code>&lt;code&gt;</code> im privaten Discord-Mod-Channel. Der Bot tauscht den Code gegen Access + Refresh Token.

3

Automatischer Refresh

Alle 180 Sekunden wird der Token geprüft. Läuft er ab, nutzt der Bot das Refresh Token – ohne manuelles Eingreifen.

4

Status & Monitoring

Per !tokenstatus siehst du jederzeit den Token-Zustand. 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.

Automatische Recovery

Bei unerwarteten Fehlern wird automatisch Recover() ausgelöst: Bot stoppen, Playlist zurücksetzen, Bot neu starten, Discord reconnecten.

OBS-Verbindungsüberwachung

Vor jedem Video wird OBS per TCP geprüft. Bei Timeout greift exponentielles Backoff.

Netzwerk-Monitor

Ein separater Monitor überwacht die Internetverbindung und stößt bei Wiederherstellung einen Twitch-Reconnect an.

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 sendenSendet den aktuellen Log-Inhalt in den Log-Channel.
!sendfile <name>Datei sendenÜberträgt eine Datei aus dem Bot-Verzeichnis zur Analyse.
!settwitchcode <code>OAuth-Code setzenTauscht den OAuth-Code gegen Access- und Refresh-Token.
!tokenstatusTokenstatus prüfenZeigt Gültigkeit, Ablaufdatum und letzte Prüfung.
!refreshRefresh erzwingenStartet sofort eine manuelle Token-Erneuerung.
!updateKonfiguration neu ladenLädt Änderungen aus der Bot-Konfiguration ohne Neuinstallation.
!restartBot neu startenStartet den OBSBot und die OBS-Verbindung neu.

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 OBSBots auf PC, Server oder headless Setup.

Voraussetzungen

  • Java 21+ – Runtime für den Bot
  • OBS Studio mit aktiviertem WebSocket-Server
  • Twitch-Account mit Streaming-Rechten

Konfigurationsfelder

  • Video-Stammpfad
  • Szenename / Quellenname
  • OBS Port & Passwort

Betriebsmodi für Desktop und Server

Der OBSBot kann entweder mit Oberfläche für das erste Setup oder headless für den dauerhaften Serverbetrieb laufen.

GUI-Modus

Die Java-Swing-Oberfläche zeigt alle Felder, den Log-Bereich und die Steuerungsbuttons. Ideal für die Ersteinrichtung.

Headless-Modus

Per --headless-Flag oder automatisch auf Systemen ohne Display. Perfekt für Server.

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.

Mit Discord zum OBSBot-Setup OBSBot Landingpage öffnen Download-Ablauf ansehen