¿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 ajustablesassets/template.html: Plantilla de informe HTML para personalizar modos de visualización y estilos