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,80 @@
+# Zeitplanung
+
+Die Zeitplanung wird direkt in der Job-Datei konfiguriert — kein Cron-Wissen nötig. Ein systemd-Timer prüft jede Minute alle Jobs und startet/stoppt Aufnahmen automatisch.
+
+## Einrichtung
+
+1. **Job-Datei erstellen** und `SCHEDULE_*`-Parameter setzen
+2. **Scheduler installieren** mit `sudo install/install.sh` (einmalig)
+3. Fertig — der Timer prüft jede Minute alle Jobs
+
+## Zeitplan-Parameter
+
+| Parameter          | Standard | Beschreibung                                    |
+|--------------------|----------|-------------------------------------------------|
+| `SCHEDULE_ENABLED` | `false`  | Zeitplan aktivieren (`true`/`false`)             |
+| `SCHEDULE_ONCE`    | `false`  | Einmaliger Termin statt wöchentlichem Zeitplan   |
+| `SCHEDULE_DATE`    | (leer)   | Datum für einmalige Termine (`YYYY-MM-DD`)       |
+| `SCHEDULE_DAYS`    | `*`      | Aufnahmetage für wöchentliche Zeitpläne          |
+| `SCHEDULE_START`   | (leer)   | Startzeit im Format `HH:MM`                     |
+| `SCHEDULE_STOP`    | (leer)   | Endzeit im Format `HH:MM` (leer = kein Auto-Stop)|
+
+## Tagesformate
+
+| Format       | Bedeutung                  |
+|--------------|----------------------------|
+| `*`          | Täglich                    |
+| `Mo-Fr`      | Montag bis Freitag         |
+| `Sa,So`      | Samstag und Sonntag        |
+| `Mo,Mi,Fr`   | Einzelne Tage              |
+| `Mo-Fr,So`   | Kombiniert                 |
+
+Die Tagesangaben funktionieren auf Deutsch (Mo, Di, Mi, Do, Fr, Sa, So) und Englisch (Mon, Tue, Wed, Thu, Fri, Sat, Sun).
+
+## Verhalten
+
+- **Start + Stop gesetzt:** Aufnahme läuft im angegebenen Zeitfenster
+- **Nur Start gesetzt:** Aufnahme startet zur angegebenen Zeit, läuft bis `MAX_DURATION` oder manueller Stop
+- **Einmalig:** Mit `SCHEDULE_ONCE=true` und `SCHEDULE_DATE="YYYY-MM-DD"` startet der Job nur an diesem Datum
+- **Manuell gestartete Aufnahmen** werden vom Scheduler nicht beeinflusst
+- **Nach Neustart** des Servers erkennt der Scheduler automatisch, welche Aufnahmen laufen sollten
+- **Nachtübergreifend:** Start- und Stoppzeiten können über Mitternacht gehen (z.B. `23:00` bis `02:00`)
+
+## Beispiele
+
+### Tägliche Aufnahme von 20:00 bis 22:00
+
+```bash
+SCHEDULE_ENABLED=true
+SCHEDULE_DAYS="*"
+SCHEDULE_START="20:00"
+SCHEDULE_STOP="22:00"
+```
+
+### Werktags um 18:00, 1 Stunde
+
+```bash
+SCHEDULE_ENABLED=true
+SCHEDULE_DAYS="Mo-Fr"
+SCHEDULE_START="18:00"
+MAX_DURATION="1h"
+```
+
+### Nur am Wochenende
+
+```bash
+SCHEDULE_ENABLED=true
+SCHEDULE_DAYS="Sa,So"
+SCHEDULE_START="14:00"
+SCHEDULE_STOP="18:00"
+```
+
+### Einmalige Aufnahme am 15.09.2026
+
+```bash
+SCHEDULE_ENABLED=true
+SCHEDULE_ONCE=true
+SCHEDULE_DATE="2026-09-15"
+SCHEDULE_START="21:00"
+MAX_DURATION="30m"
+```