Que fait Comparateur Vidéo ?
Présentation
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
- L'utilisateur mentionne « comparer des vidéos », « qualité vidéo », « analyse de compression » ou « avant/après compression »
Utilisation principale
Commande de base
python3 scripts/compare.py originale.mp4 compressee.mp4
Génère comparison.html avec :
- Les paramètres vidéo (codec, résolution, débit, durée, taille du fichier)
- Les métriques de qualité (PSNR, SSIM, pourcentages de réduction de taille/débit)
- Une comparaison image par image (par défaut : images toutes les 5 secondes)
Options de commande
# Fichier de sortie personnalisé
python3 scripts/compare.py originale.mp4 compressee.mp4 -o rapport.html
# Intervalle d'images personnalisé (plus grand = moins d'images, traitement plus rapide)
python3 scripts/compare.py originale.mp4 compressee.mp4 --intervalle 10
# Comparaison par lots
for originale in originales/*.mp4; do
compressee="compressees/$(basename "$originale")"
sortie="rapports/$(basename "$originale" .mp4).html"
python3 scripts/compare.py "$originale" "$compressee" -o "$sortie"
done
Prérequis
Dépendances système
FFmpeg et FFprobe (nécessaires 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 les traversées de répertoire)
Des messages d'erreur clairs avec des conseils de résolution apparaissent en cas d'échec de 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 pixel (é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 à des intervalles spécifiés (par défaut : 5 secondes), les redimensionne à une hauteur constante (800px) pour la comparaison, et les intègre sous forme d'URL de données base64 dans du HTML autonome. Les fichiers temporaires sont automatiquement nettoyés après le traitement.
Rapport de sortie
Le rapport HTML généré inclut :
- Mode curseur : Faites glisser pour révéler l'originale vs la compressée (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 les traversées de répertoire)
- 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
« Opération expirée » : Augmentez la constante FFMPEG_TIMEOUT ou utilisez une valeur --intervalle plus grande (traite moins d'images)
« Nombre d'images non correspondant » : Les vidéos ont des durées/taux d'images différents ; le script tronque automatiquement au nombre d'images minimal 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'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.
Documentation 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, recommandations de débit)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