YouTube-Benachrichtigungen
Sende eine Nachricht in einen Kanal, wenn ein YouTube-Kanal ein neues Video veröffentlicht oder einen Livestream startet.
Recent changes
Funktionen
- Erhalte Benachrichtigungen in einem Discord-Kanal, wenn ein YouTube-Kanal ein neues Video hochlädt.
- Erhalte Benachrichtigungen, wenn ein YouTube-Kanal einen Livestream startet.
- Filtere YouTube Shorts optional aus den Videobenachrichtigungen heraus.
- Überspringe optional bevorstehende oder geplante Premieren und Livestreams in den Videobenachrichtigungen, bis sie als reguläres Video veröffentlicht wurden.
- Weise dem Discord-Account des YouTubers optional eine "Live"-Rolle zu, solange er streamt, und entferne sie, wenn er offline geht.
- Überwache mehrere YouTube-Kanäle gleichzeitig, jeweils mit eigenem Benachrichtigungskanal und Nachrichtenformat.
- Passe die Benachrichtigungsnachrichten mit Details wie Kanalname, Titel, Beschreibung, URL und Thumbnail an.
Einrichtung
- Öffne die Konfiguration der YouTube-Kanäle (Videobenachrichtigungen), um Benachrichtigungen für Video-Uploads einzurichten, oder die Konfiguration der YouTube-Kanäle (Livebenachrichtigungen), um Benachrichtigungen für Livestreams einzurichten.
- Klicke auf "Neuen YouTube-Kanal hinzufügen" und konfiguriere ihn wie im Konfigurationsabschnitt beschrieben.
- Stelle sicher, dass der Bot im konfigurierten Benachrichtigungskanal die Berechtigungen "Kanal ansehen", "Nachrichten senden" und "Links einbetten" hat.
- Wenn du die Live-Rollen-Funktion nutzen möchtest (nur bei Livestream-Benachrichtigungen), stelle sicher, dass der Bot die Berechtigung "Rollen verwalten" hat und die Rolle des Bots höher positioniert ist als die konfigurierte Live-Rolle.
- Lade die Konfiguration deines Bots neu, um die Änderungen zu übernehmen.
Nutzung
Nach der Einrichtung und Konfiguration dieses Moduls sind keine weiteren Aktionen erforderlich. Der Bot prüft die konfigurierten YouTube-Kanäle automatisch alle 60 Sekunden auf neue Videos und Livestreams, sodass Benachrichtigungen für Livestarts und Uploads meist innerhalb etwa einer Minute eintreffen. Eine Überlappungssperre verhindert, dass eine langsame Prüfung eine zweite parallel startet, sodass Benachrichtigungen nie doppelt gesendet werden.
- Wenn ein neues Video hochgeladen wird, wird die konfigurierte Benachrichtigungsnachricht in den angegebenen Discord-Kanal gesendet. Nur Videos, die innerhalb der letzten 24 Stunden veröffentlicht wurden, lösen Benachrichtigungen aus.
- Wenn ein Kanal einen Livestream startet, wird die konfigurierte Benachrichtigungsnachricht gesendet. Ist die Live-Rollen-Funktion aktiviert, wird die konfigurierte Rolle dem Discord-Account des YouTubers hinzugefügt, sobald er live geht, und entfernt, wenn der Stream endet.
Konfiguration
Dieses Modul hat zwei Konfigurationsdateien: eine für Benachrichtigungen zu Video-Uploads und eine für Benachrichtigungen zu Livestreams.
YouTube-Kanäle (Videobenachrichtigungen)
In dieser Konfigurationsdatei kannst du YouTube-Kanäle einrichten, die auf neue Video-Uploads überwacht werden sollen. Öffne sie in deinem Dashboard.
| Feld | Beschreibung |
|---|---|
| Kanal | Der Discord-Kanal, in dem die Benachrichtigung gesendet werden soll. |
| YouTube @-Handle oder Kanal-ID | Der @-Handle oder die Kanal-ID des zu überwachenden YouTube-Kanals. Kanal-IDs, die mit UC beginnen, werden ebenfalls unterstützt. |
| Shorts ignorieren? | Wenn aktiviert, werden keine Benachrichtigungen gesendet, wenn ein YouTube Short hochgeladen wird. Normale Videos lösen weiterhin Benachrichtigungen aus. |
| Künftige/geplante Premieren & Streams ignorieren? | Wenn aktiviert, lösen geplante Premieren und Livestreams keine Upload-Benachrichtigung aus, solange sie noch bevorstehen oder live sind. Die Benachrichtigung erfolgt normalerweise, sobald sie als reguläres Video veröffentlicht wurden. |
| Nachricht | Die Nachricht, die in den konfigurierten Kanal gesendet wird, wenn ein neues Video hochgeladen wird. Unterstützt Embeds. Bitte überprüfe die verfügbaren Parameter in deinem Dashboard. |
YouTube-Kanäle (Livebenachrichtigungen)
In dieser Konfigurationsdatei kannst du YouTube-Kanäle einrichten, die auf Livestreams überwacht werden sollen. Öffne sie in deinem Dashboard.
| Feld | Beschreibung |
|---|---|
| Kanal | Der Discord-Kanal, in dem die Benachrichtigung gesendet werden soll. |
| YouTube @-Handle | Der @-Handle des Kanals, der auf Livestreams überwacht werden soll. |
| Nachricht | Die Nachricht, die in den konfigurierten Kanal gesendet wird, wenn der YouTube-Kanal live geht. Unterstützt Embeds. Bitte überprüfe die verfügbaren Parameter in deinem Dashboard. |
| Live-Rolle aktivieren | Ob die Live-Rollen-Funktion für diesen YouTube-Kanal aktiviert werden soll. |
| Discord-Benutzer ID | Die Discord-Benutzer-ID des YouTubers. Nur erforderlich, wenn die Live-Rollen-Funktion aktiviert ist. |
| Live-Rolle | Die Rolle, die dem YouTuber zugewiesen wird, solange er live ist. Nur erforderlich, wenn die Live-Rollen-Funktion aktiviert ist. |
Fehlerbehebung
Benachrichtigungen zu Video-Uploads werden nicht gesendet
- Stelle sicher, dass der YouTube @-Handle oder die Kanal-ID korrekt ist.
- Stelle sicher, dass der Bot im Benachrichtigungskanal die Berechtigungen "Kanal ansehen", "Nachrichten senden" und "Links einbetten" hat.
- Das Modul prüft alle 60 Sekunden auf neue Videos. Bitte warte auf den nächsten Prüfzyklus.
- Ist die Option "Shorts ignorieren?" aktiviert, lösen YouTube Shorts keine Benachrichtigungen aus.
- Ist die Option "Künftige/geplante Premieren & Streams ignorieren?" aktiviert, lösen Premieren und Livestreams erst eine Benachrichtigung aus, sobald sie als reguläres Video veröffentlicht wurden.
- Wenn ein YouTube-Kanal nicht gefunden werden kann, wird er übersprungen, bis der Bot neu gestartet oder die Konfiguration neu geladen wird.
Livestream-Benachrichtigungen werden nicht gesendet
- Stelle sicher, dass der YouTube @-Handle korrekt ist.
- Stelle sicher, dass der Bot im Benachrichtigungskanal die Berechtigungen "Kanal ansehen", "Nachrichten senden" und "Links einbetten" hat.
- Das Modul prüft alle 60 Sekunden auf Livestreams. Bitte warte auf den nächsten Prüfzyklus.
Die Live-Rolle wird nicht zugewiesen oder entfernt
- Stelle sicher, dass die Option "Live-Rolle aktivieren" für diesen YouTube-Kanal aktiviert ist.
- Überprüfe, ob die Discord-Benutzer-ID und die ID der Live-Rolle korrekt konfiguriert sind.
- Stelle sicher, dass der Bot die Berechtigung "Rollen verwalten" hat und die Rolle des Bots in den Servereinstellungen höher positioniert ist als die konfigurierte Live-Rolle.
- Der YouTuber muss Mitglied deines Discord-Servers sein.
- Live-Rollen werden beim Neustart des Bots bereinigt. Wurde die Rolle nach dem Ende eines Streams nicht entfernt, behebt ein Neustart des Bots das Problem.
Gespeicherte Daten
Die folgenden Daten werden von diesem Modul gespeichert:
Für jede gesendete Videobenachrichtigung:
- Die YouTube-Video-ID
- Die Discord-Nachrichten-ID der Benachrichtigung
- Die Discord-Kanal-ID, in dem die Benachrichtigung gesendet wurde
Für jede gesendete Livestream-Benachrichtigung:
- Die YouTube-Livestream-ID
- Die Discord-Nachrichten-ID der Benachrichtigung
- Die Discord-Kanal-ID, in dem die Benachrichtigung gesendet wurde
Um alle von diesem Modul gespeicherten Daten zu löschen, setze die Modul-Datenbank zurück.
