Files
stream-recorder/docs/plugins.md
T

2.2 KiB

Plugins

Plugins erweitern den Recorder um zusätzliche Funktionen. Alle Plugins sind pro Job einzeln aktivierbar.

NTFY-Benachrichtigungen

Push-Nachrichten per ntfy.sh bei verschiedenen Events.

Einrichtung

  1. Einstellungen → NTFY URL: Topic-URL eintragen (z.B. https://ntfy.sh/mein-topic)
  2. Einstellungen → Events: Kommaseparierte Liste der gewünschten Events
  3. Pro Job: Checkbox „Benachrichtigungen (NTFY)" aktivieren

Events

Event Tag Beschreibung
start 🔴 Aufnahme gestartet
stop ✅ Aufnahme beendet
error 🚨 Fehler oder Verbindungsabbruch
upload 📤 Plik-Upload abgeschlossen (mit Link)

Authentifizierung

Für private Topics kann ein Bearer-Token in den Einstellungen hinterlegt werden. Der Token wird nach dem Speichern nicht mehr von der API ausgegeben.


Plik-Upload

Automatischer Upload von Aufnahmen auf einen Plik-Server nach Aufnahme-Ende.

Einrichtung

  1. Einstellungen → Plik URL: Server-URL eintragen
  2. Einstellungen → TTL: Aufbewahrungsdauer (Standard: 30d)
  3. Pro Job: Checkbox „Plik-Upload" aktivieren

Optionen pro Job

Option Beschreibung
Plik-Upload Upload nach Aufnahme-Ende aktivieren
File nach Upload lokal löschen Lokale Datei nach erfolgreichem Upload entfernen

Nach dem Upload werden zwei URLs generiert:

  • Browser-URL: https://plik.example.com/#/?id=UPLOAD_ID — Übersichtsseite mit In-Browser-Wiedergabe
  • Download-URL: Direkter Datei-Download

Die Plik-URL wird in der Datenbank gespeichert und im Dashboard bei den Letzten Aufnahmen als klickbarer Link angezeigt. Bei aktiviertem NTFY wird die Browser-URL zusätzlich in der Push-Nachricht mitgeschickt.

Segment-Upload

Bei Segment-Splitting werden nur die Segmente der jeweiligen Aufnahme einzeln hochgeladen. Wurde die Aufnahme nach Verbindungsabbrüchen fortgesetzt, werden alle Teile hochgeladen. Die NTFY-Nachricht enthält die Anzahl der hochgeladenen Segmente.

Der Plik-API-Key wird wie der NTFY-Token nach dem Speichern nicht mehr von der API ausgegeben.