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 los videos, 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 habilidad
Usa esta habilidad cuando:
- Se comparan videos originales y comprimidos
- Se analiza la calidad y eficiencia de la compresión de video
- Se evalúa el rendimiento de un códec o el impacto de la reducción de bitrate
- Los usuarios mencionan "comparar videos", "calidad de video", "análisis de compresión" o "antes/después de compresión"
Uso principal
Comando básico
python3 scripts/compare.py original.mp4 compressed.mp4
Genera comparison.html con:
- Parámetros del 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 cada 5 segundos)
Opciones de comando
# Archivo de salida personalizado
python3 scripts/compare.py original.mp4 compressed.mp4 -o report.html
# Intervalo de cuadros personalizado (mayor = 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 (necesarios 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 de https://ffmpeg.org/download.html
# O usar: winget install ffmpeg
Python 3.8+ (usa type hints, f-strings, pathlib)
Especificaciones de video
- Formatos compatibles:
.mp4(recomendado),.mov,.avi,.mkv,.webm - Límite de tamaño de archivo: 500 MB por video (configurable)
- Tiempo de procesamiento: ~1-2 minutos para videos típicos; varía según la duración y el intervalo de cuadros
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 directory traversal)
Aparecen mensajes de error claros con orientación para la 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): Medición de similitud a nivel de píxel (escala de 20-50 dB, más alto es mejor)
SSIM (Structural Similarity Index): Medición de similitud perceptual (escala de 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 uniforme (800px) para la comparación, y los incrusta como URLs de datos base64 en un HTML autónomo. Los archivos temporales se eliminan automáticamente después del procesamiento.
Informe de salida
El informe HTML generado incluye:
- Modo deslizador: Arrastra 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: Magnificación 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 directory traversal)
- 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 not found": Instala FFmpeg mediante el gestor de paquetes de la plataforma (ver sección Requisitos)
"File too large": Comprime los videos antes de la comparación, o ajusta MAX_FILE_SIZE_MB en scripts/compare.py
"Operation timed out": Aumenta la constante FFMPEG_TIMEOUT o usa un valor mayor de --interval (procesa menos cuadros)
"Frame count mismatch": Los videos tienen diferentes duraciones/tasas de cuadros; el script trunca automáticamente al número mínimo de cuadros y muestra una advertencia
Configuración
El script incluye constantes ajustables para límites de tamaño de archivo, tiempos de espera, dimensiones de cuadros e intervalos de extracción. Para personalizar el comportamiento, edita las constantes al principio 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, solución de problemas)references/configuration.md: Opciones de configuración del script y constantes ajustablesassets/template.html: Plantilla del informe HTML para personalizar modos de visualización y estilos