Kage Music: Radio und Streams im Sprachkanal abspielen

Kage Music spielt Internet-Radio und direkte Audio-Streams in einem Sprachkanal. Gesteuert wird es mit Befehlen oder mit einem Steuerpanel aus Buttons und einer Stations-Auswahl. Kage Music spielt bewusst kein YouTube und kein Spotify, denn deren Nutzungsbedingungen erlauben das nicht. Eine zweite, rechtegeprüfte Quelle ist die Kage Music Library.

Eine kurze Anleitung findest du im Ratgeber Musik-Bot einrichten.

Was abgespielt wird

Die acht Stationen (Befehl /music stations):

Voraussetzungen

• Zugriff auf das Modul: Du meldest dich im Dashboard mit Discord an und brauchst das Recht Server verwalten (oder einen für dieses Modul freigegebenen Zugriff).
• Rechte von Kage im Sprachkanal: Verbinden und Sprechen. Für /music panel zusätzlich Nachrichten senden im Chat des Sprachkanals.
• Du selbst musst in einem Sprachkanal sein, wenn du etwas startest.
• Tarif: Welchen Tarif das Modul braucht, zeigt der Tarifhinweis oben auf dieser Seite.

Einrichten

1. Öffne im Dashboard das Modul Kage Music und schalte Kage Music aktiv ein.
2. Wähle optional eine DJ-Rolle. Ohne Auswahl darf jedes Mitglied steuern.
3. Stelle Maximale Lautstärke (%) und Auto-Leave nach (Sekunden) ein.
4. Entscheide bei Eigene direkte Stream-URLs erlauben, ob nur die kuratierten Stationen oder auch eigene Streams spielbar sind.
5. Speichere.
6. Optional: Wähle unter Anleitung in einen Kanal posten einen Textkanal und klicke Anleitung posten. Kage schreibt ein Embed mit den wichtigsten Befehlen. Mit inkl. funktionierendem Steuerpanel enthält die Nachricht ein Panel, das sofort funktioniert, ideal als fester Musik-Kanal.

Abspielen

Mit dem Panel:

1. Betritt einen Sprachkanal.
2. Gib /music panel ein. Kage kommt in deinen Kanal und postet das Steuerpanel in den Chat dieses Sprachkanals.
3. Wähle im Panel eine Station.

Mit einem Befehl: /music play quelle:lofi oder mit einer Stream-URL. Kage tritt deinem Kanal bei und spielt. Läuft schon etwas, reiht Kage den neuen Eintrag in die Warteschlange ein und nennt die Position.

Kage bleibt mit ausgeschaltetem Lautsprecher im Kanal, hört dir also nicht zu.

Das Steuerpanel

Wichtig:

• Station wechseln: Radio-Streams enden nicht von selbst. Wählst du im Panel eine andere Station, während ein Sender läuft, merkt Kage sie als Nächstes vor. Drücke danach ⏭️, um sofort zu wechseln.
• ⏯️, ⏭️, 🔉 und 🔊 reagieren nur bei Mitgliedern, die im selben Sprachkanal wie Kage sitzen, oder bei Mitgliedern mit Server verwalten. ⏹️ prüft nur die Steuerberechtigung.
• Das zuletzt gepostete Panel aktualisiert sich bei jedem Wechsel selbst. Die Buttons bleiben auch nach einem Neustart von Kage gültig.

Befehle im Überblick

„Steuernde“ sind alle, wenn keine DJ-Rolle gesetzt ist, sonst die DJ-Rolle und alle mit Server verwalten. In englischsprachigen Discord-Clients heißen die Parameter source, percent und role, und der Befehl heißt dj-role.

Der Befehl /music dj-rolle schaltet das Modul zusätzlich ein, falls es noch aus war.

Lautstärke, Warteschlange und Auto-Leave

• Lautstärke: Kage startet mit 100 Prozent oder, falls niedriger, mit der Obergrenze. /music volume und die Panel-Tasten bleiben immer unter der Maximalen Lautstärke (10 bis 200 Prozent).
• Warteschlange: Ein weiterer Eintrag startet automatisch, sobald der aktuelle endet. Da ein Radio-Stream nicht endet, kommt der nächste Eintrag erst nach ⏭️ an die Reihe.
• Auto-Leave: Sind keine Menschen mehr im Kanal, wartet Kage die eingestellte Zeit und verlässt den Kanal, wenn immer noch niemand da ist. Dabei verwirft Kage die Warteschlange. Die kürzeste Wartezeit sind 15 Sekunden: Auch bei 0 wartet Kage 15 Sekunden. Der Hinweis „0 = nie“ im Dashboard trifft nicht zu.
• Neue Werte: Maximale Lautstärke und Auto-Leave übernimmt Kage erst, wenn er den Kanal einmal verlassen hat (zum Beispiel nach /music stop) und beim nächsten Start neu beitritt. DJ-Rolle und Stream-URL-Erlaubnis gelten sofort.

