Files
stream-recorder/docs/jobs.md
T
Patrick Asmus a9a9a89cba
Build Release Docker Image / build-amd64 (release) Successful in 6s
Build Release Docker Image / build-arm64 (release) Successful in 10s
Build Release Docker Image / publish-release-manifest (release) Successful in 6s
Release: v3.1.0
2026-09-16 20:22:34 +02:00

3.5 KiB

Jobs

Jobs

Jobs sind vorkonfigurierte Aufnahme-Vorlagen. Jeder Job definiert einen Stream, optional einen Zeitplan und Plugin-Einstellungen.

Job erstellen

Im Web-UI unter Jobs → + Neuer Job.

Pflichtfelder

Feld Beschreibung
Name Eindeutiger Name (wird als Ordnername verwendet)
Stream-URL URL des Streams (RTMP, HLS, HTTP, etc.)

Optionale Felder

Feld Beschreibung
Senderbibliothek Sender aus der Bibliothek auswählen — URL und Typ werden übernommen
Beschreibung Freitext-Notiz zum Job (wird auch in NTFY-Nachrichten mitgeschickt)
Typ Automatisch erkannt aus URL. Manuell wählbar: RTMP, HLS, MP3, AAC, OGG, HTTP
Ausgabeformat Dateiendung. Leer = automatisch (mp4 für Video, mp3 für Audio)
Max. Dauer Zeitlimit in Minuten. Entfällt bei Zeitplan mit Endzeit
Segment-Dauer Aufnahme in Teile zerlegen (Minuten pro Segment)
Extra ffmpeg Argumente Zusätzliche ffmpeg-Parameter (z.B. -b:a 192k)

Zeitplan

Aktiviert automatische Aufnahmen zu festgelegten Zeiten.

Feld Beschreibung
Einmalig Nur einmal am angegebenen Datum ausführen
Startdatum Datum für einmalige Aufnahme
Enddatum Enddatum für mehrtägige Aufnahmen (leer = gleicher Tag)
Tage Wochentage: * (täglich), Mo-Fr, Sa,So, Mo,Mi,Fr
Startzeit Aufnahme-Beginn (HH:MM)
Endzeit Aufnahme-Ende (HH:MM) — Dauer wird automatisch berechnet

Wenn Start- und Endzeit gesetzt sind, wird die Aufnahmedauer automatisch berechnet. Das Feld "Max. Dauer" wird dann nicht benötigt.

Tage-Syntax

Eingabe Bedeutung
* Jeden Tag
Mo-Fr Montag bis Freitag
Sa,So Samstag und Sonntag
Mo,Mi,Fr Montag, Mittwoch, Freitag
Mo-Mi,Fr Montag bis Mittwoch und Freitag

Unterstützt: Mo/Mon/Montag, Di/Tue/Dienstag, Mi/Wed/Mittwoch, Do/Thu/Donnerstag, Fr/Fri/Freitag, Sa/Sat/Samstag, So/Sun/Sonntag

Zeitpuffer

Zeitpuffer

Pro Job können Vor- und Nachlaufzeit konfiguriert werden, um die Aufnahme um den geplanten Zeitraum herum zu erweitern:

Feld Beschreibung
Vorlaufzeit Aufnahme startet X Minuten vor der geplanten Startzeit
Nachlaufzeit Aufnahme läuft X Minuten über die geplante Endzeit hinaus

Die Standardwerte können in den Einstellungen unter Zeitplan-Puffer festgelegt werden.

Mehrtägige Aufnahmen

Bei einmaligen Aufnahmen kann ein Enddatum angegeben werden, das nach dem Startdatum liegt. Die Aufnahmedauer wird dann automatisch über die Tagesgrenzen hinweg berechnet.

Plugins pro Job

Jeder Job kann individuell Plugin-Funktionen aktivieren:

Option Beschreibung
Benachrichtigungen (NTFY) Push-Nachrichten bei Start, Stop und Fehlern für diesen Job
Plik-Upload Automatischer Upload nach Aufnahme-Ende
File nach Upload lokal löschen Lokale Datei nach erfolgreichem Plik-Upload entfernen

Die globale NTFY- und Plik-Konfiguration (URL, Token, etc.) erfolgt in den Einstellungen.

Manuelle Aufnahme

Jobs können auch manuell über den Aufnehmen-Button gestartet werden, unabhängig vom Zeitplan.

Schnellaufnahme

Für einmalige Aufnahmen ohne Job: Dashboard → + Schnellaufnahme. URL eingeben (oder aus der Senderbibliothek wählen), optional Name und Dauer angeben, sofort starten.