pvd/README.md

# Amazon PVD Mezzanine Encoder

**Automatisches Python-Tool zur Erstellung von Amazon PVD-konformen Mezzanine-VOD-Dateien und Audio-Master-Dateien**
(ProRes • Blu-ray • DVD • PAL • NTSC • Interlaced)

---

## Features

- **Vollautomatische Erkennung** von SD/HD, PAL/NTSC und interlaced Material
- **ProRes-Quellen mit mehreren Tonspuren** werden unterstuetzt
- **Audio-Sprache und Layout aus Dateinamen** (`DEU51_ENG20`, `DEU20`, usw.)
- **HD-PVD-MP4 mit 30 Mbit/s** und deutscher Stereo-Spur
- **Automatischer Downmix** von deutscher 5.1-Spur auf Stereo, wenn keine deutsche Stereo-Spur vorhanden ist
- **Separate PCM-Audio-MOVs** fuer deutsche Tonspuren und originalsprachige Tonspuren
- **Bester Deinterlacer** (`bwdif mode=0`) → saubere 25 fps bei PAL-DVDs (kein Double-Framerate)
- **Automatische Farbraum-Konvertierung** (Rec.601 PAL/NTSC ↔ Rec.709) inkl. `colorspace`-Filter
- **Forced Subtitles** werden automatisch eingebrannt (wenn `_forced.srt` vorhanden)
- **Informative Tkinter-UI** mit Analyse, Audio-Uebersicht und Encoding-Log
- **Windows-Fallback ohne Tkinter** mit nativen Dateidialogen und Konsolen-Log
- **Amazon PVD optimierte Parameter** (Bitrate, Level, GOP, x264-Settings)
- **Saubere Metadaten** + `faststart` für beste Streaming-Performance
- Funktioniert mit Drag & Drop (`.bat` oder direkt auf Script ziehen)

## Voraussetzungen

- Windows (getestet)
- FFmpeg + FFprobe im `PATH`, in `C:\Tools\FFMPEG` oder in `C:\Software`
- Python 3.10+
- Schreibzugriff auf den Ausgabeordner `F:\VOD` oder `H:\VOD`

## Installation & Nutzung

1. Repo klonen oder herunterladen
2. `ffmpeg.exe` und `ffprobe.exe` in `C:\Software\` ablegen (oder Pfade im Script ändern)
3. Optional: `create_mezzanine.bat` anlegen:
   ```bat
   @echo off
   set "PYTHON_EXE=%LocalAppData%\Programs\Python\Python311\python.exe"
   if exist "%PYTHON_EXE%" (
       "%PYTHON_EXE%" "%~dp0pvd_mezzanine.py" %*
   ) else (
       py -3 "%~dp0pvd_mezzanine.py" %*
   )
   pause
   ```
4. Tool starten:
   ```powershell
   .\create_mezzanine.bat
   ```
5. In der UI Quelle auswaehlen, analysieren und Encoding starten.

Wenn die installierte Python-Version kein Tkinter mitbringt, oeffnet das Tool automatisch einen Windows-Dateidialog fuer die Quelle, verwendet `H:\VOD` als Ausgabeordner und zeigt die Analyse sowie das Encoding-Log in der Konsole.

Fuer automatisierte CLI-Laeufe kann das Encoding direkt gestartet werden:

```powershell
py -3 .\pvd_mezzanine.py --cli "C:\Pfad\zur\Quelle.mov"
```

Alternativ kann die Datei direkt als erster Parameter uebergeben werden:

```powershell
.\create_mezzanine.bat "C:\Pfad\zur\Quelle.mov"
```

## Ausgabe

Das Script schreibt die fertige Mezzanine-Datei standardmäßig nach:

```text
H:\VOD
```

Der MP4-Dateiname wird automatisch aus dem Quellpfad bzw. Blu-ray-Projektordner gebildet und endet auf:

```text
_DEU20_PVD.mp4
```

Bei ProRes-Quellen werden zusaetzlich Audio-MOVs erzeugt:

```text
Titel_DEU_AUDIO_PCM.mov
Titel_OV_AUDIO_PCM.mov
```

Wenn nur deutsche Tonspuren vorhanden sind, wird nur `Titel_DEU_AUDIO_PCM.mov` erzeugt.

## ProRes-Audio-Namen

Die Sprache und das Tonformat der Tonspuren werden aus dem Dateinamen gelesen. Die Tokens stehen in der Reihenfolge der Audiospuren im ProRes.

Beispiele:

```text
Film_DEU51_ENG20.mov
```

- Spur 1: Deutsch 5.1
- Spur 2: Englisch 2.0

```text
Film_DEU20_DEU51.mov
```

- Spur 1: Deutsch 2.0
- Spur 2: Deutsch 5.1
- Es wird nur eine deutsche PCM-Audio-MOV erzeugt.

## Untertitel

Forced Subtitles werden automatisch eingebrannt, wenn neben der Quelle eine gleichnamige Datei mit dem Suffix `_forced.srt` liegt.

Beispiel:

```text
Film.mkv
Film_forced.srt
```

## Audio-Ausgabe

- Das PVD-MP4 bekommt immer deutschen Stereo-Ton.
- Wenn eine deutsche 2.0-Spur vorhanden ist, wird sie verwendet.
- Wenn keine deutsche 2.0-Spur vorhanden ist, wird die erste deutsche Spur auf Stereo heruntergemischt.
- Alle deutschen Tonspuren werden als uncompressed PCM in eine separate MOV geschrieben.
- Alle nicht-deutschen Tonspuren werden als uncompressed PCM in eine separate MOV geschrieben.

## Konfiguration

Die wichtigsten Parameter stehen in `config.json`. Wenn die Datei fehlt, wird sie beim Start mit Default-Werten erzeugt.

```json
{
  "ffmpeg": {
    "ffmpeg_exe": "",
    "ffprobe_exe": "",
    "search_dirs": [
      "C:\\Tools\\FFMPEG",
      "C:\\Software"
    ]
  },
  "output": {
    "base_dir": "",
    "preferred_dirs": [
      "F:\\VOD",
      "H:\\VOD"
    ]
  },
  "video": {
    "hd_bitrate": "30M",
    "hd_maxrate": "35M",
    "hd_bufsize": "50M",
    "sd_bitrate": "8M",
    "sd_maxrate": "10M",
    "sd_bufsize": "15M"
  },
  "audio": {
    "mp4_bitrate": "256k",
    "sample_rate": "48000",
    "pcm_codec": "pcm_s24le"
  }
}
```

FFmpeg wird in dieser Reihenfolge gesucht:

1. Explizite Pfade aus `ffmpeg_exe` und `ffprobe_exe`
2. `PATH`
3. `C:\Tools\FFMPEG`
4. `C:\Software`

Das Zielverzeichnis wird so bestimmt:

1. `output.base_dir`, wenn gesetzt
2. erstes vorhandenes Verzeichnis aus `output.preferred_dirs`, standardmaessig `F:\VOD`, dann `H:\VOD`
3. falls keines existiert, der erste Preferred-Dir-Wert

## Git-Hinweis

Die lokale `.env` enthält Zugangsdaten und wird absichtlich nicht versioniert. Neue Änderungen sollten zusammen mit einer passenden README-Aktualisierung committed und nach `main` gepusht werden.