Stream-Alerts

Cloudy pingt deinen Server, wenn jemand auf Twitch oder Kick live geht, auf YouTube etwas hochlädt oder auf TikTok ein neues Video postet. Jede Plattform ist eine eigene Seite in der Sidebar, aber sie teilen eine Konfigurationsform und eine Abo-Liste.

Schalter pro Plattform

Das ist der Punkt, über den man stolpert: Der Hauptschalter gilt pro Plattform.

YouTube auszuschalten schaltet Twitch oder Kick nicht aus. Jede Seite schreibt ihren eigenen Schalter, du kannst also Twitch-Alerts laufen lassen und YouTube ruhen lassen, ohne die Abos zu verlieren.

Einen Creator hinzufügen

Plattform

Ergibt sich aus der Seite, auf der du bist. Ein Eintrag pro Creator und Plattform — derselbe Streamer kann mit zwei getrennten Einträgen auf Twitch und Kick verfolgt werden.

Streamer-Name

1–100 Zeichen · Pflicht

Der URL-Slug, exakt so, wie er in der Adressleiste steht:

Twitch-, Kick- und TikTok-Namen werden in Kleinbuchstaben gespeichert, und eine eingefügte Twitch- oder Kick-Kanal-URL wird auf den Namen darin gekürzt. Ein Twitch- oder Kick-Name, den es nicht geben kann (Leerzeichen, ein Link auf eine andere Seite, auf Twitch mehr als 25 Zeichen), wird beim Speichern abgelehnt. Ein YouTube-Eintrag wird beim nächsten Durchlauf aufgelöst und zeigt danach den echten Kanaltitel in der Liste. Ein @Handle, eine UC…-ID oder eine Kanal-URL, die YouTube nicht kennt, wird nie geraten: Der Eintrag bleibt, wie er ist, und wird einen Tag später erneut aufgelöst — oder sofort, sobald du ihn korrigierst. Nur ein bloßer Name ohne @ fällt auf die YouTube-Suche zurück, die den bekanntesten Kanal dieses Namens nimmt.

Discord-Kanal

Pflicht

Wo die Benachrichtigung gepostet wird.

Ping-Rolle

Optional

Wird am Anfang jeder Live-, Upload- und TikTok-Benachrichtigung erwähnt. Mach daraus eine Opt-in-Rolle, die Mitglieder sich über Reaction Roles selbst geben — ein Stream-Ping an @everyone mehrmals pro Woche ist der schnellste Weg, dass Mitglieder den Server stummschalten.

Eigene Nachricht

Bis 500 Zeichen · optional

Die Benachrichtigung ist immer ein Embed mit einer Textzeile darüber. Leer nutzt Cloudys Standardzeile (**Name** ist jetzt live auf Twitch!); gesetzt ersetzt sie diese Zeile durch deinen eigenen Text. Die Ping-Rolle wird weiterhin davor gestellt.

Der Text wird exakt so gepostet, wie du ihn schreibst — es gibt keine Platzhalter für Streamer, Titel oder Link. Das Embed darunter trägt Name, Titel, Kategorie, Zuschauerzahl und einen „Ansehen"-Button.

Aktiv

Standard true

Aus heißt, der Bot ignoriert diesen Eintrag, behält aber die Daten. Nutze es, um einen Creator in der Pause stillzulegen, statt ihn zu löschen und später neu anzulegen. Ist der Creator in dem Moment live, wird die Live-Nachricht entfernt, und die Twitch-Clips des Eintrags pausieren mit. Uploads, TikToks und Clips, die erscheinen, während ein Eintrag aus ist, werden beim Wiedereinschalten nicht nachgereicht — das gilt genauso für den Plattform-Schalter und eine abgelaufene Lizenz: Neu ist nur, was danach veröffentlicht wird.

Twitch-Clips

Twitch-Einträge haben zwei zusätzliche Felder.

Clip-Benachrichtigungen

Standard false

Postet eine Nachricht mit dem Vorschaubild des Clips, sobald für diesen Streamer ein neuer Clip entsteht. Cloudy prüft alle zwei Minuten und kündigt nur Clips an, die nach dem Einschalten entstanden sind — nichts von davor wird nachgereicht. Das gilt auch nach einer Pause: Werden Clips, der Eintrag, die Plattform oder die Lizenz wieder eingeschaltet, beginnt es von vorn; Clips aus der Zwischenzeit werden nicht gepostet.

