01Was du brauchst
Du brauchst das ItsBagelBot-Dashboard, angemeldet mit deinem Twitch-Konto, und ein Spotify-Konto. Das Spotify-Konto, das du verbindest, braucht Premium, damit der Bot die Wiedergabe steuern und Songwünsche zu deiner Warteschlange hinzufügen kann. Songwünsche laufen über eine Spotify-App, die du selbst im Spotify-Entwicklerdashboard erstellst. Das Konto, dem diese App gehört, braucht ebenfalls Premium, und Spotify erlaubt jeder App höchstens 5 Konten. Die meisten Streamer nutzen für beides ein Konto. Spotify muss außerdem auf einem Gerät laufen (der Desktop-App, deinem Handy oder einem Webplayer), während Zuschauer Songs wünschen.
02Spotify im Dashboard einrichten
Öffne dashboard.itsbagelbot.com/songqueue. Solange Spotify nicht verbunden ist, zeigt die Seite eine Einrichtung mit vier Schritten: Willkommen, App erstellen, Schlüssel hinzufügen und Spotify verbinden. Folge den Schritten unten der Reihe nach. Jeder Einrichtungsschritt hat eine Schaltfläche „Bitte deine KI um Hilfe“, die am Ende dieser Anleitung beschrieben ist.
- Die Einrichtung starten
Lies im Schritt Willkommen den Hinweis „Spotify Premium ist erforderlich“ und wähle dann Spotify einrichten.
- Das Spotify-Entwicklerdashboard öffnen
Wähle im Schritt App erstellen die Option Spotify-Dashboard öffnen. Dadurch öffnet sich
developer.spotify.com/dashboardin einem neuen Tab. Melde dich mit dem Spotify-Konto an, dem die App gehören wird. - Die App bei Spotify erstellen
Wähle im Spotify-Entwicklerdashboard Create an App. Gib der App einen Namen und eine Beschreibung, akzeptiere die Developer Terms of Service und erstelle die App. Spotify zeigt Name und Beschreibung jedem, der sich darüber verbindet. Wähle deshalb etwas, das du wiedererkennst.
- Die Redirect URI kopieren
Geh zurück zum ItsBagelBot-Tab. Wähle unter Redirect URI die Option Kopieren. Die Schaltfläche wechselt zu „Redirect URI kopiert.“
- In deine Spotify-App einfügen
Öffne in Spotify die Einstellungen deiner App. Füge den Wert in das Feld Redirect URIs ein und speichere deine Änderungen. Er muss genau übereinstimmen, ohne zusätzlichen Schrägstrich oder Leerzeichen. Spotify vergleicht ihn Zeichen für Zeichen.
- Bestätigen, dass die App erstellt ist
Zurück in ItsBagelBot wählst du Meine App ist bereit. Fehlt die Redirect URI, bleibt die Schaltfläche deaktiviert, und die Seite erklärt, dass der Wert im Moment nicht verfügbar ist.
- Client ID und Client Secret kopieren
Im Schritt Schlüssel hinzufügen wechselst du zu Spotify und öffnest die Settings deiner App. Kopiere die Client ID. Zeige das Client Secret auf derselben Seite an und kopiere es ebenfalls.
- Beide Werte im Dashboard einfügen
Füge den ersten Wert in Client ID und den zweiten in Client-Secret ein und wähle dann Speichern und weiter. Füge sie ohne Leerzeichen ein. ItsBagelBot speichert das Secret verschlüsselt und zeigt es nie wieder an. Füge es also erneut ein, falls du es jemals änderst.
- Dein Spotify-Konto verbinden
Im Schritt Spotify verbinden steht auf der Seite „Deine App ist gespeichert und bereit.“ Wähle Spotify verbinden. Spotify öffnet einen Berechtigungsbildschirm. Erteile die Berechtigungen auf dem Bildschirm von Spotify. Schließt du den Bildschirm ohne Zustimmung, bricht die Verbindung ab. Direkt nach dem Verbinden kann eine Warnung erscheinen. Die Verbindung funktioniert trotzdem, und die Tabelle unter „Wenn etwas schiefgeht“ sagt dir, was zu tun ist.
- Das Ergebnis prüfen
Spotify bringt dich zurück zur Seite Musikwünsche. Der Bereich Verbindung zeigt das Abzeichen Verbunden, und es erscheint die Meldung „Spotify verbunden.“ Jetzt kannst du die Wünsche aktivieren.
03Musikwünsche aktivieren
Sobald Spotify verbunden ist, zeigt die Seite Musikwünsche den Rest der Einrichtung. Beide Wege nutzen dieselbe Warteschlange, und einer kann aktiv sein, während der andere aus ist.
- Das Modul aktivieren
Aktiviere oben auf der Seite Musikwünsche aktivieren. Solange das aus ist, zeigt die Seite an, dass Wünsche pausiert sind und keiner der Wege etwas einreiht.
- Den Chat-Befehl einrichten
Aktiviere in der Karte Chat-Befehl (!sr) die Option !sr erlauben. Wähle unter Wer Songs einreihen darf eine der Optionen Nur ich, Nur Moderatoren, Nur VIPs, Nur Abonnenten oder Alle. Nur live ist standardmäßig aktiviert, daher funktionieren Wünsche nur während deines Streams. Deaktiviere es, um Wünsche auch offline zu erlauben. Diese Schalter werden gespeichert, sobald du sie änderst.
- Die Anzahl der Songs pro Zuschauer begrenzen
Dieser Schritt ist optional. Gib unter Limits pro Zuschauer für jede Stufe eine Zahl ein (Alle, Abonnenten, VIPs, Moderatoren) und wähle Limits speichern. Eine leere Stufe bedeutet kein Limit. Du selbst bist nie begrenzt.
- Die Kanalpunkte-Belohnung erstellen
Schau in der Karte Kanalpunkte nach: Die Zeile Musikwunsch zeigt „Nicht eingerichtet“, bis du die Belohnung erstellt hast. Öffne sie und wähle Belohnung erstellen. Fülle Belohnungstitel aus (Standard: „Musikwunsch abspielen“), dazu Punktekosten, Globale Abklingzeit (0 = aus) und Chat-Antwort. Farbe ist optional. Die Belohnung erscheint im Twitch-Punktemenü, sobald du speicherst.
- Festlegen, was nach einer Einlösung passiert
Wähle unter Nach der Einlösung eine Option: „Abschließen: Song wird eingereiht (Standard)“, „Abbrechen: Punkte zurückerstatten, nicht einreihen“ oder „Für manuelle Bearbeitung durch Mods offen lassen“.
- Einlösungen annehmen
Aktiviere Belohnungseinlösungen annehmen. Solange das aus ist, werden Einlösungen erstattet und nichts wird eingereiht. Nur live ist in dieser Karte ebenfalls standardmäßig aktiviert. Deaktiviere es, um Einlösungen auch offline zu erlauben.
Zuschauer tippen !sr, gefolgt von einem Songnamen, einem Paar „artist - song“ oder einem Spotify-Link.
Einlösungen über Kanalpunkte funktionieren genauso: Der Zuschauer gibt den Song beim Einlösen ein. Die Karte
Warteschlange auf derselben Seite zeigt, was läuft und was wartet, und hat eine Schaltfläche Überspringen.
SnackPackPanda !sr artist - song
ItsBagelBot @SnackPackPanda „Song“ von Artist eingereiht, Position #2.
04Wenn etwas schiefgeht
Die erste Tabelle listet die Meldungen, die du im Dashboard siehst. Die zweite listet, was Zuschauer im Chat sehen. Die Meldungen sind so kopiert, wie das Dashboard sie anzeigt. Die Liste deckt die Meldungen ab, die du wahrscheinlich siehst.
| Was du siehst | Was das bedeutet | Was du tun kannst |
|---|---|---|
| Spotify Premium ist erforderlich | Das verbundene Konto braucht Premium. Das Konto, dem deine Spotify-App gehört, braucht ebenfalls Premium, und jede App kann höchstens 5 Konten verbinden. | Verbinde ein Konto mit Premium, prüfe, ob der Besitzer der App Premium hat, und bleib bei höchstens 5 Konten. |
| Du hast den Spotify-Berechtigungsbildschirm geschlossen, bevor du zugestimmt hast. Wähle Spotify verbinden und erteile die Berechtigungen, um abzuschließen. | Du hast den Berechtigungsbildschirm von Spotify verlassen, ohne zuzustimmen, daher wurde nichts verbunden. | Wähle erneut Spotify verbinden und erteile die Berechtigungen auf dem Bildschirm von Spotify. |
| Der Anmeldelink ist abgelaufen oder wurde erneut verwendet. Starte die Verbindung erneut. | Der verwendete Anmeldelink ist nicht mehr gültig. | Wähle erneut Spotify verbinden, um eine neue Anmeldung zu starten. |
| Spotify hat die Anmeldung abgelehnt. Prüfe, ob Client-ID und Client-Secret zu deiner Spotify-App gehören und ob die Redirect URI von dieser Seite in dieser App gespeichert ist. Verbinde dich dann erneut. | Spotify hat die Zugangsdaten oder die Redirect URI abgelehnt. | Kopiere Client-ID und Client-Secret erneut aus den Settings deiner App. Prüfe, ob die Redirect URI aus dem Dashboard in deiner Spotify-App gespeichert ist, Zeichen für Zeichen. Verbinde dich dann erneut. |
| Spotify hat kein neues Anmeldetoken gesendet. Öffne spotify.com/account/apps, entferne den Zugriff für deine App und wähle dann Spotify verbinden und stimme erneut zu. | Spotify hat für diese Verbindung keine neuen Zugangsdaten ausgestellt. | Öffne spotify.com/account/apps, entferne den Zugriff für deine App und wähle dann erneut Spotify verbinden und erteile die Berechtigungen. |
| Füge deine Spotify-App hinzu, bevor du dein Konto verbindest. | Es ist noch keine Spotify-App gespeichert. | Geh zurück zum Schritt Schlüssel hinzufügen, füge Client-ID und Client-Secret ein und wähle Speichern und weiter. |
| Die Spotify-Einrichtung ist auf unserer Seite gerade nicht verfügbar. Versuche es später erneut. Wenn das länger als einen Tag dauert, schreibe an support@itsbagelbot.com. | Das Problem liegt auf der Seite von ItsBagelBot, nicht in deiner Spotify-App. | Versuche es später erneut. Dauert es länger als einen Tag, schreibe an support@itsbagelbot.com. |
| Das Token konnte nicht gespeichert werden. Versuche es gleich noch mal. | Spotify hat die Verbindung akzeptiert, aber ItsBagelBot konnte die Zugangsdaten nicht speichern. | Warte einen Moment und wähle erneut Spotify verbinden. |
| Das sieht nicht nach einer Client-ID und einem Client-Secret aus. Kopiere beides erneut von der Settings-Seite deiner App im Spotify-Entwicklerdashboard, ohne Leerzeichen. | Die beiden Werte sahen nicht wie eine gültige Client-ID und ein gültiges Client-Secret aus, deshalb wurden sie nicht gespeichert. | Kopiere beides erneut von der Einstellungsseite deiner App in Spotify, füge es ohne Leerzeichen ein und wähle Speichern und weiter. |
| Die Spotify-App konnte nicht gespeichert werden. | Die Zugangsdaten konnten nicht gespeichert werden. | Wähle erneut Speichern und weiter. Schlägt es weiterhin fehl, prüfe die Werte und versuche es später noch einmal. |
| Die Redirect URI ist auf unserer Seite gerade nicht verfügbar, deshalb kannst du noch nicht fortfahren. Versuche es später erneut. | Das Dashboard kann dir die Redirect URI zum Kopieren nicht anzeigen. | Versuche es später erneut. |
| Deiner Spotify-Verbindung fehlt eine Berechtigung, die Songwünsche brauchen. Verbinde sie erneut, um sie zu erteilen. | Die Spotify-Verbindung wurde ohne eine Berechtigung hergestellt, die Songwünsche brauchen. | Wähle Spotify erneut verbinden und erteile die Berechtigungen auf dem Bildschirm von Spotify. |
| Deiner Twitch-Anmeldung fehlt die Berechtigung für Kanalpunkte, die diese Belohnung braucht. Melde dich erneut mit Twitch an, um sie zu erteilen. | Deine Twitch-Anmeldung enthält keine Berechtigung für Kanalpunkte. Das ist eine Twitch-Berechtigung, keine Spotify-Berechtigung. | Wähle Erneut mit Twitch anmelden und erteile die Berechtigung. |
| Spotify akzeptiert diese Verbindung nicht mehr, daher sind Songwünsche pausiert. Verbinde sie erneut, um sie fortzusetzen. | Spotify hat die gespeicherte Verbindung nicht mehr akzeptiert. Die Seite zeigt außerdem Erneute Verbindung nötig. | Verbinde Spotify erneut. Schlägt das fehl, folge dem Eintrag zu „Spotify hat kein neues Anmeldetoken gesendet“. |
| Überspringen erfordert Spotify Premium. | Die Schaltfläche Überspringen braucht Premium auf dem verbundenen Konto. | Verwende ein Konto mit Premium. |
| Kein aktives Spotify-Gerät. Starte zuerst eine Wiedergabe. | Spotify spielt auf keinem Gerät. | Öffne Spotify auf einem Gerät, starte einen Song und versuche es dann erneut. |
| Spotify akzeptiert diese Verbindung nicht mehr. Verbinde sie erneut und versuche es noch mal. | Die Verbindung hat aufgehört zu funktionieren, während du auf Überspringen geklickt hast. | Verbinde Spotify erneut und überspringe dann noch einmal. |
| Das Backend konnte nicht erreicht werden. Versuche es gleich erneut. | Die Seite konnte die Einstellungen für Songwünsche nicht laden. | Warte einen Moment und lade die Seite neu. |
| Gib der Belohnung einen Titel. | Das Feld Belohnungstitel ist leer. | Gib einen Titel ein und speichere die Belohnung erneut. |
| Gib eine ganze Punktzahl von mindestens 1 ein. | Die Punktekosten sind keine ganze Zahl von mindestens 1. | Gib eine ganze Zahl ein, 1 oder mehr. |
| Gib eine Abklingzeit zwischen 0 Sekunden und 7 Tagen ein. | Die Globale Abklingzeit liegt außerhalb des erlaubten Bereichs. | Gib eine Abklingzeit von 0 Sekunden (aus) bis 7 Tagen ein. |
| Die Belohnung konnte nicht gespeichert werden. | Die Belohnung konnte nicht gespeichert werden. | Warte einen Moment und speichere erneut. |
| Die Belohnung konnte nicht gelöscht werden. | Die Belohnung wurde nicht gelöscht. | Warte einen Moment und versuche es erneut. |
| Die Befehlseinstellungen konnten nicht gespeichert werden. | Die Einstellungen von Chat-Befehl (!sr) konnten nicht gespeichert werden. | Ändere die Einstellung erneut oder lade die Seite neu und versuche es noch einmal. |
| Der Schalterzustand konnte nicht gespeichert werden. | Der Schalter Musikwünsche aktivieren konnte nicht gespeichert werden. | Lade die Seite neu, prüfe den Schalter und versuche es erneut. |
| Die Limits konnten nicht gespeichert werden. | Die Limits pro Zuschauer konnten nicht gespeichert werden. | Wähle erneut Limits speichern. |
| Der Titel konnte nicht übersprungen werden. Versuche es gleich noch mal. | Die Schaltfläche Überspringen hat nicht funktioniert. | Warte einen Moment und überspringe erneut. |
| Spotify konnte nicht getrennt werden. | Das Trennen hat nicht funktioniert. | Warte einen Moment und versuche es erneut. |
| Die Spotify-App konnte nicht entfernt werden. | Das Entfernen der gespeicherten Spotify-App hat nicht funktioniert. | Warte einen Moment und versuche es erneut. |
| Kopieren fehlgeschlagen. Wähle die URL aus und kopiere sie manuell. | Dein Browser hat die Kopierschaltfläche blockiert. | Wähle die Redirect URI mit der Maus aus und kopiere sie von Hand. |
| Spotify ist verbunden, hat aber den Zugriff auf dieses Konto verweigert. Im Entwicklungsmodus braucht das Konto, dem deine Spotify-App gehört, Premium. Stelle dieses Konto in Spotify auf Premium um und verbinde dich dann erneut. | Die Verbindung hat funktioniert, aber Spotify hat den Zugriff auf dieses Konto verweigert. Im Entwicklungsmodus braucht das Konto, dem deine Spotify-App gehört, Premium. | Stelle in Spotify das Konto, dem deine App gehört, auf Premium um. Verbinde dich danach erneut über die Seite Musikwünsche. |
| Spotify ist verbunden, aber dieses Konto steht nicht in der Liste der zugelassenen Nutzer deiner App. Füge dieses Konto im Spotify-Entwicklerdashboard zu den Nutzern deiner App hinzu und verbinde dich dann erneut. | Die Verbindung hat funktioniert, aber dieses Konto steht nicht auf der Liste der zugelassenen Nutzer deiner App. | Öffne im Spotify-Entwicklerdashboard die Einstellungen deiner App und füge dieses Spotify-Konto den Nutzern der App hinzu. Der Name des Reiters kann abweichen, suche also nach den Einstellungen zur Nutzerverwaltung. Verbinde dich danach erneut über die Seite Musikwünsche. |
| Was du siehst | Was das bedeutet | Was du tun kannst |
|---|---|---|
| @viewer die Musikwünsche sind noch nicht eingerichtet. | Die Einrichtung ist im Kanal noch nicht abgeschlossen. | Schließe die Einrichtung oben ab. |
| @viewer Songwünsche sind pausiert, bis Spotify für diesen Kanal erneut verbunden wird. | Spotify hat die gespeicherte Verbindung nicht mehr akzeptiert. | Wähle auf der Seite Musikwünsche Spotify erneut verbinden. |
| @viewer Songwünsche brauchen in diesem Kanal Spotify Premium. | Das verbundene Konto hat kein Premium. | Verbinde ein Konto mit Premium. |
| @viewer Spotify spielt im Moment auf keinem Gerät Musik. | Spotify hat kein aktives Gerät. | Öffne Spotify und starte einen Titel. |
| @viewer Spotify ist gerade ausgelastet, versuch es gleich noch einmal. | Spotify ist vorübergehend ausgelastet. | Warte einen Moment und wünsche erneut. |
| @viewer dieser Spotify-Link wird nicht unterstützt. Teile einen Link zu einem Titel oder Album. | Der Zuschauer hat einen Link geteilt, der weder ein Titel noch ein Album ist. | Teile einen Link zu einem Titel oder Album oder einen Songnamen. |
| @viewer die Musiksuche ist gerade gestört, versuch es gleich noch einmal. | Die Songsuche ist im Moment nicht verfügbar. | Versuche es später erneut. |
| @viewer Songwünsche im Chat sind im Moment deaktiviert. | !sr erlauben ist deaktiviert. | Aktiviere !sr erlauben. |
| @viewer Songwünsche sind im Moment einem kleineren Kreis vorbehalten. | Der Zuschauer gehört nicht zur Gruppe, die unter Wer Songs einreihen darf gewählt ist. | Ändere Wer Songs einreihen darf, wenn er wünschen soll. |
| @viewer Songwünsche funktionieren nur, wenn der Stream live ist. | Nur live ist aktiviert und der Stream ist offline. | Starte deinen Livestream oder deaktiviere Nur live. |
| @viewer keinen Titel gefunden. Versuch einen Spotify-Link oder „artist - song“. | Spotify hat keinen Treffer gefunden. | Versuche einen Spotify-Link oder ein Paar „artist - song“. |
| @viewer du hast dein Songlimit erreicht (N gleichzeitig in der Warteschlange). !sr remove gibt einen Platz frei. | Der Zuschauer hat sein Limit unter Limits pro Zuschauer erreicht. | Warte, bis ein Song gespielt wurde, oder erhöhe das Limit. |
| @viewer die Songwarteschlange ist im Moment voll. | Die Warteschlange hat ihre maximale Größe erreicht. | Warte, bis Songs gespielt wurden. |
| Songwünsche über Kanalpunkte sind im Moment deaktiviert, deine Punkte wurden erstattet. | Belohnungseinlösungen annehmen ist deaktiviert. | Aktiviere Belohnungseinlösungen annehmen. |
| Songwünsche funktionieren nur während eines Livestreams, deine Punkte wurden erstattet. | Nur live ist in der Karte Kanalpunkte aktiviert und der Stream ist offline. | Starte deinen Livestream oder deaktiviere Nur live. |
| gib einen Songnamen oder einen Spotify-Link ein, deine Punkte wurden erstattet. | Der Zuschauer hat die Belohnung eingelöst, ohne einen Song einzugeben. | Löse erneut ein und gib einen Songnamen oder einen Spotify-Link ein. |
| du hast dein Songlimit für den Moment erreicht, deine Punkte wurden erstattet. | Der Zuschauer hat sein Limit erreicht. | Warte, bis ein Song gespielt wurde. |
| die Songwarteschlange ist voll, deine Punkte wurden erstattet. | Die Warteschlange hat ihre maximale Größe erreicht. | Warte, bis Songs gespielt wurden. |
| dieser Titel konnte nicht zur Warteschlange hinzugefügt werden, deine Punkte wurden erstattet. | Spotify konnte diesen Titel nicht hinzufügen. | Löse erneut mit einem anderen Song ein. |
| @viewer du hast keinen Song in der Warteschlange zum Entfernen. | Der Zuschauer hat !sr remove benutzt, ohne dass ein Song in der Warteschlange war. | Nichts zu beheben. Der Zuschauer kann zuerst einen Song wünschen. |
| Kein Song an Position #N. | Ein Moderator hat eine Position entfernt, die nicht in der Warteschlange ist. | Prüfe die richtige Position in der Karte Warteschlange und versuche es erneut. |
05Hilfe von einer KI holen
Jeder Einrichtungsschritt hat eine Schaltfläche Bitte deine KI um Hilfe. Sie kopiert eine Nachricht in deine Zwischenablage. Die Nachricht nennt den Schritt, auf dem du gerade bist, enthält die Meldung, die das Dashboard anzeigt, und die Redirect URI, und sie enthält einen Link zu dieser Anleitung. Füge sie in ChatGPT, Claude oder Gemini ein. Füge dein Client-Secret niemals in den Chat ein. Die KI braucht es nicht.