Ein Bot, ein Sprachkanal

Kage kann pro Server nur in einem Sprachkanal gleichzeitig sein. Sitzt Kage schon in einem anderen Kanal, in dem noch Menschen zuhören, holt ihn niemand dorthin weg. Beende die Wiedergabe dort zuerst mit /music stop. Sind nur noch Bots im alten Kanal, wechselt Kage ohne Weiteres. Mit Enterprise laufen bis zu drei Bots parallel, siehe Zusätzliche Kage-Music-Bots.

Eigene Stream-URLs

Mit der Erlaubnis im Dashboard akzeptiert Kage http://- und https://-Adressen, die ein direkter Audio-Stream sind. Als solcher gilt eine Adresse, die

• auf .mp3, .aac, .ogg, .opus, .m4a, .flac oder .wav endet (auch mit angehängter Abfrage), oder
• /stream, icecast, :8000 oder :8085 enthält.

Webseiten wie YouTube löst Kage nicht auf. Der Titel in Panel und Warteschlange ist das letzte Stück der Adresse, höchstens 80 Zeichen.

Bricht ein Stream ab, versucht Kage kurz, die Verbindung wiederherzustellen. Endet der Stream endgültig, bleibt Kage still im Kanal, bis du etwas Neues startest oder die Auto-Leave-Zeit greift.

Einstellungen im Überblick

Jede gestartete Wiedergabe steht im Reiter Logs, und die Zahl der Wiedergaben pro Tag im Reiter Statistik.

Ergebnis überprüfen

1. Aktivieren: Schalte das Modul ein und speichere.
2. Panel: Betritt einen Sprachkanal und gib /music panel ein. Kage kommt dazu und postet das Panel.
3. Station: Wähle eine Station. Sie spielt, und das Panel zeigt Titel und Lautstärke.
4. Steuern: Drücke 🔊 und ⏯️. Lautstärke und Pause ändern sich.
5. Beenden: Drücke ⏹️. Kage verlässt den Kanal.

Fehlerbehebung

„Das Music-Modul ist auf diesem Server nicht aktiviert“

Schalte Kage Music aktiv im Dashboard ein und speichere.

Kage kommt nicht in den Kanal

Prüfe Verbinden und Sprechen für Kage in diesem Kanal. Fehlt ein Recht, nennt Kage es in der Antwort. Erscheint „Ich konnte dem Sprachkanal nicht beitreten“, prüfe zusätzlich, ob Kage den Kanal sehen darf.

„Die Verbindung zum Sprach-Server hat das Zeitlimit überschritten“

Das ist ein Netzwerkproblem auf Seiten der Kage-Server und keine Einstellung bei dir. Versuche es später erneut oder melde es dem Support.

„Unbekannte Station und keine gültige direkte Audio-Stream-URL“

Prüfe die Schreibweise mit /music stations. Bei einer URL muss es ein direkter Audio-Stream sein, und Eigene direkte Stream-URLs erlauben muss an sein.

„Kage Music läuft gerade in …“

Kage spielt in einem anderen Kanal, in dem noch Menschen sitzen. Beende dort mit /music stop oder nutze einen zusätzlichen Bot.

Ich darf nicht steuern

Es ist eine DJ-Rolle gesetzt. Nur diese Rolle und alle mit Server verwalten dürfen steuern. Die Tasten im Panel funktionieren zusätzlich nur im Sprachkanal von Kage.

Es ist nichts zu hören

Prüfe die Lautstärke: Mit 🔉 lässt sie sich bis auf 0 senken. Prüfe außerdem, ob der Stream selbst online ist.

Neue Lautstärke-Obergrenze wirkt nicht

Beende die Wiedergabe mit /music stop und starte neu, siehe „Neue Werte“ oben.

Rechtlicher Hinweis

Die öffentliche Wiedergabe von Musik kann auf deinem Server lizenzpflichtig sein, zum Beispiel über GEMA oder GVL in Deutschland. Die Verantwortung dafür liegt bei dir als Server-Betreiber. Kage wählt für die Stationen Quellen, die das Zuhören frei anbieten. Das ist keine Rechtsberatung.

Weiterführend

Rechtegeprüfte Titel: Kage Music Library. Mehrere Sprachkanäle gleichzeitig: Zusätzliche Kage-Music-Bots. Eigene Sprachkanäle für Gruppen: Temporäre Sprachkanäle.