Release: v2.7.0 + Dokumentation ausgelagert

2026-09-07 12:54:53 +02:00
parent 7ddfb0e0d4
commit f3a8e20d7f
16 changed files with 1103 additions and 330 deletions
@@ -0,0 +1,62 @@
+# Plik-Upload
+
+Fertige Aufnahmen können automatisch auf einen [Plik](https://github.com/root-gg/plik)-Server hochgeladen werden. Die Browser-URL zum Download wird im Log und optional per NTFY-Benachrichtigung ausgegeben.
+
+## Einrichtung
+
+### 1. Plik-Server konfigurieren
+
+In `config/stream-recorder.conf`:
+
+```bash
+PLIK_URL="https://plik.example.com"
+PLIK_API_KEY=""          # Optional, nur bei geschützten Servern
+PLIK_TTL="30d"           # Gültigkeitsdauer: 30d, 24h, oder Sekunden
+```
+
+### 2. Pro Job aktivieren
+
+In der Job-Datei:
+
+```bash
+PLIK_ENABLED=true
+```
+
+### 3. Optional: Datei nach Upload löschen
+
+```bash
+DELETE_AFTER_UPLOAD=true
+```
+
+## Verhalten
+
+- Upload nach jeder regulär abgeschlossenen Aufnahme
+- Upload nach manuellem Stop (`stop`-Befehl) — die Teilaufnahme wird hochgeladen
+- Upload nach Verbindungsabbruch, wenn eine Teildatei vorhanden ist
+- Browser-Link und Datei-URL werden ins Log geschrieben
+- Optional wird der Link per NTFY gesendet (Event: `upload`)
+
+## Mit Segment-Splitting
+
+Bei aktiviertem [Segment-Splitting](segment-splitting.md) wird jedes Segment einzeln hochgeladen:
+
+- Fertige Segmente werden während der Aufnahme hochgeladen (alle 60s geprüft)
+- Das letzte Segment wird nach Ende der Aufnahme hochgeladen
+- `DELETE_AFTER_UPLOAD=true` löscht jedes Segment nach dem Upload
+
+## Manueller Upload
+
+Eine vorhandene Datei kann auch manuell hochgeladen werden:
+
+```bash
+./stream-recorder.sh upload /pfad/zur/aufnahme.mp4 "Stream-Name"
+```
+
+## Download-Link per Push
+
+Um den Plik-Link automatisch als Push-Nachricht zu erhalten:
+
+```bash
+# In config/stream-recorder.conf
+NTFY_EVENTS="start,stop,error,upload"
+```