LiveAlerts DE

LiveAlerts

🌐 English · Deutsch

LiveAlerts postet Twitch-Live-Benachrichtigungen und YouTube-Upload-Alerts in Kanäle deiner Wahl — mit Nachrichten-Vorlagen pro Abo, optionalem Rollen-Ping und konfigurierbarem Offline-Verhalten. Zweisprachig (DE/EN), Opt-in pro Server, mit Web-Dashboard-Integration. Autor: pd-codes · benötigt Red 3.5.0+ · Status: Alpha 0.1.0.

Installation

[p]repo add PDC https://github.com/pd-codes/PDC_Redbot_Cogs
[p]cog install PDC livealerts
[p]load livealerts
[p]slash sync

Twitch-API

Twitch-Alerts brauchen App-Zugangsdaten, gelesen aus Reds gemeinsamen API-Tokens (bot.get_shared_api_tokens("twitch") — sowohl client_id als auch client_secret müssen gesetzt sein):

[p]set api twitch client_id,<deine_client_id> client_secret,<dein_client_secret>

Der Cog holt sich selbst ein App-Access-Token, cacht es und erneuert es automatisch. Ohne Keys werden Twitch-Abos pro Zyklus übersprungen (Status no_api). YouTube braucht keinen API-Key — neue Uploads werden über den öffentlichen Kanal-RSS-Feed erkannt.

Befehle

Alle Befehle liegen unter der Hybrid-Gruppe livealerts (Alias la) und erfordern Admin oder Server verwalten.

Befehl	Funktion
livealerts enable <on/off>	Modul für diesen Server ein-/ausschalten.
livealerts addtwitch <login> <#kanal> [vorlage]	Live-Status eines Twitch-Kanals abonnieren (Login aus der Kanal-URL).
livealerts addyoutube <kanal_id> <#kanal> [vorlage]	Uploads eines YouTube-Kanals abonnieren (Kanal-ID beginnt mit UC…).
livealerts remove <id>	Abo entfernen.
livealerts list	Abos mit ID, Zielkanal und Status auflisten (paginiert).
livealerts message <id> [vorlage]	Nachrichten-Vorlage setzen; ohne Angabe zurücksetzen.
livealerts ping <id> [rolle]	Ping-Rolle für Alerts setzen/entfernen.
livealerts offline <id> <leave|edit|delete>	Was mit einem Twitch-Alert passiert, wenn der Stream endet.
livealerts interval <sekunden>	Abruf-Intervall für diesen Server (mindestens 60 s).
livealerts language <de-DE|en-US>	Ausgabesprache für diesen Server.

Funktionsweise

Ein Hintergrund-Loop pollt im kleinsten konfigurierten Server-Intervall (Standard 120 s, min. 60 s, plus Jitter; exponentielles Backoff bei Fehlern). Twitch: Alle Logins über alle Server werden gebündelt (bis 100 pro Anfrage) über die Helix-Streams-API geprüft; eine neue Stream-ID löst einen Alert aus (Embed mit Titel, Spiel, Zuschauern, Vorschaubild), und beim Stream-Ende markiert der konfigurierte Offline-Modus die Nachricht als beendet (edit), löscht sie (delete) oder lässt sie stehen (leave). YouTube: Der Kanal-RSS-Feed wird abgefragt und unbekannte Video-IDs werden angekündigt (max. 5 pro Zyklus, älteste zuerst; beim Hinzufügen werden vorhandene Videos vorgemerkt, es wird also nichts Altes gespammt). Vorlagen unterstützen die Platzhalter {streamer}, {title}, {url} und {game} (nur Twitch).

Dashboard

Unter Server-Einstellungen: ein Panel Live-Alerts (Aktiviert, Intervall, Sprache, plus Warnung bei fehlenden Twitch-API-Keys), eine Tabelle Live-Abos (Typ, Name, Kanal, Ping, Status — Name/Kanal/Vorlage/Ping-Rolle/Offline-Verhalten bearbeiten oder löschen) und ein Panel Abo hinzufügen (Typ, Login/Kanal-ID, Kanal, optionale Vorlage). Eine separate Server-Seite Live-Alert-Status zeigt eine Tabelle aller Abos mit Status, Live-Anzeige und letztem Abruf.