v1.0.0 — Herramienta de línea de comandos Desarrollado en Go

pdfcomparer

Compara dos archivos PDF página a página. Detecta diferencias visuales con sensibilidad configurable, alineación automática y procesamiento paralelo. Diseñado para pipelines de CI/CD.

Disponible para: Linux Windows macOS
$ pdfcomparer -a original.pdf -b revised.pdf -dpi 300 -t 0.02
Procesando original.pdf ... 12 páginas
Procesando revised.pdf ... 12 páginas
Comparando páginas ...
Page 3 modificada — diff 2.41%
Page 7 modificada — diff 0.87%
Page 11 modificada — diff 5.12%
────────────────────────────────────
3 / 12 páginas diferentes.
Informe guardado → diff_report.pdf

Desarrollado en Go — técnicas modernas, rendimiento máximo

Concurrencia nativa

Las goroutines y channels orquestan los workers de renderizado y comparación sin overhead.

Binario único

Cero dependencias en tiempo de ejecución. Un ejecutable autónomo para Linux, macOS y Windows.

Bajo consumo de memoria

El recolector de basura de Go mantiene el uso de memoria al mínimo incluso con cientos de páginas.

Velocidad compilada

Código máquina nativo. Sin JVM, sin intérprete — arranca en milisegundos y se mantiene rápido.

Qué hace pdfcomparer

Preciso, configurable y rápido.

Comparación a nivel de píxel

Renderiza cada página en DPI configurable (150–300+) y compara imágenes píxel a píxel usando un umbral de distancia de color que tú controlas.

Alineación automática

Detecta y compensa desplazamientos globales de página automáticamente. Offset de búsqueda y umbral de diff configurables para activar la alineación.

Procesamiento paralelo

Los archivos A y B siempre se renderizan en paralelo. Configura workers de renderizado por archivo (-rw) y workers de comparación (-j) de forma independiente.

Informe visual de diferencias

Genera un informe en PDF que resalta todas las regiones modificadas. Ruta de salida configurable con -o.

Selección de rango de páginas

Compara solo las páginas que necesitas. Soporta rangos como 1-10 o listas mixtas como 1,3,7-12.

Multi-idioma

El idioma del informe se detecta automáticamente desde la variable de entorno LANG. Soporta inglés, portugués (pt-br) y español.

Referencia de opciones

pdfcomparer -a ARCHIVO_A -b ARCHIVO_B [opciones]

Obligatorias
Flag Tipo Descripción
-astringPrimer archivo PDF (original)
-bstringSegundo archivo PDF (modificado)
Salida
Flag Tipo Descripción
-o string PDF de informe de salida (por defecto: diff_report.pdf)
-lang string Idioma del informe: en, pt-br, es (por defecto: detectado automáticamente vía LANG)
Sensibilidad de la comparación
Flag Tipo Descripción
-t float Umbral de distancia de color 0.0–1.0 (por defecto: 0.05)
0.01 = diferencias muy sutiles | 0.10 = solo diferencias obvias
-min-diff-pct float Diff% mínimo para considerar una página diferente (por defecto: 0.0)
Usa 3.0 con -align=true para suprimir ruido de anti-aliasing
-aa-blur int Radio de desenfoque antes de comparar (0 = desactivado)
1 = elimina anti-aliasing de 1 px | 2 = suprime gradientes de hasta 3 px
Renderizado
Flag Tipo Descripción
-dpi int Resolución de renderizado (por defecto: 150)
150 = rápido, bueno para texto | 300 = alta calidad, detecta diffs en imágenes
-pages string Rango de páginas, ej.: "1-10" o "1,3,7-12" (por defecto: todas)
-rw int Workers de renderizado por archivo; A y B siempre se renderizan en paralelo (por defecto: 2)
ej.: -rw 4 lanza 4 procesos pdftoppm por archivo (8 en total)
-j int Workers de comparación (por defecto: 4)
Alineación automática
Flag Tipo Descripción
-align bool Auto-alinear: detecta y compensa desplazamiento global cuando el diff de la página es alto (por defecto: true)
-align-thr float Diff% aproximado por encima del cual se intenta la alineación (por defecto: 3.0)
-max-offset int Offset máximo en píxeles al alinear (por defecto: 50)
Licencia
Flag Tipo Descripción
-machine-id Imprime el ID de licencia de esta máquina y sale (envíalo para obtener una licencia de uso)
-license string Ruta al archivo de licencia (.lic)
O define PDFCOMPARE_LICENSE, o coloca pdfcompare.lic junto al binario
-license-info Muestra la información del licenciatario y sale

Ejemplos

Comparación básica

$ pdfcomparer -a original.pdf -b revised.pdf

Alta calidad, primeras 50 páginas

$ pdfcomparer -a original.pdf -b revised.pdf -t 0.02 -dpi 300 -pages 1-50

Paralelismo máximo

$ pdfcomparer -a original.pdf -b revised.pdf -rw 4 -j 8 -o report.pdf

Suprimir ruido de anti-aliasing

$ pdfcomparer -a a.pdf -b b.pdf -align=true -min-diff-pct 3.0 -o report.pdf

Obtener ID de máquina para licencia

$ pdfcomparer -machine-id

Verificar información de licencia

$ pdfcomparer -license pdfcompare.lic -license-info

Planes de licencia

Licencia por máquina. Todas las funciones incluidas desde el primer día.

Licencia semestral

US$ 750
por 6 meses
  • Todas las opciones y flags de la CLI
  • Linux, Windows y macOS
  • Actualizaciones incluidas durante el período
  • Licencia vinculada a una sola máquina
Obtener licencia
Ahorra US$ 300

Licencia anual

US$ 1.200
por año
  • Todas las opciones y flags de la CLI
  • Linux, Windows y macOS
  • Actualizaciones incluidas durante el período
  • Licencia vinculada a una sola máquina
Obtener licencia

Para adquirir, ejecuta pdfcomparer -machine-id y envía el ID a [email protected]