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,157 @@
+# Praxisbeispiele
+
+## RTMP-Livestream täglich aufzeichnen
+
+Tägliche Aufnahme eines Twitch-/YouTube-/RTMP-Streams von 20:00 bis 22:00 Uhr mit Plik-Upload:
+
+```bash
+# jobs/abend-livestream.job
+STREAM_NAME="Abend-Livestream"
+STREAM_URL="rtmp://example.com/live/stream-key"
+STREAM_TYPE="auto"
+OUTPUT_FORMAT=""
+MAX_DURATION=""
+EXTRA_FFMPEG_ARGS=""
+
+SEGMENT_DURATION=""
+
+SCHEDULE_ENABLED=true
+SCHEDULE_DAYS="*"
+SCHEDULE_START="20:00"
+SCHEDULE_STOP="22:00"
+
+PLIK_ENABLED=true
+DELETE_AFTER_UPLOAD=false
+```
+
+## Radio-Mitschnitt werktags
+
+Werktags um 18:00 Uhr eine Stunde Radio mitschneiden:
+
+```bash
+# jobs/radio-abends.job
+STREAM_NAME="Radio-Abendshow"
+STREAM_URL="https://example.com/stream.mp3"
+STREAM_TYPE="auto"
+OUTPUT_FORMAT=""
+MAX_DURATION="1h"
+EXTRA_FFMPEG_ARGS=""
+
+SEGMENT_DURATION=""
+
+SCHEDULE_ENABLED=true
+SCHEDULE_DAYS="Mo-Fr"
+SCHEDULE_START="18:00"
+SCHEDULE_STOP=""
+
+PLIK_ENABLED=false
+```
+
+## 24/7-Stream mit stündlichem Upload
+
+Ein Überwachungsstream, der dauerhaft läuft und stündlich Segmente zu Plik hochlädt. Lokale Dateien werden nach dem Upload gelöscht:
+
+```bash
+# jobs/ueberwachung.job
+STREAM_NAME="Kamera-Front"
+STREAM_URL="rtmp://192.168.1.100/live/cam1"
+STREAM_TYPE="auto"
+OUTPUT_FORMAT="mp4"
+MAX_DURATION=""
+EXTRA_FFMPEG_ARGS=""
+
+SEGMENT_DURATION="1h"
+
+SCHEDULE_ENABLED=false
+
+PLIK_ENABLED=true
+DELETE_AFTER_UPLOAD=true
+```
+
+Starten mit:
+
+```bash
+./stream-recorder.sh record ueberwachung
+```
+
+## Podcast-/HLS-Stream in 2-Stunden-Blöcken
+
+Ein langer HLS-Livestream (z.B. Konferenz) in 2-Stunden-Segmenten aufzeichnen, jedes Segment wird sofort hochgeladen:
+
+```bash
+# jobs/konferenz.job
+STREAM_NAME="Dev-Konferenz-2026"
+STREAM_URL="https://example.com/live/playlist.m3u8"
+STREAM_TYPE="hls"
+OUTPUT_FORMAT="mp4"
+MAX_DURATION="10h"
+EXTRA_FFMPEG_ARGS=""
+
+SEGMENT_DURATION="2h"
+
+SCHEDULE_ENABLED=false
+
+PLIK_ENABLED=true
+DELETE_AFTER_UPLOAD=false
+```
+
+## Einmalige Aufnahme zu einem bestimmten Termin
+
+Ein Event am 15.09.2026 um 21:00 Uhr aufnehmen, 2 Stunden:
+
+```bash
+# jobs/einmaliges-event.job
+STREAM_NAME="Einmaliges-Event"
+STREAM_URL="https://example.com/live/playlist.m3u8"
+STREAM_TYPE="hls"
+OUTPUT_FORMAT="mp4"
+MAX_DURATION="2h"
+EXTRA_FFMPEG_ARGS=""
+
+SEGMENT_DURATION=""
+
+SCHEDULE_ENABLED=true
+SCHEDULE_ONCE=true
+SCHEDULE_DATE="2026-09-15"
+SCHEDULE_START="21:00"
+SCHEDULE_STOP=""
+
+PLIK_ENABLED=true
+DELETE_AFTER_UPLOAD=false
+```
+
+## Schnellaufnahme ohne Job-Datei
+
+Für spontane Aufnahmen ohne Konfiguration:
+
+```bash
+./stream-recorder.sh quick
+```
+
+Das Script fragt interaktiv nach URL, Name, Typ und Dauer.
+
+## Typischer Workflow
+
+```bash
+# 1. Konfiguration erstellen (einmalig)
+cp config/stream-recorder.conf.dist config/stream-recorder.conf
+nano config/stream-recorder.conf
+
+# 2. Scheduler installieren (einmalig)
+sudo install/install.sh
+
+# 3. Job erstellen
+./stream-recorder.sh create
+
+# 4. Jobs anzeigen
+./stream-recorder.sh list
+
+# 5. Status prüfen
+./stream-recorder.sh status
+
+# 6. Logs verfolgen
+./stream-recorder.sh logs
+
+# 7. Aufnahme stoppen (falls nötig)
+./stream-recorder.sh stop mein-stream
+```