Video Comparer
Übersicht
Vergleiche zwei Videos und erzeuge einen interaktiven HTML-Bericht, der die Kompressionsergebnisse analysiert. Das Skript extrahiert Video-Metadaten, berechnet Qualitätsmetriken (PSNR, SSIM) und erstellt bildgenaue Vergleiche in drei Ansichtsmodi: Schieberegler, nebeneinander und Raster.
Wann Dieses Skill Verwenden
Verwende dieses Skill, wenn:
- Original- und komprimierte Videos verglichen werden sollen
- Video-Kompressionsqualität und -effizienz analysiert werden soll
- Codec-Leistung oder die Auswirkung von Bitratenreduktion bewertet wird
- Benutzer Begriffe wie "Videos vergleichen", "Videoqualität", "Kompressionsanalyse" oder "Vorher/Nachher-Kompression" erwähnen
Kernnutzung
Einfacher 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-/Bitratenreduktion in Prozent)
- Bildgenauem Vergleich (Standard: Bilder im Abstand von 5 s)
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 Bild-Extraktion):
# 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 Typannotationen, 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, -endungen und -größenlimits
- Pfadsicherheit (verhindert Directory-Traversal)
Bei fehlgeschlagener Validierung erscheinen klare Fehlermeldungen mit Lösungshinweisen.
Qualitätsmetriken
Das Skript berechnet zwei standardisierte Metriken:
PSNR (Peak Signal-to-Noise Ratio): Pixelgenaues Ähnlichkeitsmaß (Skala 20–50 dB, höher = besser)
SSIM (Structural Similarity Index): Wahrnehmungsbasiertes Ähnlichkeitsmaß (Skala 0,0–1,0, höher = besser)
Für detaillierte Interpretationsskalen und Qualitätsschwellenwerte siehe references/video_metrics.md.
Bild-Extraktion
Das Skript extrahiert Bilder zu den angegebenen Zeitintervallen (Standard: 5 s), skaliert sie auf eine einheitliche Höhe (800 px) 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 erzeugte HTML-Bericht umfasst:
- 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, offline nutzbar)
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": 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 zeitlich ausgelaufen": Erhöhe die Konstante FFMPEG_TIMEOUT oder verwende einen größeren --interval-Wert (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, Bild-Extraktion, Fehlerbehebung)references/configuration.md: Skript-Konfigurationsoptionen und anpassbare Konstantenassets/template.html: HTML-Berichtsvorlage zur Anpassung der Ansichtsmodi und des Stils