Video-Comparer
Übersicht
Vergleichen Sie zwei Videos und generieren Sie einen interaktiven HTML-Bericht, der die Kompressionsergebnisse analysiert. Das Skript extrahiert Videometadaten, berechnet Qualitätsmetriken (PSNR, SSIM) und erstellt bildgenaue visuelle Vergleiche mit drei Ansichtsmodi: Schieberegler, nebeneinander und Raster.
Wann dieses Skill verwendet werden sollte
Verwenden Sie dieses Skill, wenn:
- Sie Original- und komprimierte Videos vergleichen möchten
- Sie die Qualität und Effizienz einer Videokompression analysieren möchten
- Sie die Leistung eines Codecs oder die Auswirkungen einer Bitratenreduzierung bewerten möchten
- Benutzer Begriffe wie "Videos vergleichen", "Videoqualität", "Kompressionsanalyse" oder "Vorher/Nachher-Kompression" erwähnen
Grundlegende Verwendung
Basiskommando
python3 scripts/compare.py original.mp4 compressed.mp4
Erzeugt comparison.html mit:
- Videoparametern (Codec, Auflösung, Bitrate, Dauer, Dateigröße)
- Qualitätsmetriken (PSNR, SSIM, prozentuale Größen-/Bitratenreduktion)
- Bildgenauem Vergleich (Standard: Frames in 5-Sekunden-Intervallen)
Kommandooptionen
# Benutzerdefinierte Ausgabedatei
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html
# Benutzerdefiniertes Frame-Intervall (größer = weniger Frames, 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 Frameextraktion):
# 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 Frame-Intervall
Skriptverhalten
Automatische Validierung
Das Skript validiert automatisch:
- Installation und Verfügbarkeit von FFmpeg/FFprobe
- Dateiexistenz, -endungen und -größenlimits
- Pfadsicherheit (verhindert Directory Traversal)
Bei fehlgeschlagener Validierung erscheinen klare Fehlermeldungen mit Anleitungen zur Behebung.
Qualitätsmetriken
Das Skript berechnet zwei Standard-Qualitätsmetriken:
PSNR (Peak Signal-to-Noise Ratio): Pixelgenaue Ähnlichkeitsmessung (Skala 20–50 dB, höher ist besser)
SSIM (Structural Similarity Index): Wahrnehmungsbasierte Ähnlichkeitsmessung (Skala 0,0–1,0, höher ist besser)
Detaillierte Interpretationsskalen und Qualitätsschwellenwerte finden Sie in references/video_metrics.md.
Frameextraktion
Das Skript extrahiert Frames in festgelegten Intervallen (Standard: 5 Sekunden), skaliert sie auf eine einheitliche Höhe (800 Pixel) für den Vergleich und bettet sie als Base64-Daten-URLs in einem 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 aufzudecken (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, funktioniert offline)
Wichtige Implementierungsdetails
Sicherheit
Das Skript implementiert:
- Pfadvalidierung (absolute Pfade, verhindert Directory Traversal)
- Schutz vor Befehlsinjektion (kein
shell=True, validierte Argumente) - Ressourcenlimits (Dateigröße, Timeouts)
- Benutzerdefinierte Ausnahmen:
ValidationError,FFmpegError,VideoComparisonError
Häufige Fehlerszenarien
"FFmpeg nicht gefunden": Installieren Sie FFmpeg über den Paketmanager Ihrer Plattform (siehe Abschnitt Voraussetzungen)
"Datei zu groß": Komprimieren Sie Videos vor dem Vergleich oder passen Sie MAX_FILE_SIZE_MB in scripts/compare.py an.
"Vorgang zeitlich überschritten": Erhöhen Sie die Konstante FFMPEG_TIMEOUT oder verwenden Sie einen größeren Wert für --interval (verarbeitet weniger Frames)
"Frame-Anzahl stimmt nicht überein": Videos haben unterschiedliche Dauern/Bildraten; das Skript kürzt automatisch auf die minimale Frame-Anzahl und zeigt eine Warnung an.
Konfiguration
Das Skript enthält anpassbare Konstanten für Dateigrößenlimits, Timeouts, Frame-Abmessungen und Extraktionsintervalle. Um das Verhalten anzupassen, bearbeiten Sie die Konstanten am Anfang von scripts/compare.py. Ausführliche Konfigurationsoptionen und deren Auswirkungen finden Sie in references/configuration.md.
Referenzmaterialien
Konsultieren Sie 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, Frameextraktion, Fehlerbehebung)references/configuration.md: Skriptkonfigurationsoptionen und anpassbare Konstantenassets/template.html: HTML-Berichtsvorlage zur Anpassung der Ansichtsmodi und des Stils