Doku & HilfeDocs & Help
Alles zum Einrichten und Nutzen von SubWaveBot – Schritt für Schritt.Everything about setting up and using SubWaveBot – step by step.
🚀 Erste SchritteGetting started
Melde dich mit deiner Admin-E-Mail im Dashboard an. Verbinde unter Plattformen Twitch, Kick und/oder YouTube. Danach findest du überall im Dashboard fertige Overlay-Links mit deinem persönlichen Token – diese kopierst du in OBS.
Sign in to the dashboard with your admin e-mail. Under Platforms, connect Twitch, Kick and/or YouTube. Afterwards you will find ready-made overlay links with your personal token all over the dashboard – copy these into OBS.
🖥️ Overlays in OBSOverlays in OBS
Jedes Overlay ist eine Browser-Quelle. Kopiere den Link aus dem Dashboard und füge ihn in OBS als neue Browser-Quelle ein (Breite/Höhe wie angegeben, Hintergrund bleibt transparent).
Mit dem Overlay-Manager packst du mehrere Widgets frei angeordnet in EINE einzige Quelle (Ansicht „layout") – das spart Platz und hält OBS aufgeräumt.
Every overlay is a browser source. Copy the link from the dashboard and add it in OBS as a new browser source (width/height as stated, the background stays transparent).
With the overlay manager you arrange several widgets freely inside ONE single source (view "layout") – that saves space and keeps OBS tidy.
⏱️ Subathon-TimerSubathon timer
Lege die Zeitwerte fest (wie viel Zeit ein Sub, Gift, Bits, Kicks, Follow oder eine Spende bringt). Starte/pausiere den Timer im Dashboard oder vom Handy.
Ergänze Meilensteine, eine Happy Hour (Zeit-Multiplikator) und den Endspurt für die letzten Minuten. Zum Finale gibt es einen Recap-Abspann mit den Top-Unterstützern.
Define the time values (how much time a sub, gift, bits, kicks, follow or donation adds). Start/pause the timer in the dashboard or from your phone.
Add milestones, a happy hour (time multiplier) and the final sprint for the last minutes. For the finale there is a recap crawl featuring your top supporters.
🏆 Punkte, Ränge & ShopPoints, ranks & shop
Zuschauer sammeln automatisch Punkte fürs Zuschauen und Mitmachen. Mit !punkte sehen sie ihren Stand, mit !rang ihren Fortnite-artigen Rang.
Im Shop kaufen sie mit Punkten Sound-Alerts oder Aktionen. Ein Anti-Fake-Aktivitätsscore sorgt dafür, dass Spam & reiner Emote-Spam nicht belohnt werden – ideal, um am Subathon-Ende die aktivsten Zuschauer fair zu belohnen.
Viewers automatically earn points for watching and participating. With !punkte they check their balance, with !rang their Fortnite-style rank.
In the shop they spend points on sound alerts or actions. An anti-fake activity score makes sure spam & emote-only messages are not rewarded – ideal for fairly rewarding your most active viewers at the end of a subathon.
🎮 MinigamesMinigames
Im Chat spielbar: Quiz (!quiz), Glücksrad, Münzwurf, Battle Royale, Heist und die Geisterjagd. Alle sind einzeln aktivierbar, mit eigenen Kosten, Cooldowns und Texten.
Playable right in chat: quiz (!quiz), wheel, coin flip, battle royale, heist and the ghost hunt. Each can be enabled individually, with its own costs, cooldowns and texts.
🤖 Chatbot & BefehleChatbot & commands
Eigene Befehle, zeitgesteuerte Ansagen, Zähler, Zitate und Social-Aktionen (!hug, !slap …) legst du im Dashboard an. Die Moderation filtert Bannwörter, Links, Caps & Spam und kann per 3-Strikes eskalieren.
Eine öffentliche Befehls-Übersicht gibt es unter befehle.php – ideal zum Verlinken im Panel.
Create custom commands, timed announcements, counters, quotes and social actions (!hug, !slap …) in the dashboard. Moderation filters banned words, links, caps & spam and can escalate via 3 strikes.
A public command overview is available at befehle.php – great for linking in your panels.
💬 Multichat & AlertsMultichat & alerts
Das Chat-Overlay bündelt Twitch- und Kick-Chat in einem Fenster – mit den echten Plattform-Abzeichen und nativen sowie 7TV/BTTV/FFZ-Emotes. Fertige Design-Vorlagen gibt es zum Anklicken.
Für Alerts stehen viele fertige Vorlagen bereit (Standard, Fortnite, Synthwave, Gold, Neon …). Du kannst dein aktuelles Alert-Design auch als eigenes Layout speichern und jederzeit wieder anwenden.
Zum Mitlesen auf einem zweiten Bildschirm/Prompter gibt es einen abgespeckten Multichat-Viewer und eine Event-Übersicht als eigene Links.
The chat overlay combines Twitch and Kick chat in one window – with the real platform badges and native as well as 7TV/BTTV/FFZ emotes. Ready-made design templates are one click away.
For alerts there are many built-in presets (Standard, Fortnite, Synthwave, Gold, Neon …). You can also save your current alert design as a custom layout and re-apply it any time.
For reading along on a second screen/prompter there are a stripped-down multichat viewer and an event overview as dedicated links.
📅 StreamplanStream schedule
Plane deine Streams als Wochen-Kalender mit echten Terminen, Serien (wöchentlich/2-wöchentlich) und Absagen. Game-Cover kommen automatisch von Twitch.
Exportiere den Plan als fertige Grafik – Story 9:16, Post, Landscape oder Twitch-Panel – mit Vorlagen (Neon, Ocean, Retro, Fortnite …), Hintergrundbild, Avatar & Kopf-Texten. Über den iCal-Link abonnierst du den Plan in Google/Apple Calendar.
Plan your streams as a weekly calendar with real dates, series (weekly/bi-weekly) and cancellations. Game covers are fetched from Twitch automatically.
Export the schedule as a finished graphic – story 9:16, post, landscape or Twitch panel – with templates (Neon, Ocean, Retro, Fortnite …), background image, avatar & header texts. Via the iCal link you can subscribe to the schedule in Google/Apple Calendar.
📱 Handy-Steuerung & IRL ControlMobile & IRL control
Die Handy-Steuerung (control.php) lässt sich wie eine App installieren (PWA): Timer, Pause, Song überspringen, Rad, Münzwurf und Panik-Modus.
Mit IRL Control wechselst du unterwegs zwischen 3 frei editierbaren OBS-Szenen. Dazu gibt es schlanke Prompter-Ansichten für Events und Chat – perfekt für einen Elgato Prompter oder zweiten Monitor.
The mobile control (control.php) installs like an app (PWA): timer, pause, skip song, wheel, coin flip and panic mode.
With IRL control you switch between 3 freely editable OBS scenes on the go. There are also lean prompter views for events and chat – perfect for an Elgato Prompter or a second monitor.
✨ KI-AssistentAI assistant
Verbinde einen KI-Anbieter (z. B. Google Gemini – kostenloses Kontingent). Dann beantwortet der Bot !aski-Fragen im Chat, und im Adminbereich hilft dir ein Assistent beim Einrichten und Erklären der Funktionen.
Connect an AI provider (e.g. Google Gemini – free tier available). The bot will then answer !aski questions in chat, and inside the admin area an assistant helps you set up and understand every feature.
🔑 API-KeysAPI keys
Die meisten Anbindungen (ElevenLabs-Stimmen, TikTok, Tiltify, Discord) stellt die Plattform bereit – die nötigen Schlüssel pflegt der Betreiber, du musst nichts beschaffen.
Selbst eintragen musst du nur deinen KI-Key: Google Gemini (gratis) unter aistudio.google.com/apikey → „API-Schlüssel erstellen" → Key kopieren und im KI-Bereich (Chatbot → KI) eintragen. Alternative: Groq unter console.groq.com/keys. Der Key wird verschlüsselt gespeichert und nie wieder im Klartext angezeigt. Keys niemals im Chat/Discord teilen!
Twitch-Berechtigungen (kein Key): Für Auto-VIP & native Umfragen musst du Twitch im Plattformen-Tab einmal neu verbinden – es gibt nichts zu kopieren.
Most integrations (ElevenLabs voices, TikTok, Tiltify, Discord) are provided by the platform – the operator maintains the required keys, there is nothing for you to obtain.
The only key you enter yourself is your AI key: Google Gemini (free) at aistudio.google.com/apikey → "Create API key" → copy it and enter it in the AI section (Chatbot → AI). Alternative: Groq at console.groq.com/keys. The key is stored encrypted and never shown in plain text again. Never share keys in chat/Discord!
Twitch permissions (no key): for auto-VIP & native polls simply reconnect Twitch in the Platforms tab – nothing to copy.
🔌 API & WebhooksAPI & webhooks
Unter 🔌 API & Webhooks im Dashboard verbindest du eigene Tools mit deinem Kanal. Ausgehende Webhooks melden verbuchte Events (Subs, Gifts, Bits, Spenden, Follows, Raids, Hype-Train) per HTTP-POST an bis zu 5 eigene Ziele.
In derselben Karte erzeugst du für neue Integrationen mehrere REST-API-v2-Keys mit genau den benötigten Scopes. Jeder Key wird nur einmal im Klartext angezeigt und kann einzeln widerrufen werden.
Zustellung prüfen: Jede Zustellung trägt den Header X-SubWave-Signature: sha256=…. Rechne HMAC-SHA256 über den rohen Anfragekörper mit dem Geheimnis des Ziels und vergleiche timing-sicher – bei Abweichung verwerfen.
REST API v2 liest Timer, Stats, Events, Ziele, Queue, Clip-Marker und den letzten Stream-Bericht. Sichere POSTs sind bewusst nur für Timer, Queue und neue Marker offen und verlangen immer Idempotency-Key. Den maschinenlesbaren Vertrag findest du über den OpenAPI-Link in der Karte. Die alte v1-API bleibt nur lesend kompatibel.
Discord-Tipp: Discord-Webhook-URL einfügen, Format „Discord" wählen – fertig. SubWaveBot postet dann fertige Embed-Nachrichten direkt in deinen Channel.
Under 🔌 API & Webhooks in the dashboard you connect your own tools to your channel. Outgoing webhooks report booked events (subs, gifts, bits, donations, follows, raids, hype train) via HTTP POST to up to 5 of your own targets.
In the same card you can create multiple REST API v2 keys for new integrations, each with only the scopes it needs. Every key is shown in plain text only once and can be revoked individually.
Verifying a delivery: every delivery carries the header X-SubWave-Signature: sha256=…. Compute HMAC-SHA256 over the raw request body with the target's secret and compare in constant time – discard on mismatch.
REST API v2 can read timer, stats, events, goals, queue, clip markers and the latest stream report. Safe POSTs are intentionally limited to timer, queue and new markers and always require Idempotency-Key. The machine-readable contract is available through the OpenAPI link in the dashboard. Legacy v1 stays read-only compatible.
Discord tip: paste your Discord webhook URL, pick the "Discord" format – done. SubWaveBot then posts ready-made embed messages straight into your channel.
🛠️ FehlerbehebungTroubleshooting
Overlay zeigt nichts / „nicht verfügbar": Link im Dashboard neu kopieren (Token kann sich geändert haben).
Befehle reagieren nicht auf einer Plattform: prüfen, ob die Plattform verbunden und der Bot dort als Chat-Absender berechtigt ist. Den Verbindungsstatus siehst du im Plattformen-Tab; im Events-Tab siehst du live, was ankommt.
Overlay shows nothing / "not available": re-copy the link from the dashboard (the token may have changed).
Commands do not respond on one platform: check that the platform is connected and the bot is allowed to send chat there. You can see the connection status in the Platforms tab; the Events tab shows live what is coming in.