Comparador de Videos
Resumen
Compara dos videos y genera un informe HTML interactivo que analiza los resultados de compresión. El script extrae metadatos de video, calcula métricas de calidad (PSNR, SSIM) y crea comparaciones visuales cuadro por cuadro con tres modos de visualización: deslizador, lado a lado y cuadrícula.
Cuándo Usar Esta Skill
Usa esta skill cuando:
- Estés comparando videos originales y comprimidos
- Analices la calidad y eficiencia de la compresión de video
- Evalúes el rendimiento de códecs o el impacto de la reducción de bitrate
- Los usuarios mencionen "compare videos", "video quality", "compression analysis" o "before/after compression"
Uso Principal
Comando Básico
python3 scripts/compare.py original.mp4 compressed.mp4
Genera comparison.html con:
- Parámetros de video (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 cuadro por cuadro (por defecto: cuadros en intervalos de 5s)
Opciones del Comando
# Archivo de salida personalizado
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html
# Intervalo de cuadros personalizado (más grande = menos cuadros, procesamiento más rápido)
python3 scripts/compare.py original.mp4 compressed.mp4 --interval 10
# Comparación por lotes
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
Requisitos
Dependencias del Sistema
FFmpeg y FFprobe (requeridos para análisis de video y extracción de cuadros):
# 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 Video
- Formatos soportados:
.mp4(recomendado),.mov,.avi,.mkv,.webm - Límite de tamaño de archivo: 500MB por video (configurable)
- Tiempo de procesamiento: ~1-2 minutos para videos típicos; varía según duración e intervalo de cuadros
Comportamiento del Script
Validación Automática
El script valida automáticamente:
- Instalación y disponibilidad de FFmpeg/FFprobe
- Existencia del archivo, extensiones y límites de tamaño
- Seguridad de rutas (previene directory traversal)
Aparecen mensajes de error claros con guías de resolución cuando la validación falla.
Métricas de Calidad
El script calcula dos métricas de calidad estándar:
PSNR (Peak Signal-to-Noise Ratio): Medida de similitud a nivel de píxel (escala de 20-50 dB, más alto es mejor)
SSIM (Structural Similarity Index): Medida de similitud perceptual (escala 0.0-1.0, más alto es mejor)
Para escalas de interpretación detalladas y umbrales de calidad, consulta references/video_metrics.md.
Extracción de Cuadros
El script extrae cuadros en intervalos especificados (por defecto: 5 segundos), los escala a una altura consistente (800px) para comparación, y los incrusta como URLs de datos base64 en un HTML autocontenido. Los archivos temporales se limpian automáticamente después del procesamiento.
Informe de Salida
El informe HTML generado incluye:
- Modo Deslizador: Arrastra para revelar original vs comprimido (por defecto)
- Modo Lado a Lado: Visualización simultánea para comparación directa
- Modo Cuadrícula: Diseño compacto de 2 columnas
- Controles de Zoom: Magnificación del 50% al 200%
- Formato autocontenido (no requiere servidor, funciona sin conexión)
Detalles Importantes de Implementación
Seguridad
El script implementa:
- Validación de rutas (rutas absolutas, previene directory traversal)
- Prevención de inyección de comandos (sin
shell=True, argumentos validados) - Límites de recursos (tamaño de archivo, timeouts)
- Excepciones personalizadas:
ValidationError,FFmpegError,VideoComparisonError
Escenarios de Error Comunes
"FFmpeg not found": Instala FFmpeg mediante el gestor de paquetes de la plataforma (ver sección de Requisitos)
"File too large": Comprime los videos antes de comparar, o ajusta MAX_FILE_SIZE_MB en scripts/compare.py
"Operation timed out": Aumenta la constante FFMPEG_TIMEOUT o usa un valor mayor en --interval (procesa menos cuadros)
"Frame count mismatch": Los videos tienen diferentes duraciones/tasas de cuadros; el script auto-trunc al mínimo número de cuadros y muestra una advertencia
Configuración
El script incluye constantes ajustables para límites de tamaño de archivo, timeouts, dimensiones de cuadro e intervalos de extracción. Para personalizar el comportamiento, edita las constantes al inicio de scripts/compare.py. Para opciones de configuración detalladas y sus impactos, consulta references/configuration.md.
Materiales de Referencia
Consulta 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, guías de bitrate)references/ffmpeg_commands.md: Referencia de comandos FFmpeg (extracción de metadatos, extracción de cuadros, resolución de problemas)references/configuration.md: Opciones de configuración del script y constantes ajustablesassets/template.html: Plantilla de informe HTML para personalizar modos de visualización y estilos