Línea de comandos (jpgboost-cli)

jpgboost-cli comprime tus imágenes sin abrir la interfaz gráfica. Es la herramienta preferida para scripts, tareas programadas e integraciones continuas.

Para qué sirve la línea de comandos

jpgboost-cli es un ejecutable autónomo, incluido dentro de JPGBoost.app. No depende ni de la API local ni de una instancia en ejecución de la aplicación: usa directamente el mismo motor de decodificación y codificación, por lo que produce exactamente los mismos archivos que la interfaz gráfica.

Es el punto de entrada preferido cuando no debe abrirse ninguna interfaz: un script de shell, una tarea programada, una integración continua, el procesamiento de un gran número de archivos.

Hacer accesible el comando

El binario se encuentra dentro del paquete de la aplicación. Puedes llamarlo directamente por su ruta completa:

/Applications/JPGBoost.app/Contents/MacOS/jpgboost-cli --help

Para poder ejecutar jpgboost-cli desde cualquier carpeta, crea un enlace simbólico una sola vez:

sudo ln -s /Applications/JPGBoost.app/Contents/MacOS/jpgboost-cli \
  /usr/local/bin/jpgboost-cli

jpgboost-cli --help

Como el enlace apunta al paquete, sigue siendo válido tras una actualización de la aplicación. Los ejemplos de esta página suponen esta instalación; sin ella, sustituye jpgboost-cli por la ruta completa anterior.

Licencia en un servidor

Una máquina que ejecuta solo la CLI, por ejemplo un servidor sin interfaz gráfica, puede activarse y gestionarse sin usar JPGBoost.app.

# Identificador de esta máquina, desde la CLI
jpgboost-cli --machine-id

# Primera activación, con el token recibido por correo tras la compra
jpgboost-cli --activate ACT-XXXX-XXXX-XXXX-XXXX-XXXX

# Desde este servidor ya activado, generar un código para añadir otro dispositivo
jpgboost-cli --add-device

# Unirse a una licencia mediante un código generado en otro lugar (app u otra CLI)
jpgboost-cli --pair XXXX-XXXX

# Obtener una versión más reciente de la licencia si el servidor tiene una
jpgboost-cli --sync

# Número de instalaciones usadas / límite, y su lista — lectura local, sin llamada de red
jpgboost-cli --devices

Sintaxis y opciones

jpgboost-cli <archivo...> --output <carpeta> [opciones]

Primeros ejemplos

# Dos archivos a WebP, calidad 60
jpgboost-cli foto1.jpg foto2.png --quality 60 --format webp --output ./comprimidas
# foto1.jpg: 4,2 MB -> 890 KB (-79%) -> ./comprimidas/foto1.webp
# foto2.png: 1,8 MB -> 620 KB (-66%) -> ./comprimidas/foto2.webp
#
# 2 archivo(s) procesado(s), 0 error(es).

# Una carpeta completa a AVIF
jpgboost-cli ~/Imagenes/exportar/*.png --format avif --quality 65 --output ~/Imagenes/web

Procesamiento por lotes y paralelismo

Para cientos o miles de archivos, la opción --jobs procesa varias imágenes a la vez. Cada archivo se decodifica, se codifica y se libera de forma independiente: el consumo de memoria no crece con el número de archivos pendientes, solo con el valor de --jobs.

# Ocho archivos procesados simultáneamente
jpgboost-cli ~/Fotos/lote/*.jpg --jobs 8 --format webp --output ~/Fotos/web

# Uno a la vez, para limitar la carga en una máquina compartida
jpgboost-cli ~/Fotos/lote/*.jpg --jobs 1 --format webp --output ~/Fotos/web

Usar un perfil de exportación

La opción --profile reutiliza un perfil creado en la aplicación o mediante la API. Solo completa lo que no hayas indicado explícitamente.

# El formato, la calidad y la carpeta vienen todos del perfil
jpgboost-cli --profile "Web JPEG" *.png

# La carpeta explícita prevalece, el resto viene del perfil
jpgboost-cli --profile "Web JPEG" --output ./entrega *.png

La CLI también puede crear o actualizar un perfil directamente, sin pasar por Ajustes ni por la API local:

jpgboost-cli --create-profile "Web JPEG" --format jpeg --quality 70 --output ./comprimidas

--format y --quality son obligatorios, --output es opcional (la carpeta indicada debe existir ya). Un nombre ya usado sobrescribe el perfil existente en lugar de crear un duplicado, el mismo comportamiento que la pestaña Perfiles de la app y que la API local. Requiere JPGBoost Pro, como el resto de la CLI.

Salida JSON

Con --json, la salida es un array JSON en el que cada archivo procesado corresponde a un objeto JSON, con la misma forma que las respuestas de la API local, lo que facilita el encadenamiento con jq o cualquier otra herramienta.

jpgboost-cli *.png --format webp --output ./salida --json

# Encadenar con jq: quedarse solo con los archivos con error
jpgboost-cli *.png --format webp --output ./salida --json \
  | jq '.[] | select(.error != null)'

Campos disponibles: path, originalSizeBytes, compressedSizeBytes, ratio, destination y error.

Códigos de salida

Archivos con el mismo nombre

Dos archivos de entrada con el mismo nombre base apuntan de forma natural a la misma salida. a/foto.jpg y b/foto.png convertidos a WebP producirían ambos foto.webp.

JPGBoost no los sobrescribe: el segundo recibe un nombre distinto.

a/foto.jpg  ->  foto.webp
b/foto.png  ->  foto-2.webp

Los nombres se asignan en el orden de los argumentos, con independencia del orden de ejecución con --jobs, por lo que el resultado es reproducible. La misma regla se aplica en la aplicación, los Atajos, AppleScript y las carpetas supervisadas.

Comprobar la instalación

Comprueba en cualquier momento que el comando responde correctamente:

jpgboost-cli --help