stream-recorder/docs/installation.md

Installation

Voraussetzungen

Komponente	Anforderung
Betriebssystem	Linux (getestet unter Ubuntu/Debian)
Bash	Version 4.0 oder neuer
ffmpeg	Pflicht (sudo apt install ffmpeg)
curl	Optional, für NTFY und Plik-Upload

Installation

# Repository klonen
git clone https://git.techniverse.net/scriptos/stream-recorder.git /opt/stream-recorder
cd /opt/stream-recorder

# Konfiguration aus Vorlage erstellen und anpassen
cp config/stream-recorder.conf.dist config/stream-recorder.conf
nano config/stream-recorder.conf

# Scheduler installieren (systemd-Timer)
sudo install/install.sh

Das Install-Script:

• Macht das Hauptscript ausführbar
• Installiert fehlende Abhängigkeiten (ffmpeg)
• Erstellt die Konfigurationsdatei aus der Vorlage (falls nicht vorhanden)
• Richtet einen systemd-Timer ein, der jede Minute die Zeitpläne prüft

Updates

Da die Konfiguration als Kopie (stream-recorder.conf) vorliegt und die Vorlage (stream-recorder.conf.dist) getrennt gepflegt wird, gehen eigene Einstellungen bei einem git pull nicht verloren.

cd /opt/stream-recorder
git pull

Nach einem Update sollte man prüfen, ob in stream-recorder.conf.dist neue Parameter hinzugekommen sind, und diese ggf. in die eigene stream-recorder.conf übernehmen.

Deinstallation

sudo install/uninstall.sh

Entfernt den systemd-Timer und stoppt optional alle laufenden Aufnahmen. Job-Dateien, Konfiguration und Aufnahmen bleiben erhalten.

Ohne systemd

Das Script funktioniert auch ohne Scheduler. In dem Fall muss man Aufnahmen manuell starten:

./stream-recorder.sh record mein-stream

Oder den Scheduler manuell per Cron aufrufen:

# crontab -e
* * * * * /opt/stream-recorder/stream-recorder.sh scheduler