Communitygithub.com

Comparateur Vidéo

Cette compétence est utilisée pour comparer deux vidéos afin d'analyser les résultats de compression ou les différences de qualité. Génère des rapports HTML interactifs avec des métriques de qualité (PSNR, SSIM) et des comparaisons visuelles image par image. Déclenchée lorsque l'utilisateur mentionne « comparer des vidéos », « qualité vidéo », « analyse de compression », « avant/après compression » ou demande une évaluation de la qualité de vidéos compressées.

Qu'est-ce que Comparateur Vidéo ?

Cette compétence permet de comparer deux vidéos et de générer un rapport HTML interactif pour analyser les résultats de compression. Elle extrait les métadonnées des vidéos, calcule les métriques de qualité standard (PSNR, SSIM) et crée des comparaisons visuelles image par image avec trois modes d'affichage : curseur, côte à côte et grille. Utile pour les développeurs, ingénieurs vidéo et testeurs QA, elle fonctionne sur macOS, Linux et Windows via une ligne de commande simple. Le rapport généré est autonome (aucun serveur requis) et inclut des contrôles de zoom. La compétence valide automatiquement les dépendances (FFmpeg/FFprobe), les fichiers et les limites de taille, et gère les erreurs courantes avec des messages clairs. Elle est idéale pour évaluer l'impact de la compression, comparer les performances des codecs ou vérifier la qualité avant/après encodage.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/IGTA-Tech/claude-skills-research/tree/HEAD/claude-code-skills/video-comparer

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 ajustables
  • assets/template.html : Modèle de rapport HTML pour personnaliser les modes d'affichage et le style

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

IGTA-Tech/claude-skills-research

Use when localizing apps, using String Catalogs, generating type-safe symbols (Xcode 26+), handling plurals, RTL layouts, locale-aware formatting, or migrating from .strings files - comprehensive i18n patterns for Xcode 15-26

IGTA-Tech/claude-skills-research

Use when implementing SwiftUI animations, understanding VectorArithmetic, using @Animatable macro, choosing between spring and timing curve animations, or debugging animation behavior - comprehensive animation reference from iOS 13 through iOS 26

IGTA-Tech/claude-skills-research

Use when CAAnimation completion handler doesn't fire, spring physics look wrong on device, animation duration mismatches actual time, gesture + animation interaction causes jank, or timing differs between simulator and real hardware - systematic CAAnimation diagnosis with CATransaction patterns, frame rate awareness, and device-specific behavior

IGTA-Tech/claude-skills-research

Download YouTube videos and HLS streams (m3u8) from platforms like Mux, Vimeo, etc. using yt-dlp and ffmpeg. Use this skill when users request downloading videos, extracting audio, handling protected streams with authentication headers, or troubleshooting download issues like nsig extraction failures, 403 errors, or cookie extraction problems.

IGTA-Tech/claude-skills-research

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

IGTA-Tech/claude-skills-research

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

IGTA-Tech/claude-skills-research

Download YouTube video transcripts when user provides a YouTube URL or asks to download/get/fetch a transcript from YouTube. Also use when user wants to transcribe or get captions/subtitles from a YouTube video.

Skills associés