Stream Control Center

Ein web-basiertes Kontrollzentrum zum Verwalten und Streamen einer Video-Playlist als 24/7-Kanal auf Twitch. Das Projekt ist vollständig portabel für Windows.

Features

• Multi-Plattform Support (Modular): Nahtloses Streaming und Metadaten-Synchronisierung für Twitch, Kick und YouTube.
• OAuth 2.0 Integration: Sichere und automatische Authentifizierung (Token-Generierung & Auto-Refresh) direkt über das Web-Interface.
• Playlist- & Rotations-Management: Playlists erstellen, per Drag & Drop sortieren und zu endlosen Rotationen verknüpfen.
• Session-Heilung & Resume-Memory: Der Streamer merkt sich bei jedem Neustart, Verbindungsabbruch oder bei Änderungen der Playlist exakt das zuletzt gespielte Video und setzt nahtlos dort an, statt von vorne zu beginnen.
• Automatischer Stream-Neustart: Konfigurierbare Auto-Restarts (nach Intervall oder fester Uhrzeit), um serverseitige 48-Stunden-Disconnects zu umgehen.
• Integrierter Chat-Bot:
  • Start/Stop und Überwachung über das Web-Interface.
  • Dynamisches Befehls-Management (inkl. Berechtigungen, Cooldowns).
  • Live-Chat-Anzeige direkt im Web-Interface.
• Task-Manager Optimierung: Eigener, konfigurierbarer Prozessname für FFmpeg für bessere Server-Übersicht.
• Sendeplan: Wöchentlichen Sendeplan erstellen, um automatisch zu bestimmten Zeiten Playlists zu wechseln.
• Dynamisches Overlay: Live konfigurierbares "Now Playing"-Text-Overlay.
• Voll portabel: Benötigt keine vorinstallierte Version von Python oder FFmpeg auf dem System.

Installation & Setup

Dieses Projekt ist für einen einfachen Start auf Windows-Systemen konzipiert.

1. Lade das Projekt als ZIP-Datei herunter und entpacke es in einen Ordner deiner Wahl.
2. Führe die setup.bat-Datei per Doppelklick aus.
   • Dieses Skript lädt automatisch die benötigte portable Version von Python und FFmpeg herunter.
   • Anschließend installiert es alle notwendigen Python-Pakete.
   • Dieser Schritt muss nur ein einziges Mal ausgeführt werden.

Für Linux / macOS

Das Projekt enthält auch Setup- und Start-Skripte für Unix-basierte Systeme.

1. Skripte ausführbar machen: Öffne ein Terminal im Projektordner und führe aus:

   chmod +x setup.sh
   chmod +x start.sh

2. Setup ausführen: Starte das Setup-Skript. Es lädt die passenden Versionen von Python und FFmpeg herunter und installiert die Abhängigkeiten.

   ./setup.sh

3. Anwendung starten:

   ./start.sh

Benutzung

1. Anwendung starten: Führe nach dem Setup die start.bat (Windows) oder start.sh (Unix) aus. Dadurch wird der Web-Manager gestartet.
2. Web-Interface öffnen: Öffne deinen Browser und gehe zur Adresse, die im Terminal angezeigt wird. Das System nutzt nun aus Sicherheitsgründen standardmäßig HTTPS: https://127.0.0.1:5000 (Zertifikatswarnungen des Browsers bei lokaler Nutzung können ignoriert/akzeptiert werden).
3. Konfigurieren: Gehe zum "Streamer-Config"-Tab und trage alle deine Daten ein. Nutze für Plattformen wie Twitch die "Mit Twitch verbinden"-Buttons für ein automatisches OAuth-Setup. Speichere die Konfiguration ganz unten.
4. Bibliothek füllen: Kopiere deine Videos in die festgelegten Ordner und nutze den "Bibliothek & Import"-Tab, um sie einzulesen.
5. Streamer & Bot starten: Navigiere zum "Prozess-Steuerung"-Tab und klicke auf "Streamer Starten" bzw. "Bot Starten".

Das System ist nun vollständig betriebsbereit.

Das System ist nun vollständig betriebsbereit.