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 d'affichage : 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 annotations 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 les traversées 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 20-50 dB, plus élevé est meilleur)
SSIM (Structural Similarity Index) : Mesure de similarité perceptuelle (échelle 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 les images à intervalles spécifiés (par défaut : 5 secondes), les redimensionne à une hauteur constante (800 px) 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 supprimé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 : Agrandissement 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 les traversées de répertoires)
- Prévention des injections de commandes (pas de
shell=True, arguments validés) - Limites de ressources (taille de fichier, timeouts)
- Exceptions personnalisées :
ValidationError,FFmpegError,VideoComparisonError
Scénarios d'erreur courants
« FFmpeg introuvable » : Installez FFmpeg via le gestionnaire de paquets de la 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
« Opération expirée » : Augmentez la constante FFMPEG_TIMEOUT ou utilisez une valeur --interval plus grande (traite moins d'images)
« Décalage 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 comprend des constantes ajustables pour les limites de taille de fichier, les timeouts, les dimensions des images 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, objectifs de compression, recommandations 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 d'affichage et le style