# 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"
```