¿Qué hace Comparador de Videos?
Descripción general
Compara dos videos y genera un informe HTML interactivo analizando 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 habilidad
Usa esta habilidad cuando:
- Comparas videos originales y comprimidos
- Analizas la calidad y eficiencia de la compresión de video
- Evalúas el rendimiento de un codec 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 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 cada 5 segundos)
Opciones de comando
# Archivo de salida personalizado
python3 scripts/compare.py original.mp4 compressed.mp4 -o reporte.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 originales/*.mp4; do
comprimido="comprimido/$(basename "$original")"
salida="reportes/$(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 y extracción de cuadros de video):
# 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 admitidos:
.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 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 el directory traversal)
Cuando falla la validación, aparecen mensajes de error claros con orientación para resolverlos.
Métricas de calidad
El script calcula dos métricas de calidad estándar:
PSNR (Relación Señal-Ruido Pico): Medición de similitud a nivel de píxeles (escala 20-50 dB, cuanto más alto mejor)
SSIM (Índice de Similitud Estructural): Medición de similitud perceptual (escala 0.0-1.0, cuanto más alto 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 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 (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 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, timeouts)
- Excepciones personalizadas:
ValidationError,FFmpegError,VideoComparisonError
Escenarios de error comunes
"FFmpeg no encontrado": Instala FFmpeg a través del gestor de paquetes de tu plataforma (consulta la sección Requisitos)
"Archivo demasiado grande": Comprime los videos antes de la comparación, o ajusta MAX_FILE_SIZE_MB en scripts/compare.py
"Operación agotó el tiempo": Aumenta la constante FFMPEG_TIMEOUT o usa un valor de --interval mayor (procesa menos cuadros)
"El número de cuadros no coincide": 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, timeouts, dimensiones de cuadros 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, solució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 estilo