Files
stream-recorder/docs/konfiguration.md
T

2.9 KiB

Konfiguration

Die Konfigurationsdatei liegt unter config/stream-recorder.conf. Sie wird aus der Vorlage config/stream-recorder.conf.dist erstellt:

cp config/stream-recorder.conf.dist config/stream-recorder.conf
nano config/stream-recorder.conf

Die .conf-Datei wird von Git ignoriert und bleibt bei Updates erhalten.

Parameter

Basis-Einstellungen

Parameter Standard Beschreibung
DOWNLOAD_PATH /home/downloads/recordings Basis-Verzeichnis für Aufnahmen
LOG_DIR /var/log/stream-recorder Log-Verzeichnis
LOG_LEVEL INFO Log-Level: DEBUG, INFO, WARN, ERROR
PID_DIR /tmp/stream-recorder PID-Dateien für laufende Aufnahmen
STATE_DIR /var/lib/stream-recorder Status für bereits gestartete Zeitpläne

Reconnect

Parameter Standard Beschreibung
MAX_RETRIES 0 Wiederholungsversuche (0 = unbegrenzt)
RETRY_DELAY 5 Wartezeit zwischen Versuchen (Sekunden)

Bei Verbindungsabbrüchen versucht das Script automatisch, die Verbindung wiederherzustellen. Bei jedem Reconnect wird eine neue Datei mit aktuellem Zeitstempel erzeugt.

  • MAX_RETRIES=0 — Unbegrenzte Versuche (empfohlen für Langzeitaufnahmen)
  • MAX_RETRIES=5 — Maximal 5 Versuche, danach Abbruch mit Benachrichtigung

NTFY-Benachrichtigungen

Push-Nachrichten via ntfy (selbst gehostet oder öffentlich).

Parameter Standard Beschreibung
NTFY_URL (leer) NTFY Server-URL inkl. Topic
NTFY_TOKEN (leer) NTFY Access-Token (optional)
NTFY_EVENTS error Benachrichtigungs-Events (kommasepariert)

Siehe Benachrichtigungen für Details zu den Events.

Plik-Upload

Fertige Aufnahmen auf einen Plik-Server hochladen.

Parameter Standard Beschreibung
PLIK_URL (leer) Plik Server-URL
PLIK_API_KEY (leer) Plik API-Key (optional)
PLIK_TTL 30d Gültigkeitsdauer: 30d, 24h, Sekunden

Siehe Plik-Upload für die Einrichtung pro Job.

Alternative Konfigurationsdatei

Eine andere Konfigurationsdatei kann per -c übergeben werden:

./stream-recorder.sh -c /pfad/zur/config.conf record mein-stream