Video Vergleicher (Video Comparer)
Übersicht
Vergleiche zwei Videos und erstelle einen interaktiven HTML-Bericht zur Analyse der Kompressionsergebnisse. Das Skript extrahiert Video-Metadaten, berechnet Qualitätsmetriken (PSNR, SSIM) und erstellt bildweise visuelle Vergleiche mit drei Ansichtsmodi: Schieberegler (Slider), nebeneinander (Side-by-Side) und Raster (Grid).
Wann Dieses Skill Verwendet Werden Sollte
Verwende dieses Skill, wenn:
- Original- und komprimierte Videos verglichen werden sollen
- Video-Kompressionsqualität und -effizienz analysiert werden soll
- Codec-Leistung oder die Auswirkungen der Bitratenreduzierung bewertet werden soll
- Benutzer „Videos vergleichen“, „Videoqualität“, „Kompressionsanalyse“ oder „Vorher/Nachher-Kompression“ erwähnen
Kernnutzung
Grundlegender Befehl
python3 scripts/compare.py original.mp4 compressed.mp4
Erzeugt comparison.html mit:
- Videoparametern (Codec, Auflösung, Bitrate, Dauer, Dateigröße)
- Qualitätsmetriken (PSNR, SSIM, Größen-/Bitratenreduzierung in Prozent)
- Bildweiser Vergleich (Standard: Bilder im Abstand von 5s)
Befehlsoptionen
# Benutzerdefinierte Ausgabedatei
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html
# Benutzerdefiniertes Bildintervall (größer = weniger Bilder, schnellere Verarbeitung)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10
# Batch-Vergleich
for original in originals/*.mp4; do
compressed="compressed/$(basename "$original")"
output="reports/$(basename "$original" .mp4).html"
python3 scripts/compare.py "$original" "$compressed" -o "$output"
done
Voraussetzungen
Systemabhängigkeiten
FFmpeg und FFprobe (erforderlich für Videoanalyse und Bildextraktion):
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg
# Windows
# Herunterladen von https://ffmpeg.org/download.html
# Oder verwenden: winget install ffmpeg
Python 3.8+ (verwendet Type Hints, f-Strings, pathlib)
Videospezifikationen
- Unterstützte Formate:
.mp4(empfohlen),.mov,.avi,.mkv,.webm - Dateigrößenlimit: 500 MB pro Video (konfigurierbar)
- Verarbeitungszeit: ~1-2 Minuten für typische Videos; variiert je nach Dauer und Bildintervall
Skriptverhalten
Automatische Validierung
Das Skript validiert automatisch:
- Installation und Verfügbarkeit von FFmpeg/FFprobe
- Dateiexistenz, -erweiterungen und -größenlimits
- Pfadsicherheit (verhindert Directory Traversal)
Bei fehlgeschlagener Validierung erscheinen klare Fehlermeldungen mit Lösungsvorschlägen.
Qualitätsmetriken
Das Skript berechnet zwei Standard-Qualitätsmetriken:
PSNR (Peak Signal-to-Noise Ratio): Pixelgenaues Ähnlichkeitsmaß (20-50 dB Skala, höher ist besser)
SSIM (Structural Similarity Index): Wahrnehmungsbasiertes Ähnlichkeitsmaß (0.0-1.0 Skala, höher ist besser)
Detaillierte Interpretationsskalen und Qualitätsschwellenwerte findest du in references/video_metrics.md.
Bildextraktion
Das Skript extrahiert Bilder in festgelegten Intervallen (Standard: 5 Sekunden), skaliert sie auf eine einheitliche Höhe (800px) für den Vergleich und bettet sie als base64-Daten-URLs in den eigenständigen HTML-Bericht ein. Temporäre Dateien werden nach der Verarbeitung automatisch gelöscht.
Ausgabebericht
Der generierte HTML-Bericht enthält:
- Schieberegler-Modus: Ziehen, um Original vs. komprimiert anzuzeigen (Standard)
- Nebeneinander-Modus: Gleichzeitige Anzeige für direkten Vergleich
- Raster-Modus: Kompaktes 2-Spalten-Layout
- Zoom-Steuerung: 50%-200% Vergrößerung
- Eigenständiges Format (kein Server erforderlich, offline nutzbar)
Wichtige Implementierungsdetails
Sicherheit
Das Skript implementiert:
- Pfadvalidierung (absolute Pfade, verhindert Directory Traversal)
- Command Injection Schutz (kein
shell=True, validierte Argumente) - Ressourcenlimits (Dateigröße, Timeouts)
- Benutzerdefinierte Ausnahmen:
ValidationError,FFmpegError,VideoComparisonError
Häufige Fehlerszenarien
„FFmpeg nicht gefunden“: Installiere FFmpeg über den Paketmanager der Plattform (siehe Abschnitt Voraussetzungen)
„Datei zu groß“: Komprimiere Videos vor dem Vergleich oder passe MAX_FILE_SIZE_MB in scripts/compare.py an
„Vorgang Zeitüberschreitung“: Erhöhe die Konstante FFMPEG_TIMEOUT oder verwende einen größeren Wert für --interval (verarbeitet weniger Bilder)
„Bildanzahl stimmt nicht überein“: Videos haben unterschiedliche Dauern/Bildraten; das Skript kürzt automatisch auf die minimale Bildanzahl und zeigt eine Warnung an
Konfiguration
Das Skript enthält anpassbare Konstanten für Dateigrößenlimits, Timeouts, Bildabmessungen und Extraktionsintervalle. Um das Verhalten anzupassen, bearbeite die Konstanten am Anfang von scripts/compare.py. Detaillierte Konfigurationsoptionen und ihre Auswirkungen findest du in references/configuration.md.
Referenzmaterialien
Konsultiere diese Dateien für detaillierte Informationen:
references/video_metrics.md: Interpretation der Qualitätsmetriken (PSNR/SSIM-Skalen, Kompressionsziele, Bitratenrichtlinien)references/ffmpeg_commands.md: FFmpeg-Befehlsreferenz (Metadatenextraktion, Bildextraktion, Fehlerbehebung)references/configuration.md: Skriptkonfigurationsoptionen und anpassbare Konstantenassets/template.html: HTML-Berichtsvorlage zum Anpassen der Ansichtsmodi und des Stils