# Befehle

## Übersicht

| Befehl               | Beschreibung                                    |
|----------------------|-------------------------------------------------|
| `record [job]`       | Einzelnen Stream aufzeichnen (ohne Angabe: Auswahl) |
| `record-all`         | Alle Jobs gleichzeitig aufzeichnen              |
| `create`             | Neuen Job interaktiv erstellen                  |
| `quick`              | Schnellaufnahme (URL direkt eingeben)           |
| `upload <datei>`     | Vorhandene Datei nach Plik hochladen            |
| `stop [name]`        | Aufnahme stoppen (ohne Angabe: Auswahl)         |
| `stop-all`           | Alle Aufnahmen stoppen                          |
| `list`               | Jobs und deren Zeitpläne anzeigen               |
| `status`             | Laufende Aufnahmen mit Details anzeigen         |
| `scheduler`          | Zeitplanung prüfen und Jobs starten/stoppen     |
| `logs`               | Log-Ausgabe live verfolgen                      |

## Optionen

| Option                   | Beschreibung                          |
|--------------------------|---------------------------------------|
| `-c, --config <datei>`   | Alternative Konfigurationsdatei       |
| `-V, --verbose`          | Ausführliche Ausgabe                  |
| `--foreground`           | Aufnahme im Vordergrund ausführen     |
| `-h, --help`             | Hilfe anzeigen                        |
| `-v, --version`          | Version anzeigen                      |

## Details

### record

Startet eine Aufnahme im Hintergrund (Standard) oder Vordergrund (`--foreground`). Ohne Job-Name wird eine interaktive Auswahl aller verfügbaren Jobs angezeigt.

```bash
./stream-recorder.sh record                # Job aus Liste wählen
./stream-recorder.sh record mein-stream    # Direkt starten
./stream-recorder.sh --foreground record mein-stream
./stream-recorder.sh -V record mein-stream
```

### create

Erstellt interaktiv eine neue Job-Datei. Fragt nach URL, Name, Typ, Segment-Splitting, Zeitplan und Plik-Upload.

```bash
./stream-recorder.sh create
```

### quick

Schnellaufnahme ohne Job-Datei. Fragt nach URL, Name, Typ und Dauer.

```bash
./stream-recorder.sh quick
```

### stop / stop-all

Stoppt eine laufende Aufnahme. Ohne Job-Name wird eine Auswahl angezeigt. Wenn Plik aktiviert ist, wird die Teilaufnahme hochgeladen. Bei Segment-Splitting werden alle verbleibenden Segmente hochgeladen.

```bash
./stream-recorder.sh stop               # Job aus Liste wählen
./stream-recorder.sh stop mein-stream   # Direkt stoppen
./stream-recorder.sh stop-all           # Alle stoppen
```

### status

Zeigt detaillierte Informationen zu laufenden Aufnahmen:
- Stream-Name und Typ
- PID und Startmodus (manuell/geplant)
- Startzeit und bisherige Laufzeit
- Dateigröße bzw. Anzahl der Segmente und Gesamtgröße
- Scheduler-Status (systemd-Timer)

```bash
./stream-recorder.sh status
```

### list

Zeigt alle konfigurierten Jobs mit Status, Zeitplan, Segment-Einstellungen und Plik-Konfiguration.

```bash
./stream-recorder.sh list
```

### logs

Verfolgt die Log-Ausgabe in Echtzeit (`tail -f`).

```bash
./stream-recorder.sh logs
```

## Logging

Logs werden nach `LOG_DIR` geschrieben (Standard: `/var/log/stream-recorder/`):

| Datei                      | Inhalt                          |
|----------------------------|---------------------------------|
| `stream-recorder.log`      | Alle Operationen des Scripts   |
| `ffmpeg_<job-id>.log`      | ffmpeg-Ausgabe pro Job         |
| `nohup_<job-id>.log`       | Ausgabe im Hintergrund-Modus  |