Video Comparer
Présentation
Compare deux vidéos et génère 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 une vidéo originale et une vidéo compressée
- 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 originale.mp4 compressee.mp4
Génère comparaison.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)
- 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 : environ 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 validation.
Métriques de qualité
Le script calcule deux métriques de qualité standard :
PSRN (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 les échelles d'interprétation détaillées et les seuils de qualité, consultez references/video_metrics.md.
Extraction d'images
Le script extrait des images à intervalles spécifiés (par défaut : 5 secondes), les met à l'échelle à une hauteur constante (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 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'originale par rapport à la compressée (par défaut)
- Mode côte à côte : Affichage simultané pour une comparaison directe
- Mode grille : Mise en page compacte à 2 colonnes
- Contrôles de zoom : Grossissement de 50% à 200%
- Format autonome (aucun serveur requis, fonctionne hors ligne)
Détails importants de mise en œuvre
Sécurité
Le script implémente :
- Validation des chemins (chemins absolus, empêche le parcours de répertoires)
- Prévention des injections 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 --intervalle plus grande (traite moins d'images)
« Non-correspondance 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 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, 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 d'affichage et le style