🎥 VODControl Api

Diese API ermöglicht das einfache Auslesen, Verwalten und Steuern von VOD-Dateien für Twitch/OBS-Setups – ideal für 24/7-VOD-Streamingkanäle. Sie stellt verschiedene Endpunkte zur Verfügung, die sich flexibel über Streamer.bot oder OBS einbinden lassen.

Funktionen im Überblick: 📂 Automatische Auswertung eines VOD-Verzeichnisses (UNC- oder lokaler Pfad) ⏩ VOD-Steuerung per Chatbefehl (skippen, vorspulen, zurückspulen, spezielles VOD wiedergeben) 🧾 Live-Abruf des aktuellen VOD-Titels, der Restlaufzeit und der Endzeit 💾 Anzeige von Speicherbelegung und VOD-Anzahl vom Server 📤 Upload der VOD-Liste auf Pastebin (inkl. Link-Ausgabe im Chat) 📡 Kompatibel mit Streamer.bot („Fetch URL"-Aktionen)

Durch die zentrale vod-config.php ist das System flexibel konfigurierbar und kann problemlos auf andere Setups übertragen werden.

Die API ist vollständig kompatibel mit Streamer.bot und kann über Fetch URL-Aktionen eingebunden werden. Damit kannst du:

• die title.php, categorie.php, time_left.php, storage.php etc. live im Stream anzeigen
• automatisiert den Twitch-Titel anpassen (z. B. bei VOD-Wechsel)
• per Chatbefehl VODs vorspulen, zurückspulen oder pausieren (seek.php)
• aus einem Archivordner einen vollständigen 24/7-VOD-Streamingkanal betreiben

Streamer.bot reagiert auf Trigger aus OBS/Twitch und ruft die entsprechenden API-Endpunkte auf.

• OBS-Studio
• OBS-Plugin Tuna
• Streamer.bot
• PHP (lokal empfohlen unter Windows mit WAMP/XAMPP)
• Curl + cacert.pem für HTTPS-Kommunikation (z. B. mit Pastebin)
• Schreib-/Lesezugriff auf:
  • VOD-Verzeichnis (UNC oder lokaler Pfad)
  • Lokale API-Dateien:
    • api.txt und duration.txt → werden durch das OBS-Plugin Tuna erzeugt

Im OBS-Plugin Tuna bitte folgende Einstellungen vornehmen image

Im Reiter "VNC" wählt ihr bitte eure Szene sowie die Quelle aus und klickt anschließend auf "Hinzufügen".

Im Streamer.bot kann die API über Twitch-Chat Commands abgefragt werden. Hier mal ein Beispiel

image

In diesem Beispiel wird durch den Befehl !title der API Endpunkt http://localhost/title aufgerufen und die Ausgabe in die Variable %title% geschrieben. Das wird dann als Twitch Message mit einem frei definierbaren Text ausgegeben.

Alle Pfade, API-Keys und Dateinamen werden zentral in vod-config.php gesetzt.

Beispiel:

return [
 'vod' => [
 'unc_path' => '\\server\freigabe\vod',
 'vodlist_output' => 'D:\Pfad\vodlist.txt',
 'file_extension' => 'mp4',
 'xspf_path' => 'D:\Pfad\playlist\playlist.xspf',
 ],
 'system' => [
 'timezone' => 'Europe/Berlin'
 ],
 'version' => [
 'current' => '1.0.3'
 ],
 'pastebin' => [
 'api_key' => 'DEIN_API_KEY',
 'vodlist_path' => 'D:\Pfad\vodlist.txt',
 'log_path' => 'D:\Pfad\pastebin_latest.txt'
 ],
 'files' => [
 'api' => 'D:\Pfad\api.txt',
 'duration' => 'D:\Pfad\duration.txt',
 'pastebin_latest' => 'D:\Pfad\pastebin_latest.txt'
 ]
];

Diese Endpunkte können direkt per URL in OBS (Browser-Quellen, Text-Dateien) oder über Streamer.bot (HTTP-Aktionen) eingebunden werden.

Beispiel:

http://localhost/api/title
http://localhost/api/storage

Da die API keine Authentifizierung verwendet, wird empfohlen bei öffentlicher Nutzung:

• IP-Filter (z. B. im Router, via .htaccess oder Firewall)
• Zugriff nur im lokalen Netzwerk / über Streamer.bot

Entwickelt von romestylez für den Stream von smtxlosttv – mit Fokus auf Automatisierung und einfache Integration.