Video-Comparer
Übersicht
Vergleichen Sie zwei Videos und generieren Sie einen interaktiven HTML-Bericht zur Analyse der Komprimierungsergebnisse. Das Skript extrahiert Video-Metadaten, berechnet Qualitätsmetriken (PSNR, SSIM) und erstellt bildweise visuelle Vergleiche mit drei Anzeigemodi: Schieberegler, nebeneinander und Raster.
Wann dieses Skill verwendet werden sollte
Verwenden Sie dieses Skill, wenn:
- Original- und komprimierte Videos verglichen werden sollen
- Die Qualität und Effizienz der Videokomprimierung analysiert werden soll
- Die Leistung eines Codecs oder die Auswirkungen einer Bitratenreduzierung bewertet werden soll
- Nutzer Begriffe wie "Videos vergleichen", "Videoqualität", "Komprimierungsanalyse" oder "Vorher/Nachher-Komprimierung" erwähnen
Kernnutzung
Basiskommando
python3 scripts/compare.py original.mp4 compressed.mp4
Generiert comparison.html mit:
- Videoparametern (Codec, Auflösung, Bitrate, Dauer, Dateigröße)
- Qualitätsmetriken (PSNR, SSIM, Größen-/Bitratenreduzierung in Prozent)
- Bildweiser Vergleich (Standard: Bilder in 5-Sekunden-Intervallen)
Kommandooptionen
# 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
Anforderungen
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 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, Erweiterungen und Größenlimits
- Pfadsicherheit (verhindert Directory Traversal)
Klare Fehlermeldungen mit Lösungshinweisen erscheinen bei fehlgeschlagener Validierung.
Qualitätsmetriken
Das Skript berechnet zwei Standard-Qualitätsmetriken:
PSNR (Peak Signal-to-Noise Ratio): Pixelgenaue Ähnlichkeitsmessung (20-50 dB-Skala, höher ist besser)
SSIM (Structural Similarity Index): Wahrnehmungsbezogene Ähnlichkeitsmessung (0.0-1.0-Skala, höher ist besser)
Eine detaillierte Interpretation der Skalen und Qualitätsschwellenwerte finden Sie in references/video_metrics.md.
Bildextraktion
Das Skript extrahiert Bilder 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 das eigenständige HTML ein. Temporäre Dateien werden nach der Verarbeitung automatisch bereinigt.
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)
- 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 Anforderungen)
"Datei zu groß": Komprimieren Sie Videos vor dem Vergleich oder passen Sie MAX_FILE_SIZE_MB in scripts/compare.py an
"Vorgang abgelaufen (Timeout)": Erhöhen Sie die Konstante FFMPEG_TIMEOUT oder verwenden Sie 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, bearbeiten Sie die Konstanten am Anfang von scripts/compare.py. Detaillierte Konfigurationsoptionen und ihre Auswirkungen finden Sie in references/configuration.md.
Referenzmaterialien
Konsultieren Sie diese Dateien für detaillierte Informationen:
references/video_metrics.md: Interpretation von Qualitätsmetriken (PSNR/SSIM-Skalen, Komprimierungsziele, Bitratenrichtlinien)references/ffmpeg_commands.md: FFmpeg-Befehlsreferenz (Metadatenextraktion, Bildextraktion, Fehlerbehebung)references/configuration.md: Skript-Konfigurationsoptionen und anpassbare Konstantenassets/template.html: HTML-Berichtsvorlage zur Anpassung von Anzeigemodi und Styling