OBSBot, Giveaway-System und Zugriff
Häufig gestellte Fragen
Kurz und nach Ablauf sortiert: erst Grundlagen, dann Setup, danach Betrieb und Sonderfälle.
OBSBot
OBSBot Schritt für Schritt
Starte mit Grundlagen und Voraussetzungen, danach folgen Setup, Plattformen und Recovery.
Giveaway-System
Kurz durch den Giveaway-Teil
Erst Grundlagen und Lizenz, danach Giveaways und Discord-Abläufe.
Allgemeines
Was ist StreamWizard?
StreamWizard hat zwei Teile: den OBSBot, der als Plugin in OBS Studio den 24/7-Stream fährt, und das Giveaway-System im Dashboard mit öffentlicher Teilnahmeseite, Punkten, Tickets, Community-Preisen und Ziehung. Beides steuerst du über Dashboard und Discord.
Ist StreamWizard kostenlos?
Nein. StreamWizard wird über kostenpflichtige Lizenzmodelle bereitgestellt. Pro Benutzerkonto kann derzeit einmalig ein 7-Tage-Premium-Test ohne Zahlungsdaten gestartet werden. Danach erfolgt der Zugriff über die regulären Lizenzmodelle. Die aktuellen Preise stehen öffentlich auf der Preisseite.
Gibt es ein Live-Beispiel?
Ja. twitch.tv/knebel_de läuft rund um die Uhr mit StreamWizard.
Wie lange dauert die Einrichtung?
Das hängt am Produkt. Das Giveaway-System ist schnell startklar: Impressum, Kontakt-E-Mail und Datenschutzbestätigung speichern, Twitch verbinden, den Systembot als Moderator bestätigen - danach das Modul aktivieren und öffentlich schalten, und deine Teilnahmeseite ist erreichbar. Das OBS-Plugin ist deutlich mehr Arbeit: sieben Schritte über OBS Studio, StreamElements, einen eigenen Discord-Server und Twitch. Plane dafür eine knappe Stunde ein statt einer Viertelstunde. Was du dafür brauchst, steht unter Voraussetzungen.
In welcher Reihenfolge richte ich den OBSBot am besten ein?
- Im Dashboard unter „OBS-Plugin" den Installationsbefehl kopieren, OBS schließen und den Befehl ausführen
- OBS starten, das Dock „StreamWizard" öffnen und im Reiter „Einrichtung" den Lizenzschlüssel eintragen
- Im Reiter „Videos" das Stammverzeichnis wählen oder den eigenen YouTube-Kanal angeben; unter „Betrieb" festlegen, was gesendet wird
- In StreamElements den Custom-Command !aktuell mit ${settitle ${2:}} und Userlevel moderator anlegen - daraus entsteht der Stream-Titel
- In Discord den Entwicklermodus aktivieren, einen privaten Mod-Channel anlegen, den Bot über den Invite-Link auf den Server holen und beides im Dashboard auswählen
- Twitch im Dashboard über „Mit Twitch verbinden" anbinden - der System-Bot wird dabei Moderator in deinem Kanal. Für Kick öffnet /kickcode im Mod-Channel das Fenster für Code und Verifier.
Voraussetzungen
Was brauche ich an Hardware und Software?
- OBS Studio – das Plugin läuft als Modul darin
- PC oder Server (Windows, Linux oder macOS)
- Stabile Internetverbindung
- Discord-Account und ein eigener Discord-Server
- Twitch-Account für den Stream
- MP4-Videodateien in einem Ordner
Muss der PC durchgehend an sein?
Ja – der Rechner mit OBS und dem Bot muss laufen, damit der Stream aktiv bleibt. Du musst aber nicht davor sitzen. Der Bot arbeitet vollständig selbstständig und du steuerst alles bequem über Discord.
Welche Betriebssysteme werden unterstützt?
Windows, Linux und macOS. Das Plugin läuft überall dort, wo OBS Studio läuft. Fertige Pakete gibt es für Windows (x64) und macOS (Apple Silicon).
Account & Lizenz
Wie erstelle ich einen Account?
Gehe auf streamwizard.de und logge dich mit deinem Discord-Account ein. Dein Account wird beim ersten Login automatisch erstellt.
Muss mein Account freigeschaltet werden?
Nein. Dein Konto ist ab dem ersten Discord-Login sofort aktiv - eine Freigabe durch einen Administrator gibt es bei der Registrierung nicht. Welche Funktionen offenstehen, entscheidet die Lizenz: der einmalige 7-Tage-Premium-Test oder ein gebuchtes Modell. Nur ein Konto, das nachträglich administrativ deaktiviert wurde, muss wieder freigeschaltet werden - darüber wirst du per E-Mail benachrichtigt.
Welche Lizenzmodelle gibt es?
- Premium – Monatslizenz. Das OBS-Plugin ist enthalten, das Giveaway-System ist während des aktiven Premium-Abos freigeschaltet.
- Premium-Test – Einmaliger 7-Tage-Test pro Benutzerkonto. Funktional wie Premium, endet aber automatisch und ohne Abo.
- VIP – Jahreslizenz. Das OBS-Plugin ist enthalten, das Giveaway-System wird mit der bezahlten VIP-Jahreslizenz freigeschaltet.
- Super VIP / Admin – Das Giveaway-System ist dauerhaft bzw. administrativ freigeschaltet.
Was ist der Lizenzschlüssel und wo finde ich ihn?
Der Lizenzschlüssel authentifiziert deine freigeschaltete StreamWizard-Lizenz gegenüber dem Server. Du findest ihn im Dashboard unter Übersicht → Lizenzschlüssel. Für den Betrieb trägst du ihn einmal im OBS-Dock im Reiter „Einrichtung" ein; das Plugin legt ihn danach in seinem eigenen OBS-Konfigurationsverzeichnis ab. Für das Giveaway-System brauchst du keinen Schlüssel - es läuft im Dashboard und hängt an deinem angemeldeten Konto.
Ist das Giveaway-System in meiner Lizenz enthalten?
Das Giveaway-System ist für aktive Premium-Abos, den laufenden 7-Tage-Premium-Test, bezahlte VIP-Jahreslizenzen sowie für Super VIP und Admin freigeschaltet. Ein normaler OBSBot-Zugriff allein schaltet das Giveaway-System nicht automatisch frei. Bei VIP läuft die Freischaltung über eine einmalige Jahreszahlung; im Stripe-Checkout können je nach Land, Gerät und Verfügbarkeit zum Beispiel Link, PayPal, Klarna, Karte, Bancontact, Amazon Pay oder eps-Überweisung angezeigt werden.
Giveaway-System & Community-Preise
Wofür nutze ich das Giveaway-System?
Das Giveaway-System ist für Giveaways, Communitypreise, Teilnehmerlisten, Ziehungen und Preis-Claiming gedacht. Es ergänzt den OBSBot nicht nur am Rand, sondern deckt einen eigenen Community-Workflow ab.
Wie arbeitet das Giveaway-System mit Discord zusammen?
Discord wird für Status, Preisverwaltung, Freigaben und operative Abläufe rund um Giveaways genutzt. So bleibt für Team und Community nachvollziehbar, wie Preise vorbereitet, gezogen und beansprucht werden.
Wie nehmen Zuschauer an Giveaways teil?
Zuschauer kaufen Tickets mit ihren gesammelten Punkten – im Twitch-Chat mit dem eingestellten Befehl (Vorgabe !ticket) und auf der öffentlichen Teilnahmeseite. Je mehr Tickets jemand hält, desto höher seine Chance bei der Ziehung. Für die Ziehung zählt nur, wer im Chat wirklich aktiv bleibt – der Bot prüft das laufend. Reiner Chat-Spam wird nicht gewertet.
Wie läuft das Claiming nach einem Gewinn ab?
Gewinner müssen ihren Preis aktiv im Twitch-Chat mit !claim beanspruchen. Wie lange das Claim-Fenster offen bleibt, stellst du selbst ein. Der Bot erinnert in konfigurierbaren Abständen automatisch an offene Gewinne und sendet kurz vor Ablauf noch einen letzten Hinweis. Wird der Preis nicht rechtzeitig geclaimt, wandert er wieder zurück in den Lostopf.
Was passiert bei falschem !claim?
Falsche Claim-Versuche werden nicht still ignoriert. Wenn jemand !claim benutzt, obwohl für diesen Account kein offener Gewinn vorliegt, entfernt der Bot den Nutzer aus dem aktuellen Teilnehmerpool und sperrt ihn vorübergehend für weitere Ziehungen.
Was passiert mit Verlosungen, wenn der Stream offline ist?
Das Giveaway-System soll keine echten Ziehungen im Offline-Zustand durchdrücken. Geplante Ziehungen werden verschoben, manuelle Discord-Ziehungen sind nur erlaubt, wenn der Stream online ist, und das System plant bei Offline-Status automatische Nachprüfungen. Falls Preise fälschlich als verlost markiert wurden, während der Stream nicht live war, können sie wieder auf verfügbar zurückgesetzt werden.
Wie streng ist der Workflow für Community-Preise?
Community-Preise laufen bewusst nicht ungeprüft durch. Pro Nutzer ist nur eine aktive Einreichung vorgesehen, gleichzeitig sind nur wenige Community-Preise parallel zugelassen, und normale Sachpreise brauchen einen Bildnachweis. Zusätzlich wird der Twitch-Name des Einreichers erfasst, damit Moderation, Gewinnerzuordnung und mögliche Belohnungen sauber nachvollziehbar bleiben.
Sieht mein Team, wer aktuell im Lostopf ist?
Ja. Der Bot kann im vorgesehenen Discord-Kanal automatisch einen Teilnehmer-Post aktualisieren. Dadurch sieht dein Team gesammelt, wer aktuell registriert ist, statt Teilnehmerstände aus einzelnen Chat-Nachrichten zusammensuchen zu müssen.
Wo finde ich das Giveaway-System und Community-Preise?
Im Dashboard unter Giveaways > Community-Preise. Dort verwaltest du Kanäle, Befehle, Ziehungen und Preis-Workflows zentral.
Schritt 1: OBS Studio bereitmachen
Welche OBS-Version brauche ich?
OBS Studio ab Version 32. Aeltere Fassungen laden das Modul nicht - das ist eine Vorgabe von OBS, keine Einstellung. Neuere Fassungen sind kein Problem.
Brauche ich noch Java?
Nein. Das Plugin ist ein Modul für OBS Studio und läuft in dessen Prozess. Es gibt kein zweites Programm, keine Laufzeitumgebung und keine JAR-Datei mehr.
Muss ich den OBS-WebSocket-Server aktivieren?
Nein. Der WebSocket war der Weg des alten Java-Bots, von außen in OBS hineinzureden. Das Plugin sitzt bereits drin und benutzt die OBS-Schnittstelle direkt - ohne Port, ohne Passwort und ohne eine Verbindung, die ausfallen kann.
Welche Szene und Quelle brauche ich in OBS?
Keine von Hand. Fehlen Szene und Medienquelle, legt das Plugin sie beim ersten Start mit Vorgaben für den Dauerbetrieb an. Bestehendes wird dabei nie verändert - wer schon eine eigene Szene hat, trägt deren Namen im Reiter „Einrichtung" ein.
Muss ich FFmpeg installieren?
Nein. Das Plugin benutzt den Mediendecoder, den OBS ohnehin mitbringt. Es lädt nichts nach und legt nichts daneben.
Schritt 2: Plugin installieren
Wo bekomme ich das Plugin?
Im Dashboard unter OBS-Plugin. Dort steht innerhalb deiner aktiven Lizenzfreigabe der fertige Installationsbefehl - mit deinem Lizenzschlüssel darin und für dein System vorsortiert.
Wie installiere ich es?
OBS schließen, den Befehl aus dem Dashboard kopieren und einfügen: unter Windows in PowerShell, unter macOS und Linux im Terminal. Das Skript holt Manifest und Paket, prüft die SHA-256-Summe und installiert erst danach.
Warum sieht der Windows-Befehl so kompliziert aus?
Weil er die Rohbytes selbst als UTF-8 dekodiert. Windows PowerShell 5.1 würde das Skript sonst falsch lesen und mit einer irreführenden Meldung abbrechen. Bitte den Befehl vollständig kopieren, nicht kürzen.
Der Befehl meldet „sh wurde nicht erkannt" - was nun?
Dann wurde der macOS-Befehl in PowerShell eingefügt. Unter Windows gilt der PowerShell-Befehl. Im Dashboard steht der passende oben und trägt die Markierung „dein System".
Kann ich von Hand installieren?
Ja. Auf der Installationsseite liegen die Archive für Windows und macOS. Im Archiv steckt ein Installationsskript mit derselben Prüfung. Das ist nur nötig, wenn der Befehl nicht durchläuft - etwa hinter einer Firewall, die Skripte blockiert.
Wie aktualisiere ich das Plugin?
Von selbst. Das Plugin prüft ein signiertes Manifest, lädt die neue Fassung bereit und tauscht sie beim nächsten Start von OBS. Einen separaten Updater gibt es nicht mehr.
Wie deinstalliere ich es wieder?
Denselben Befehl mit -Deinstallieren (Windows) beziehungsweise --deinstallieren (macOS, Linux) am Ende ausführen.
Schritt 3: Einrichtung im Dock
Wo finde ich das Dock?
In OBS im Menü „Docks" > „StreamWizard". Es lässt sich wie jedes andere OBS-Fenster andocken oder frei stellen.
Gibt es noch eine botconfig.json?
Nein. Alle Einstellungen nimmst du im Dock vor; das Plugin legt sie selbst neben der OBS-Konfiguration ab. Von Hand musst du dafür keine Datei mehr öffnen.
Was trage ich zuerst ein?
Den Lizenzschlüssel im Reiter „Einrichtung". Der Schlüssel im Installationsbefehl berechtigt nur zum Herunterladen - für den Betrieb wird er einmal im Dock hinterlegt.
Woher kommen die Videos?
Zwei Wege, auch gemischt: ein örtliches Stammverzeichnis mit deinen Dateien (Unterordner werden mitgelesen) oder dein eigener YouTube-Kanal. YouTube-Videos laufen im Einbettungsplayer - es wird nichts heruntergeladen. Unter „Betrieb" stellst du ein, was gesendet wird.
Wie bestimme ich die Reihenfolge?
Über Cluster: Videos werden zu Gruppen zusammengezogen. Beim Aufbau des Sendeplans werden die Cluster gewürfelt, die Videos innerhalb eines Clusters laufen nach Folgennummer - eine Serie bleibt also in der richtigen Reihenfolge.
Schritt 4: Discord-Bot einrichten
Wie füge ich den Bot zu meinem Discord-Server hinzu?
Im Dashboard unter OBS Bot beziehungsweise auf der Installationsseite findest du den Invite-Link. Klicke darauf, wähle deinen Discord-Server aus und bestätige die Freigabe. Danach sollte der Bot in deinem privaten Mod-Bereich Mitglied sein.
Welche Discord-Kanäle brauche ich?
- Private Kategorie – Lege am besten zuerst eine private Kategorie oder einen privaten Bereich für den Bot an.
- Mod-Channel – Deine Kommandozentrale. Hier öffnest du mit /obs das Bedienfeld, und der Bot postet Status-Updates und Button-Panels.
- Log-Channel – Hier schreibt der Bot detaillierte Log-Nachrichten wie Fehler, Token-Refresh oder Video-Wechsel.
Schritt 5: Twitch verbinden
Wie verbinde ich Twitch?
- Im Dashboard unter „OBS-Plugin" auf „Mit Twitch verbinden" klicken.
- Den Zugriff bei Twitch bestätigen. Danach ist der zentrale System-Bot Moderator in deinem Kanal.
- Mehr ist nicht nötig: Chat-Ansagen, !skip, !vote, !mark und der Zuschauerzähler laufen über diesen System-Bot.
Brauche ich einen Twitch-Code im Discord-Mod-Channel?
Nein. Das Plugin hält für Twitch keinen eigenen Token mehr. Der Befehl !settwitchcode hat keine Wirkung - der Bot antwortet darauf nur noch, dass Twitch keinen Code mehr braucht und die Verbindung im Dashboard hergestellt wird.
Muss ich den Twitch-Token regelmäßig erneuern?
Nein. Im Plugin gibt es für Twitch weder Access- noch Refresh-Token; die Verbindung des System-Bots pflegt StreamWizard serverseitig. !tokenstatus und !refresh betreffen ausschließlich Kick.
Was mache ich, wenn im Twitch-Chat nichts ankommt?
Prüfe im Dashboard unter „OBS-Plugin", ob der System-Bot in deinem Kanal noch Moderator ist, und erneuere die Verbindung mit „Twitch neu verbinden". Einen Code musst du dafür nicht erzeugen.
Optionaler YouTube-Workflow
Ist das ein YouTube-Downloader?
Nein. Das Plugin bindet den offiziellen Einbettungsplayer von YouTube in eine Browser-Quelle von OBS ein - genau wie eine Webseite es täte. Es wird nichts geholt, nichts umgewandelt und nichts gespeichert.
Wie läuft das technisch?
Das Plugin holt die Videoliste des Kanals über die YouTube Data API und baut daraus den Sendeplan. Abgespielt wird über den Einbettungsplayer in einer Browser-Quelle. Liegt ein Video örtlich als Datei vor, hat die Datei Vorrang.
Was brauche ich dafür?
Deinen Kanal und eine Browser-Quelle in OBS, deren Namen du im Reiter „Einrichtung“ einträgst. Ein eigenes Google-Projekt und eine Anmeldung brauchst du nicht – darum kümmert sich StreamWizard.
Brauche ich das überhaupt?
Nein. Das Plugin läuft genauso mit rein örtlichen Videodateien. Unter „Betrieb“ stellst du ein, ob örtlich, YouTube oder beides gesendet wird.
Playlist & Videos
Wie funktioniert die Playlist?
Der Bot scannt deinen Video-Ordner und erstellt automatisch eine playlist.json. Jedes Video wird mit Pfad, Name und Dauer erfasst. Videos werden nacheinander abgespielt und als „gespielt" markiert. Örtliche Dateien behalten ihre Reihenfolge – aus einem Manifest oder alphabetisch nach Dateiname. Nur die Cluster aus deinem YouTube-Kanal werden bei jedem Neuaufbau gemischt.
Welches Videoformat wird unterstützt?
MP4 ist das primäre Format. Stelle sicher, dass alle Videos im konfigurierten Verzeichnis liegen.
Kann ich neue Videos hinzufügen, während der Bot läuft?
Ja. Neue Videos werden beim nächsten Playlist-Neuaufbau automatisch erkannt und einbezogen. Du kannst eine Neuerstellung auch manuell über Discord anstoßen.
Was passiert, wenn ein Video fehlt oder beschädigt ist?
Der Bot erkennt fehlende oder nicht abspielbare Dateien und überspringt sie automatisch, ohne den Stream zu unterbrechen.
Wie wird der Stream-Titel bei jedem Video aktualisiert?
Bei jedem Video-Wechsel kündigt das Plugin das laufende Video im Chat an; den Titel setzt daraufhin StreamElements nach dem Schema: Titel anfang + Videoname + Titel ende. Der Videoname wird aus dem Dateinamen abgeleitet; mit „zeichen_vorne_weg" kannst du Präfixe wie 001- entfernen. Voraussetzung ist der StreamElements-Command !aktuell mit ${settitle ${2:}}.
Discord-Steuerung
Wie steuere ich den Bot über Discord?
Der Bot sendet ein interaktives Button-Panel in den Mod-Channel. Dort kannst du per Klick:
- Bot starten / stoppen
- Videos überspringen
- Titel erneut im Chat ansagen
- Systeminformationen anzeigen
- Neue Playlist erstellen
- Recovery / Neustart auslösen
- Logs abrufen
Welche Text-Befehle gibt es im Discord?
!bothelp | Zeigt alle Befehle |
!tokenstatus | Kick-Token-Status prüfen |
!update | Konfiguration oder Playlist aktualisieren |
!restart | Bot neu starten |
!log | Aktuelle Logs anzeigen |
!refresh | Konfiguration neu laden |
Kann ich den Stream von überall steuern?
Ja. Da die Steuerung über Discord läuft, kannst du den Bot von jedem Gerät mit Discord-Zugang steuern – ob per Handy, Tablet oder PC.
Twitch-Chat-Befehle
Wie funktioniert das Voteskip für Zuschauer?
- Ein Zuschauer startet mit !voteskip eine Abstimmung
- Es müssen genügend Zuschauer mitstimmen – die Schwelle stellst du im Dashboard ein
- Wird die Schwelle erreicht, wird das Video übersprungen
- Der Initiator hat danach 1 Stunde Cooldown
Was macht der !mark Befehl?
Mit !mark <Grund> können berechtigte Benutzer ein Video markieren (z. B. wegen Tonproblemen). Markierte Videos können über !getmarked im Discord abgerufen und überprüft werden.
Können Moderatoren Videos direkt überspringen?
Ja. Moderatoren können mit !skip das aktuelle Video sofort überspringen, ohne Abstimmung.
Stabilität & Recovery
Was passiert, wenn der Stream abstürzt oder OBS hängt?
„Recover“ löst du selbst aus – über den Knopf im Discord-Bedienfeld oder im Dashboard: Bot stoppen, Playlist verwerfen, neu starten, Playlist neu aufbauen. Von allein greift nur die Aufsicht: einen toten Wiedergabe-Thread startet sie neu, einen hängenden meldet sie rot nach Discord und lässt ihn bewusst stehen.
Was passiert bei einem Internet-Ausfall?
Kommt das Netz 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.
Kann die Verbindung zu OBS abreißen?
Nein. Das Plugin läuft im selben Prozess wie OBS - es gibt keine Verbindung, die abreißen könnte. Was ausfallen kann, ist eine Datei oder das Netz bei Onlinevideos; dafür gibt es eine Aufsicht, die einen stehengebliebenen Wiedergabe-Thread meldet.
Kann ich den Bot manuell neu starten?
Ja. Über den Discord-Mod-Channel kannst du per !restart oder über den Recovery-Button einen Neustart auslösen.
Fehlerbehebung
Das Plugin taucht in OBS nicht auf - was tun?
Prüfe drei Dinge: OBS neu gestartet? Die verlangte OBS-Mindestfassung erfüllt? Und liegt das Modul nicht zusätzlich in der OBS-Installation - dann lädt OBS nur eine der beiden Kopien und überspringt die andere stillschweigend. Der Installer warnt in diesem Fall und nennt den Pfad.
Das Dock ist da, aber nichts läuft
Im Reiter „Einrichtung" muss der Lizenzschlüssel hinterlegt sein. Ohne ihn arbeitet das Plugin bewusst nicht weiter. Danach im Reiter „Videos" ein Stammverzeichnis oder einen YouTube-Kanal setzen - ohne Videos gibt es keinen Sendeplan.
Der Discord-Bot ist offline
- Prüfe deine Internetverbindung
- Prüfe auf der Statusseite, ob eine Störung gemeldet ist – der Discord-Bot läuft bei uns, nicht auf deinem Rechner
- Prüfe, ob der Bot noch Mitglied deines Discord-Servers ist und die nötigen Rechte in den Kanälen hat
Videos werden nicht abgespielt
Prüfe das Stammverzeichnis im Reiter „Videos" - es muss erreichbar sein, auch ein Netzlaufwerk oder eine externe Platte. Bei Onlinevideos muss unter „Betrieb" die passende Quelle gewählt sein. Das Protokoll im Dock nennt für jedes übersprungene Video den Grund.
Erweitert
Wie richte ich den StreamElements-Command für automatische Titeländerungen ein?
Erstelle in StreamElements folgenden Custom-Command:
| Command Name | !aktuell |
| Response Type | whisper |
| Userlevel | moderator |
| Response | ${settitle ${2:}} |
Kann ich die Sprache des Docks ändern?
Die Sprache des Docks stellst du im Dock selbst um; die Vorgabe ist Deutsch. Deutsch und Englisch sind hinterlegt; fehlt eine Übersetzung, wird auf Deutsch zurückgefallen.
Wie funktioniert das automatische Update?
Das Plugin prüft im Hintergrund regelmäßig ein signiertes Manifest, legt eine neue Fassung bereit und tauscht sie beim nächsten Start von OBS ein - die geladene Moduldatei lässt sich im laufenden Betrieb nicht ersetzen. Der Update-Knopf im Discord-Bedienfeld stößt diese Prüfung sofort an. Einen separaten Updater gibt es nicht mehr.
Frage nicht dabei?
Komm auf unseren Discord-Server – dort helfen wir dir gerne weiter.
Discord öffnen