Comparateur vidéo
Aperçu
Comparez deux vidéos et générez un rapport HTML interactif analysant les résultats de compression. Le script extrait les métadonnées vidéo, calcule les métriques de qualité (PSNR, SSIM) et crée des comparaisons visuelles image par image avec trois modes de visualisation : curseur, côte à côte et grille.
Quand utiliser cette compétence
Utilisez cette compétence lorsque :
- Vous comparez des vidéos originales et compressées
- Vous analysez la qualité et l'efficacité de la compression vidéo
- Vous évaluez les performances d'un codec ou l'impact d'une réduction de débit binaire
- Les utilisateurs mentionnent « comparer des vidéos », « qualité vidéo », « analyse de compression » ou « avant/après compression »
Utilisation principale
Commande de base
python3 scripts/compare.py original.mp4 compressed.mp4
Génère comparison.html avec :
- Paramètres vidéo (codec, résolution, débit binaire, durée, taille du fichier)
- Métriques de qualité (PSNR, SSIM, pourcentages de réduction de taille/débit binaire)
- Comparaison image par image (par défaut : images toutes les 5 secondes)
Options de commande
# Fichier de sortie personnalisé
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html
# Intervalle d'images personnalisé (plus grand = moins d'images, traitement plus rapide)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10
# Comparaison par lots
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
Prérequis
Dépendances système
FFmpeg et FFprobe (requis pour l'analyse vidéo et l'extraction d'images) :
# macOS
brew install ffmpeg
# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg
# Windows
# Télécharger depuis https://ffmpeg.org/download.html
# Ou utiliser : winget install ffmpeg
Python 3.8+ (utilise les indications de type, les f-strings, pathlib)
Spécifications vidéo
- Formats pris en charge :
.mp4(recommandé),.mov,.avi,.mkv,.webm - Limite de taille de fichier : 500 Mo par vidéo (configurable)
- Temps de traitement : ~1-2 minutes pour des vidéos typiques ; varie selon la durée et l'intervalle d'images
Comportement du script
Validation automatique
Le script valide automatiquement :
- L'installation et la disponibilité de FFmpeg/FFprobe
- L'existence des fichiers, les extensions et les limites de taille
- La sécurité des chemins (empêche le parcours de répertoires)
Des messages d'erreur clairs avec des conseils de résolution apparaissent en cas d'échec de la validation.
Métriques de qualité
Le script calcule deux métriques de qualité standard :
PSNR (Peak Signal-to-Noise Ratio) : Mesure de similarité au niveau des pixels (échelle de 20 à 50 dB, plus élevé est meilleur)
SSIM (Structural Similarity Index) : Mesure de similarité perceptuelle (échelle de 0,0 à 1,0, plus élevé est meilleur)
Pour des échelles d'interprétation détaillées et des seuils de qualité, consultez references/video_metrics.md.
Extraction d'images
Le script extrait des images à des intervalles spécifiés (par défaut : 5 secondes), les redimensionne à une hauteur cohérente (800 pixels) pour la comparaison, et les intègre sous forme d'URL de données base64 dans un rapport HTML autonome. Les fichiers temporaires sont automatiquement nettoyés après le traitement.
Rapport de sortie
Le rapport HTML généré comprend :
- Mode curseur : Faites glisser pour révéler l'original vs le compressé (par défaut)
- Mode côte à côte : Affichage simultané pour une comparaison directe
- Mode grille : Disposition compacte sur 2 colonnes
- Contrôles de zoom : Grossissement de 50 % à 200 %
- Format autonome (aucun serveur requis, fonctionne hors ligne)
Détails d'implémentation importants
Sécurité
Le script implémente :
- Validation des chemins (chemins absolus, empêche le parcours de répertoires)
- Prévention d'injection de commandes (pas de
shell=True, arguments validés) - Limites de ressources (taille de fichier, délais d'attente)
- Exceptions personnalisées :
ValidationError,FFmpegError,VideoComparisonError
Scénarios d'erreur courants
« FFmpeg introuvable » : Installez FFmpeg via le gestionnaire de paquets de votre plateforme (voir la section Prérequis)
« Fichier trop volumineux » : Compressez les vidéos avant la comparaison, ou ajustez MAX_FILE_SIZE_MB dans scripts/compare.py
« L'opération a expiré » : Augmentez la constante FFMPEG_TIMEOUT ou utilisez une valeur --interval plus grande (traite moins d'images)
« Non-concordance du nombre d'images » : Les vidéos ont des durées/taux d'images différents ; le script tronque automatiquement au nombre d'images minimum et affiche un avertissement
Configuration
Le script inclut des constantes ajustables pour les limites de taille de fichier, les délais d'attente, les dimensions d'image et les intervalles d'extraction. Pour personnaliser le comportement, modifiez les constantes en haut de scripts/compare.py. Pour des options de configuration détaillées et leurs impacts, consultez references/configuration.md.
Documents de référence
Consultez ces fichiers pour des informations détaillées :
references/video_metrics.md: Interprétation des métriques de qualité (échelles PSNR/SSIM, cibles de compression, directives de débit binaire)references/ffmpeg_commands.md: Référence des commandes FFmpeg (extraction de métadonnées, extraction d'images, dépannage)references/configuration.md: Options de configuration du script et constantes ajustablesassets/template.html: Modèle de rapport HTML pour personnaliser les modes de visualisation et le style