Before you startBevor du loslegst
- Python 3.11 or newer from python.org. Tick both boxes when installing: “Use admin privileges when installing py.exe” and “Add python.exe to PATH”.Python 3.11 oder neuer von python.org. Beim Installieren beide Haken setzen: „Use admin privileges when installing py.exe“ und „Add python.exe to PATH“.
- The bot package is fully unzipped (right-click the ZIP → “Extract All…”). Don't start it from inside the ZIP.Das Bot-Paket ist vollständig entpackt (Rechtsklick auf die ZIP → „Alle extrahieren …“). Nicht direkt aus der ZIP starten.
- Your channel has channel points (Affiliate or Partner), and Nightbot song requests are turned on.Auf deinem Kanal gibt es Kanalpunkte (Affiliate oder Partner), und die Nightbot-Songrequests sind eingeschaltet.
The bot guides you through every step in its black window and opens the right pages. The green parts in the windows below are what you type. The bot itself speaks German, so the windows show its German texts; the explanations here tell you what each part means.Der Bot führt dich im schwarzen Fenster selbst durch jeden Schritt und öffnet die richtigen Seiten. Die grünen Stellen in den Fenstern sind das, was du eintippst.
Getting readyVorbereitung
Start the botBot starten
Open the unzipped folder and double-click START.bat. On the very first start the bot sets up its own Python environment. That takes about a minute, then the setup begins.Öffne den entpackten Ordner und doppelklick auf START.bat. Beim allerersten Start richtet der Bot seine eigene Python-Umgebung ein. Das dauert etwa eine Minute, danach beginnt die Einrichtung.
Erster Start: Python-Umgebung wird eingerichtet ... ────────────────────────────────────────────────────────────────── EINRICHTUNG SONGREQUEST-BOT ────────────────────────────────────────────────────────────────── Das musst du nur einmal machen. Es dauert etwa 5 Minuten. Lies bei jedem Schritt kurz den Text und tippe dann deine Antwort ein. Einfügen geht mit Strg+V oder Rechtsklick. Bestätigen mit Enter. ────────────────────────────────────────────────────────────────── SCHRITT 1 von 7: Dein Twitch-Channel ────────────────────────────────────────────────────────────────── Gib den Namen deines Twitch-Channels ein, so wie er in deinem Link steht. Beispiel: Dein Link ist twitch.tv/meinchannel -> du tippst: meinchannel Groß-/Kleinschreibung ist egal. Den ganzen Link einfügen geht auch. >> Channel-Name:
Keep this window open for the whole setup.Lass dieses Fenster während der ganzen Einrichtung geöffnet.
BotBot
Enter channel and rewardChannel und Belohnung eingeben
- Type your channel name the way it appears in your link (for
twitch.tv/yourchannelthat'syourchannel) and press Enter.Tipp den Namen deines Channels so ein, wie er in deinem Link steht (beitwitch.tv/deinchannelalsodeinchannel) und drück Enter. - Create the channel point reward on Twitch if you haven't yet: Creator Dashboard → Community → Channel Points → Manage Rewards → “Add New Custom Reward”. Easiest with exactly this title:Leg auf Twitch die Kanalbelohnung an, falls noch nicht geschehen: Creator-Dashboard → Community → Kanalpunkte → Belohnungen verwalten → „Neue benutzerdefinierte Belohnung“. Am einfachsten mit genau diesem Titel:
PUT YOUR SONGREQUEST AT THE TOP - If your reward has exactly that name, just press Enter at the title prompt. Otherwise type the title exactly.Heißt deine Belohnung so, drückst du beim Titel einfach Enter. Sonst den Titel genau abtippen.
... >> Channel-Name: deinchannel ────────────────────────────────────────────────────────────────── SCHRITT 2 von 7: Deine Kanalbelohnung ────────────────────────────────────────────────────────────────── Auf Twitch braucht es eine Kanalpunkte-Belohnung, die Zuschauer einlösen. So legst du sie an: Creator-Dashboard -> Community -> Kanalpunkte -> „Belohnungen verwalten“ -> „Neue benutzerdefinierte Belohnung“. Gib hier GENAU den Titel dieser Belohnung ein. Hast du sie so genannt wie in der Klammer? Dann einfach Enter drücken. >> Titel der Belohnung [Enter = PUT YOUR SONGREQUEST AT THE TOP]: Enter ────────────────────────────────────────────────────────────────── SCHRITT 3 von 7: Twitch-App anlegen (Client-ID) ────────────────────────────────────────────────────────────────── Damit der Bot Einlösungen sehen darf, braucht er eine „App“ bei Twitch. 1. Auf der Seite, die sich gleich öffnet, mit Twitch anmelden. (Falls verlangt: Zwei-Faktor-Anmeldung in den Twitch-Einstellungen aktivieren.) 2. Auf „Deine Anwendung registrieren“ / „Register Your Application“ klicken. 3. Name: irgendwas, z. B. songbot-meinchannel 4. OAuth-Redirect-URL: http://localhost:8765/callback -> „Hinzufügen“ klicken 5. Kategorie: „Chat Bot“. Client-Typ: „Öffentlich“ / „Public“ (wichtig!) 6. Erstellen, dann bei der App auf „Verwalten“ klicken. 7. Die „Client-ID“ kopieren und hier einfügen. >> Drücke Enter, dann öffnet sich die Seite im Browser ...
Then the Twitch Client ID is already built in. Skip steps 3 to 6 of this guide and continue with step 7.Dann ist die Twitch-Client-ID schon eingetragen. Überspring die Schritte 3 bis 6 dieser Anleitung und mach bei 7 weiter.
TwitchTwitch
Register a Twitch applicationEine Twitch-Anwendung registrieren
Press Enter in the bot window. The Twitch developer console opens. Log in, go to “Applications” and click “Register Your Application”.Drück im Bot-Fenster Enter. Die Twitch-Entwicklerkonsole öffnet sich. Melde dich an, geh zu „Anwendungen“ und klick auf „Deine Anwendung registrieren“.
If Twitch asks for two-factor authentication, turn it on first in your Twitch settings under “Security and Privacy”.Verlangt Twitch eine Zwei-Faktor-Anmeldung, aktiviere sie zuerst in deinen Twitch-Einstellungen unter „Sicherheit und Datenschutz“.
TwitchTwitch
Choose the right settingsDie richtigen Einstellungen wählen
Fill in the form like in the picture. The name is up to you. If it's already taken, add your channel name.Füll das Formular wie im Bild aus. Der Name ist frei wählbar. Ist er schon vergeben, häng deinen Kanalnamen an.
| FieldFeld | What to enterWas du einträgst |
|---|---|
| Name | Songrequest Helfer |
| OAuth Redirect URL | http://localhost:8765/callback |
| CategoryKategorie | Chat Bot |
| Client typeClient-Typ | Public (important!)Öffentlich (wichtig!) |
Add the redirect URL with “Add”, then click “Create”.Füg die Redirect-URL mit „Hinzufügen“ hinzu und klick anschließend auf „Erstellen“.
TwitchTwitch
Manage the new applicationDie erstellte Anwendung verwalten
Your application now shows up in the list. Click “Manage” in its row.Deine Anwendung erscheint jetzt in der Übersicht. Klick in ihrer Zeile auf „Verwalten“.
TwitchTwitch
Paste the Twitch Client IDTwitch-Client-ID einfügen
Copy the Client ID at the bottom of the page. Switch to the bot window, paste it at “Twitch-Client-ID:” (Ctrl+V or right-click) and press Enter.Kopier die Client-ID unten auf der Seite. Wechsel ins Bot-Fenster, füg sie bei „Twitch-Client-ID:“ ein (Strg+V oder Rechtsklick) und drück Enter.
Neither your Twitch name nor your password goes here. The bot doesn't need a Twitch secret.Hier gehören weder dein Twitch-Name noch dein Passwort hinein. Ein Twitch-Secret braucht der Bot nicht.
... >> Drücke Enter, dann öffnet sich die Seite im Browser ... Enter >> Twitch-Client-ID: abcdefghijklmnopqrstuvwxyz1234 ────────────────────────────────────────────────────────────────── SCHRITT 4 von 7: Nightbot-App anlegen ────────────────────────────────────────────────────────────────── Damit der Bot Songs nach vorne schieben darf, braucht er eine „App“ bei Nightbot. 1. Auf der Seite, die sich gleich öffnet, mit deinem Twitch-Konto anmelden. 2. Ganz nach unten zu „Your Applications“ scrollen, „New Application“ klicken. 3. Name: irgendwas, z. B. Songrequest Helfer -> „Create“. Danach die App öffnen. 4. „Add Redirect URI“ klicken. Steht dort http://localhost:3000, die Adresse anklicken und genau so ändern: http://localhost:8765/callback 5. Oben stehen jetzt „Client ID“ und „Client Secret“, jeweils mit Kopier-Symbol rechts. Das Fenster mit beiden Werten für die nächsten 2 Schritte offen lassen. >> Drücke Enter, dann öffnet sich die Seite im Browser ...
NightbotNightbot
Open Nightbot applicationsNightbot-Anwendungen öffnen
Press Enter in the bot window. The page Nightbot → Settings → Connections opens. Log in with your Twitch account, scroll to “Your Applications” and click “New application”.Drück im Bot-Fenster Enter. Die Seite Nightbot → Settings → Connections öffnet sich. Melde dich mit deinem Twitch-Konto an, scroll zu „Your Applications“ und klick auf „New application“.
NightbotNightbot
Name the applicationDer Anwendung einen Namen geben
Enter for example “Songrequest Helfer” and confirm with “Create”. Then open the new application.Trag zum Beispiel „Songrequest Helfer“ ein und bestätige mit „Create“. Öffne anschließend die neu angelegte Anwendung.
NightbotNightbot
Redirect URI, Client ID and SecretRedirect-URI, Client-ID und Secret
Click “Add Redirect URI”. If http://localhost:3000 gets inserted, click that address and change it to exactly:Klick auf „Add Redirect URI“. Wird http://localhost:3000 eingefügt, klick direkt auf diese Adresse und änder sie genau auf:
http://localhost:8765/callbackThen check that the full address is shown.Prüf danach, dass die vollständige Adresse angezeigt wird.
- Copy the Client ID with icon ①, paste it in the bot window at “Nightbot-Client-ID:” and press Enter.Kopier die Client ID über das Symbol ①, füg sie im Bot-Fenster bei „Nightbot-Client-ID:“ ein und drück Enter.
- Copy the Client Secret with icon ②, paste it at “Nightbot-Client-Secret:” and press Enter. Do not click the circular arrows next to it, they create a new secret.Kopier das Client Secret über das Symbol ②, füg es bei „Nightbot-Client-Secret:“ ein und drück Enter. Nicht auf die Kreispfeile daneben klicken, die erzeugen ein neues Secret.
When you paste the secret, the characters stay invisible. That's on purpose. If you paste the ID instead of the secret by mistake, the bot notices and asks again.Beim Einfügen des Secrets bleiben die Zeichen unsichtbar. Das ist Absicht. Hast du aus Versehen die ID statt des Secrets eingefügt, merkt der Bot das und fragt nochmal.
... >> Drücke Enter, dann öffnet sich die Seite im Browser ... Enter ────────────────────────────────────────────────────────────────── SCHRITT 5 von 7: Nightbot-Client-ID ────────────────────────────────────────────────────────────────── Kopiere die „Client ID“ (Kopier-Symbol rechts daneben) und füge sie hier ein. Achtung: Das ist die ID, NICHT das Secret. >> Nightbot-Client-ID: 1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d ────────────────────────────────────────────────────────────────── SCHRITT 6 von 7: Nightbot-Client-Secret ────────────────────────────────────────────────────────────────── Kopiere jetzt das „Client Secret“ (Kopier-Symbol, NICHT die Kreispfeile – die erzeugen ein neues). WICHTIG: Beim Einfügen siehst du KEINE Zeichen. Das ist Absicht (wie bei Passwörtern). Einfach einfügen (Strg+V oder Rechtsklick) und Enter drücken. Das Secret niemandem zeigen. Der Bot speichert es verschlüsselt auf deinem PC. >> Nightbot-Client-Secret: (unsichtbar eingefügt) Enter ────────────────────────────────────────────────────────────────── SCHRITT 7 von 7: Anmelden bei Twitch und Nightbot ────────────────────────────────────────────────────────────────── Jetzt öffnen sich nacheinander zwei Seiten im Browser. Beide Male mit deinem Konto „deinchannel“ anmelden und auf „Autorisieren“ / „Allow“ klicken. Danach zurück zu diesem Fenster. Bist du im Browser mit einem anderen Twitch-Konto eingeloggt, vorher abmelden. >> Drücke Enter, um mit Twitch zu beginnen ...
Sign-inAnmeldung
Connect both accountsBeide Konten verbinden
Press Enter in the bot window.Drück im Bot-Fenster Enter.
- Twitch: in the browser, check that you're logged in with your channel account. If the page shows a code, compare it with the one in the bot window. Then click “Activate” and “Authorize”.Twitch: Prüf im Browser, dass du mit dem Konto deines Kanals angemeldet bist. Steht ein Code auf der Seite, vergleich ihn mit dem im Bot-Fenster. Dann auf „Aktivieren“ und „Autorisieren“ klicken.
- Nightbot: the second page opens by itself. Log in with the same Twitch account and click “Allow”. The browser then says “Fertig! Du kannst diesen Tab schließen …”.Nightbot: Die zweite Seite öffnet sich von selbst. Mit demselben Twitch-Konto anmelden und „Allow“ klicken. Im Browser steht danach „Fertig! Du kannst diesen Tab schließen …“.
>> Drücke Enter, um mit Twitch zu beginnen ... Enter [1/2] TWITCH: Im Browser als deinchannel anmelden und „Autorisieren“ klicken. Falls nach einem Code gefragt wird, eintippen: ABCDEFGH Seite geht nicht auf? Diese Adresse öffnen: https://www.twitch.tv/activate?public=true&device-code=ABCDEFGH Warte auf deine Bestätigung ... OK: Twitch ist verbunden. [2/2] NIGHTBOT: Im Browser mit dem Twitch-Konto deinchannel anmelden und „Allow“ klicken. Seite geht nicht auf? Diese Adresse kopieren und im Browser öffnen: https://api.nightbot.tv/oauth2/authorize?client_id=1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d&redirect_uri=http%3A%2F%2Flocalhost%3A8765%2Fcallback&response_type=code&scope=song_requests_queue&state=… Warte auf deine Bestätigung ... ────────────────────────────────────────────────────────────────── FERTIG! Der Bot ist für #deinchannel eingerichtet. Ab jetzt einfach START.bat doppelklicken. Dieses Fenster bitte offen lassen, solange du streamst. Schließen = Bot aus. ────────────────────────────────────────────────────────────────── 09.10. 19:58:04 INFO BEREIT: #deinchannel – „PUT YOUR SONGREQUEST AT THE TOP“ wird überwacht.
The window shows FERTIG! and shortly after BEREIT: #yourchannel. The bot keeps running right away, no restart needed.Im Fenster stehen FERTIG! und kurz danach BEREIT: #deinchannel. Der Bot läuft direkt weiter, du musst nichts neu starten.
Setup done? Time for a test.Einrichtung fertig? Zeit für den Test.
Request a song yourself, then redeem the reward. A few seconds later the window shows:Wünsch dir selbst einen Song und lös danach die Belohnung ein. Ein paar Sekunden später steht im Fenster:
09.10. 20:14:37 INFO EINLÖSUNG: 'Zuschauer'. 09.10. 20:14:40 INFO HOCHGESCHOBEN: 'Zuschauer' – 'Lieblingssong' (war Position 7).
START.batDouble-click before every stream. Keep the window open (minimizing is fine).Vor jedem Stream doppelklicken. Das Fenster offen lassen (minimieren ist ok).
Close the windowFenster schließenStops the bot. Nothing else needed.Beendet den Bot. Mehr ist nicht nötig.
EINRICHTEN.batDifferent channel, different reward title, or sign in again. The bot runs right after.Anderer Channel, anderer Belohnungstitel oder neu anmelden. Danach läuft der Bot direkt.
Keep the Nightbot music player open during the stream as usual. All messages are also written to data\bot.log.Den Nightbot-Musikplayer während des Streams wie gewohnt geöffnet lassen. Alle Meldungen landen zusätzlich in data\bot.log.
What do the messages mean?Was bedeuten die Meldungen?
| MessageMeldung | Meaning and what you can doBedeutung und was du tun kannst |
|---|---|
HOCHGESCHOBEN | It worked.Hat geklappt. |
KEIN SONG | The viewer had no waiting song. You can refund their points in the dashboard.Der Zuschauer hatte keinen wartenden Song. Die Punkte kannst du ihm im Dashboard zurückgeben. |
MANUELL PRÜFEN | Nightbot didn't answer clearly. Take a quick look at the queue. The bot deliberately doesn't try a second time.Nightbot hat nicht eindeutig geantwortet. Schau kurz in die Queue. Der Bot versucht es absichtlich nicht ein zweites Mal. |
Twitch-Verbindung unterbrochen | Short internet dropout. The bot reconnects by itself. Redemptions during exactly that pause are not caught up.Kurzer Internet-Aussetzer. Der Bot verbindet sich selbst neu. Einlösungen genau in dieser Pause holt er nicht nach. |
Kanalbelohnung … nicht gefunden | The title doesn't match exactly, or the reward is paused or deleted. Fix it with EINRICHTEN.bat.Der Titel stimmt nicht genau oder die Belohnung ist pausiert/gelöscht. Mit EINRICHTEN.bat korrigieren. |
Bei Twitch ist „…“ angemeldet | You signed in with a different account. Log out in the browser, then run EINRICHTEN.bat.Du hast dich mit einem anderen Konto angemeldet. Im Browser abmelden, dann EINRICHTEN.bat. |
Twitch lehnt die Client-ID ab | The Twitch app isn't “Public” or the ID was copied wrong. Check the app, then run EINRICHTEN.bat.Die Twitch-App ist nicht „Öffentlich“ oder die ID ist falsch kopiert. App prüfen, dann EINRICHTEN.bat. |
Nightbot-Anmeldung fehlgeschlagen | Usually the redirect URI isn't exactly right (see step 9) or the secret was regenerated. Check, then run EINRICHTEN.bat.Meist stimmt die Redirect-URI nicht genau (siehe Schritt 9) oder das Secret wurde neu erzeugt. Prüfen, dann EINRICHTEN.bat. |
EINRICHTEN.bat starten | The sign-in has expired (for example after about two months off) or was revoked. Double-click EINRICHTEN.bat. IDs you already entered are kept with Enter.Die Anmeldung ist abgelaufen (z. B. nach etwa zwei Monaten Pause) oder wurde entzogen. EINRICHTEN.bat doppelklicken. Bereits eingetragene IDs übernimmst du dabei mit Enter. |
Bitte Python 3.11 oder neuer installieren | Python is missing or the “py.exe” box wasn't ticked. Reinstall Python, see “Before you start”.Python fehlt oder der Haken bei „py.exe“ wurde nicht gesetzt. Python neu installieren, siehe „Bevor du loslegst“. |
Der Bot läuft schon | It's already open in another window. Use that window.Er ist schon in einem anderen Fenster offen. Das andere Fenster nutzen. |
Port 8765 ist belegt | Another program is blocking the sign-in. Restart your PC and try again.Ein anderes Programm blockiert die Anmeldung. PC neu starten und nochmal versuchen. |
Reset everything: close the window and delete the data folder. To also remove the bot's access on the platforms, remove it on Twitch under Settings → Connections and on Nightbot under Settings → Connections.Alles zurücksetzen: Fenster schließen und den Ordner data löschen. Willst du dem Bot den Zugriff auch auf den Plattformen entziehen, entferne ihn bei Twitch unter Einstellungen → Verbindungen und bei Nightbot unter Settings → Connections.
Security: the bot never asks for passwords. The sign-in and the Nightbot secret are stored encrypted, only on your PC. Never share the data folder or your secret.Sicherheit: Der Bot fragt nie nach Passwörtern. Anmeldung und Nightbot-Secret werden verschlüsselt nur auf deinem PC gespeichert. Gib den Ordner data und dein Secret niemals weiter.