Clip-Posts pingen die Rolle nicht und nutzen die eigene Nachricht nicht.

Clip-Kanal

Pflicht, wenn Clip-Benachrichtigungen an sind

Wo neue Clips gepostet werden. Speichern mit aktivierten Clips ohne Kanal wird abgelehnt — eine Clip-Benachrichtigung ohne Ziel würde still verworfen.

Kick, YouTube und TikTok haben keine Clip-Unterstützung; die Felder erscheinen auf diesen Seiten nicht.

Verhaltenshinweise

• Twitch-Livegänge werden von Twitch gepusht und zusätzlich jede Minute abgefragt; Kick wird jede Minute abgefragt. Alerts kommen etwa binnen einer Minute nach dem Livegang.
• YouTube-Uploads werden alle fünf Minuten geprüft, TikTok-Profile alle zehn. Beim Hinzufügen eines YouTube-Kanals wird das neueste vorhandene Video still als Ausgangspunkt gemerkt — nur danach veröffentlichte Videos werden angekündigt. Beim Hinzufügen eines TikTok-Profils wird dessen neuestes vorhandenes Video einmal angekündigt, damit du siehst, dass der Eintrag funktioniert; danach nur noch neue Videos. YouTube-Shorts werden als Shorts angekündigt.
• YouTube erlaubt dem Bot nur eine feste Zahl Anfragen pro Tag. Bis etwa 27 verfolgte YouTube-Kanäle (über alle Server) wird jeder alle fünf Minuten geprüft; darüber hinaus werden sie reihum geprüft, ein Upload kann dann ein paar Minuten später angekündigt werden — übersprungen wird er nie.
• Während ein Stream läuft, wird das Embed etwa alle zwei Minuten aktualisiert (Titel, Kategorie, Zuschauer, Vorschaubild).
• Ein Alert pro Stream-Sitzung. Meldet die Plattform den Stream fünf Minuten lang als beendet, löscht Cloudy seine Live-Nachricht — dafür braucht es Nachrichten verwalten; ohne dieses Recht bleibt die Nachricht stehen. Ein Stream, der abbricht und binnen dieser fünf Minuten wieder da ist, behält seinen Alert: Eine wacklige Verbindung pingt die Rolle nicht erneut — auch dann nicht, wenn der Abbruch kürzer als eine Prüfung ist oder Cloudy mittendrin neu startet. Eine neue Sitzung danach bekommt einen frischen Alert.
• Löscht jemand die Live-Nachricht, während der Stream läuft, postet Cloudy sie für diesen Stream nicht erneut. Der nächste Stream wird wie gewohnt angekündigt.
• Eine Benachrichtigung, die sich nicht posten lässt (etwa weil Cloudy den Zugriff auf den Kanal verloren hat), wird bei jeder Prüfung erneut versucht, bis der Upload einen Tag alt ist, und dann verworfen — sie erscheint nicht Tage später, sobald das Recht wieder stimmt, und ein Neustart des Bots verlängert diesen Tag nicht. Ein gelöschter Discord-Kanal wird einmal im Bot-Log gemeldet; wähl für den Eintrag einen neuen Kanal.
• Auf einem Server mit Custom Bot wird eine Live-Nachricht, die Cloudy vor der Übergabe gepostet hat, einmal durch eine eigene Kopie deines Bots ersetzt — ohne zweiten Ping. Ein Bot kann nur seine eigenen Nachrichten bearbeiten, und der Alert soll weiter aktuell bleiben.
• Löschst du einen Eintrag, der gerade live ist, verschwindet erst die Live-Nachricht aus Discord, dann der Eintrag. Das dauert einen Moment — die Liste zeigt den Zwischenzustand.
• TikTok funktioniert nur für öffentliche Profile, und neue Videos können ein paar Minuten brauchen, bis sie auftauchen.
• Ein falsch geschriebener Benutzername erzeugt weder Fehler noch Alerts. Kündigt ein Creator nie an, prüf zuerst den Slug gegen seine URL.