Communitygithub.com

Comparador de Vídeos

Analiza la calidad de compresión de dos vídeos (original vs comprimido) generando un informe HTML interactivo con métricas PSNR/SSIM y comparaciones fotograma a fotograma.

¿Qué es Comparador de Vídeos?

Esta habilidad está diseñada para desarrolladores, ingenieros de video y entusiastas del procesamiento multimedia que necesitan evaluar el impacto de la compresión de video. Al ejecutar el script de Python proporcionado, los usuarios pueden comparar un video original con su versión comprimida y obtener un informe HTML completo. El informe incluye métricas clave de calidad como PSNR (relación señal-ruido pico) y SSIM (índice de similitud estructural), junto con parámetros detallados del video (codec, resolución, bitrate, duración, tamaño de archivo). La herramienta ofrece tres modos de visualización interactiva: deslizador (arrastrar para revelar original vs comprimido), lado a lado y cuadrícula, con controles de zoom. Soporta múltiples formatos de video (.mp4, .mov, .avi, .mkv, .webm) y tiene un límite configurable de 500 MB por archivo. La funcionalidad se basa en FFmpeg y FFprobe para el análisis y extracción de fotogramas, y está optimizada para ser utilizada en entornos de línea de comandos (CLI) como parte de flujos de trabajo de control de calidad de video o evaluación de codecs. Es compatible con sistemas macOS, Ubuntu/Debian y Windows, y es ideal para agentes de IA que interactúan con el sistema de archivos local o entornos de desarrollo.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Comparador de Vídeos?

Resumen

Compara dos vídeos y genera un informe HTML interactivo que analiza los resultados de compresión. El script extrae metadatos del vídeo, calcula métricas de calidad (PSNR, SSIM) y crea comparaciones visuales fotograma a fotograma con tres modos de visualización: deslizador, lado a lado y cuadrícula.

Cuándo Usar Esta Habilidad

Utilice esta habilidad cuando:

  • Compare vídeos original y comprimido
  • Analice la calidad y eficiencia de la compresión de vídeo
  • Evalúe el rendimiento de un códec o el impacto de la reducción de bitrate
  • Los usuarios mencionen "comparar vídeos", "calidad de vídeo", "análisis de compresión" o "antes/después de compresión"

Uso Principal

Comando Básico

python3 scripts/compare.py original.mp4 comprimido.mp4

Genera comparison.html con:

  • Parámetros del vídeo (códec, resolución, bitrate, duración, tamaño de archivo)
  • Métricas de calidad (PSNR, SSIM, porcentajes de reducción de tamaño/bitrate)
  • Comparación fotograma a fotograma (por defecto: fotogramas cada 5 segundos)

Opciones del Comando

# Archivo de salida personalizado
python3 scripts/compare.py original.mp4 comprimido.mp4 -o informe.html

# Intervalo de fotogramas personalizado (mayor = menos fotogramas, procesamiento más rápido)
python3 scripts/compare.py original.mp4 comprimido.mp4 --interval 10

# Comparación por lotes
for original in originales/*.mp4; do
    comprimido="comprimidos/$(basename "$original")"
    salida="informes/$(basename "$original" .mp4).html"
    python3 scripts/compare.py "$original" "$comprimido" -o "$salida"
done

Requisitos

Dependencias del Sistema

FFmpeg y FFprobe (necesarios para el análisis de vídeo y extracción de fotogramas):

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt update && sudo apt install ffmpeg

# Windows
# Descargar desde https://ffmpeg.org/download.html
# O usar: winget install ffmpeg

Python 3.8+ (usa type hints, f-strings, pathlib)

Especificaciones de Vídeo

  • Formatos compatibles: .mp4 (recomendado), .mov, .avi, .mkv, .webm
  • Límite de tamaño de archivo: 500 MB por vídeo (configurable)
  • Tiempo de procesamiento: ~1-2 minutos para vídeos típicos; varía según la duración y el intervalo de fotogramas

Comportamiento del Script

Validación Automática

El script valida automáticamente:

  • Instalación y disponibilidad de FFmpeg/FFprobe
  • Existencia de archivos, extensiones y límites de tamaño
  • Seguridad de rutas (previene el recorrido de directorios)

Aparecen mensajes de error claros con orientación para la resolución cuando falla la validación.

Métricas de Calidad

El script calcula dos métricas de calidad estándar:

PSNR (Relación Señal-Ruido Pico): Medida de similitud a nivel de píxel (escala 20-50 dB, cuanto más alto mejor)

SSIM (Índice de Similitud Estructural): Medida de similitud perceptual (escala 0.0-1.0, cuanto más alto mejor)

Para escalas de interpretación detalladas y umbrales de calidad, consulte references/video_metrics.md.

Extracción de Fotogramas

El script extrae fotogramas en intervalos especificados (por defecto: 5 segundos), los escala a una altura consistente (800 px) para la comparación, y los incrusta como URL de datos base64 en HTML autónomo. Los archivos temporales se limpian automáticamente después del procesamiento.

Informe de Salida

El informe HTML generado incluye:

  • Modo Deslizador: Arrastre para revelar original vs comprimido (predeterminado)
  • Modo Lado a Lado: Visualización simultánea para comparación directa
  • Modo Cuadrícula: Diseño compacto de 2 columnas
  • Controles de Zoom: Aumento del 50% al 200%
  • Formato autónomo (no requiere servidor, funciona sin conexión)

Detalles Importantes de Implementación

Seguridad

El script implementa:

  • Validación de rutas (rutas absolutas, previene el recorrido de directorios)
  • Prevención de inyección de comandos (sin shell=True, argumentos validados)
  • Límites de recursos (tamaño de archivo, tiempos de espera)
  • Excepciones personalizadas: ValidationError, FFmpegError, VideoComparisonError

Escenarios de Error Comunes

"FFmpeg no encontrado": Instale FFmpeg a través del gestor de paquetes de la plataforma (consulte la sección Requisitos)

"Archivo demasiado grande": Comprima los vídeos antes de la comparación, o ajuste MAX_FILE_SIZE_MB en scripts/compare.py

"Operación agotó el tiempo de espera": Aumente la constante FFMPEG_TIMEOUT o use un valor --interval más grande (procesa menos fotogramas)

"El número de fotogramas no coincide": Los vídeos tienen diferentes duraciones/tasas de fotogramas; el script trunca automáticamente al número mínimo de fotogramas y muestra una advertencia

Configuración

El script incluye constantes ajustables para límites de tamaño de archivo, tiempos de espera, dimensiones de fotogramas e intervalos de extracción. Para personalizar el comportamiento, edite las constantes al inicio de scripts/compare.py. Para opciones de configuración detalladas y sus impactos, consulte references/configuration.md.

Materiales de Referencia

Consulte estos archivos para obtener información detallada:

  • references/video_metrics.md: Interpretación de métricas de calidad (escalas PSNR/SSIM, objetivos de compresión, pautas de bitrate)
  • references/ffmpeg_commands.md: Referencia de comandos FFmpeg (extracción de metadatos, extracción de fotogramas, resolución de problemas)
  • references/configuration.md: Opciones de configuración del script y constantes ajustables
  • assets/template.html: Plantilla de informe HTML para personalizar modos de visualización y estilos

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 relacionados