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,76 @@
+# Segment-Splitting
+
+Lange Aufnahmen (z.B. 8-Stunden-Streams) können automatisch in kleinere Dateien geteilt werden. Jedes Segment wird einzeln nach Plik hochgeladen, sobald es fertig ist.
+
+## Einrichtung
+
+In der Job-Datei `SEGMENT_DURATION` setzen:
+
+```bash
+# Aufnahme alle 2 Stunden teilen
+SEGMENT_DURATION="2h"
+
+# Plik-Upload aktivieren (empfohlen)
+PLIK_ENABLED=true
+```
+
+## Dauerformate
+
+| Format   | Bedeutung        |
+|----------|------------------|
+| `30m`    | Alle 30 Minuten  |
+| `1h`     | Stündlich         |
+| `2h`     | Alle 2 Stunden   |
+| `3600`   | 3600 Sekunden    |
+
+## So funktioniert's
+
+1. ffmpeg teilt die Aufnahme automatisch in Segmente der angegebenen Länge
+2. Ein Hintergrund-Prozess prüft alle 60 Sekunden auf fertige Segmente
+3. Fertige Segmente werden sofort nach Plik hochgeladen (falls aktiviert)
+4. Beim Beenden (regulär oder per `stop`) wird das letzte Segment noch hochgeladen
+
+### Dateinamen
+
+Segmente erhalten fortlaufende Nummern:
+
+```
+Mein-Stream_20260907_200000_seg000.mp4
+Mein-Stream_20260907_200000_seg001.mp4
+Mein-Stream_20260907_200000_seg002.mp4
+```
+
+## Kombination mit Plik
+
+Segment-Splitting ist besonders nützlich in Kombination mit Plik-Upload:
+
+```bash
+SEGMENT_DURATION="1h"
+PLIK_ENABLED=true
+DELETE_AFTER_UPLOAD=true    # Lokale Segmente nach Upload löschen
+```
+
+So wird jede Stunde ein Segment hochgeladen und lokal gelöscht. Das spart Speicherplatz bei langen Aufnahmen.
+
+## Kombination mit Zeitplanung
+
+Segment-Splitting und Zeitplanung lassen sich kombinieren:
+
+```bash
+SCHEDULE_ENABLED=true
+SCHEDULE_DAYS="*"
+SCHEDULE_START="08:00"
+SCHEDULE_STOP="20:00"
+SEGMENT_DURATION="2h"
+PLIK_ENABLED=true
+```
+
+Die 12-Stunden-Aufnahme wird in 6 Segmente zu je 2 Stunden geteilt, jedes wird nach Fertigstellung hochgeladen.
+
+## Verhalten bei Reconnect
+
+Wenn die Verbindung abbricht und wiederhergestellt wird, werden die bisherigen Segmente hochgeladen und eine neue Segment-Serie mit neuem Zeitstempel begonnen.
+
+## Status
+
+Mit `./stream-recorder.sh status` werden bei segmentierten Aufnahmen die Anzahl der Segmente und die Gesamtgröße angezeigt.