Files
stream-recorder/docs/plugins.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

1.9 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.


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 alle Segmente einzeln hochgeladen. Die NTFY-Nachricht enthält die Anzahl der hochgeladenen Segmente.