명령줄(jpgboost-cli)

jpgboost-cli는 그래픽 인터페이스를 열지 않고도 이미지를 압축합니다. 스크립트, 예약 작업, 지속적 통합에 적합한 도구입니다.

명령줄의 용도

jpgboost-cli는 JPGBoost.app에 포함된 독립적인 실행 파일입니다. 로컬 API에도, 실행 중인 앱 인스턴스에도 의존하지 않으며, 동일한 디코딩 및 인코딩 엔진을 직접 사용하므로 그래픽 인터페이스와 정확히 동일한 파일을 만들어냅니다.

인터페이스를 전혀 열고 싶지 않은 경우에 적합한 진입점입니다. 셸 스크립트, 예약 작업, 지속적 통합, 대량 파일 처리 등에 유용합니다.

명령어를 접근 가능하게 만들기

바이너리는 앱 패키지 안에 있습니다. 전체 경로를 사용해 직접 호출할 수 있습니다:

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

어떤 폴더에서든 jpgboost-cli를 실행할 수 있도록, 한 번만 심볼릭 링크를 만드세요:

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

jpgboost-cli --help

이 링크는 패키지를 가리키므로 앱을 업데이트한 후에도 유효합니다. 이 페이지의 예시는 이러한 설치를 전제로 합니다. 설치하지 않았다면 jpgboost-cli 대신 위의 전체 경로를 사용하세요.

서버에서의 라이선스

그래픽 인터페이스가 없는 서버처럼 CLI만 실행하는 머신은 JPGBoost.app을 사용하지 않고도 활성화 및 관리할 수 있습니다.

# CLI에서 이 기기의 식별자 확인
jpgboost-cli --machine-id

# 구매 후 이메일로 받은 토큰으로 첫 활성화
jpgboost-cli --activate ACT-XXXX-XXXX-XXXX-XXXX-XXXX

# 이미 활성화된 이 서버에서 다른 기기를 추가하기 위한 코드 생성
jpgboost-cli --add-device

# 다른 곳(앱 또는 다른 CLI)에서 생성한 코드로 라이선스에 참여하기
jpgboost-cli --pair XXXX-XXXX

# 서버에 더 최신 버전의 라이선스가 있으면 가져오기
jpgboost-cli --sync

# 사용 중인 설치 수/한도, 그 목록 — 네트워크 호출 없는 로컬 읽기
jpgboost-cli --devices

문법과 옵션

jpgboost-cli <file...> --output <folder> [options]

첫 번째 예시

# 두 파일을 WebP, 화질 60으로 변환
jpgboost-cli foto1.jpg foto2.png --quality 60 --format webp --output ./compressed
# foto1.jpg: 4.2 MB -> 890 KB (-79%) -> ./compressed/foto1.webp
# foto2.png: 1.8 MB -> 620 KB (-66%) -> ./compressed/foto2.webp
#
# 2개의 파일 처리됨, 실패 0개.

# 폴더 전체를 AVIF로 변환
jpgboost-cli ~/Pictures/export/*.png --format avif --quality 65 --output ~/Pictures/web

일괄 처리 및 병렬화

수백에서 수천 개의 파일을 다룰 때는 --jobs 옵션으로 여러 이미지를 동시에 처리할 수 있습니다. 각 파일은 독립적으로 디코딩되고 인코딩된 후 해제되므로, 메모리 사용량은 대기 중인 파일 수가 아니라 --jobs 값에 따라서만 증가합니다.

# 8개의 파일을 동시에 처리
jpgboost-cli ~/Photos/batch/*.jpg --jobs 8 --format webp --output ~/Photos/web

# 공유 머신의 부하를 줄이기 위해 하나씩 처리
jpgboost-cli ~/Photos/batch/*.jpg --jobs 1 --format webp --output ~/Photos/web

내보내기 프로필 사용하기

--profile 옵션은 앱이나 API를 통해 만든 프로필을 다시 사용합니다. 명시적으로 지정하지 않은 부분만 보완합니다.

# 포맷, 화질, 폴더가 모두 프로필에서 옵니다
jpgboost-cli --profile "Web JPEG" *.png

# 명시적인 폴더가 우선하고 나머지는 프로필에서 옵니다
jpgboost-cli --profile "Web JPEG" --output ./de/livery *.png

CLI는 설정이나 로컬 API를 거치지 않고도 프로필을 직접 만들거나 업데이트할 수 있습니다:

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

--format과 --quality는 필수이며, --output은 선택 사항입니다(지정한 폴더는 이미 존재해야 합니다). 이미 사용 중인 이름은 앱의 프로필 탭과 로컬 API에서와 마찬가지로, 복제본을 만드는 대신 기존 프로필을 대체합니다. CLI의 다른 기능과 마찬가지로 JPGBoost Pro가 필요합니다.

JSON 출력

--json을 사용하면 출력은 처리된 각 파일이 JSON 객체에 대응하는 JSON 배열이 되며, 로컬 API의 응답과 동일한 형식이므로 jq나 다른 도구와 연결하기 쉽습니다.

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

# jq와 연결하기: 오류가 있는 파일만 남기기
jpgboost-cli *.png --format webp --output ./output --json \
  | jq '.[] | select(.error != null)'

사용 가능한 필드: path, originalSizeBytes, compressedSizeBytes, ratio, destination, error.

종료 코드

동일한 이름의 파일

기본 이름이 같은 두 입력 파일은 자연스럽게 같은 출력을 가리키게 됩니다. a/foto.jpg와 b/foto.png를 WebP로 변환하면 둘 다 foto.webp가 됩니다.

JPGBoost는 이를 덮어쓰지 않습니다. 두 번째 파일에는 별도의 이름이 부여됩니다.

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

이름은 --jobs에 따른 실행 순서와 관계없이 인수의 순서대로 지정되므로 결과는 재현 가능합니다. 동일한 규칙이 앱, 단축어, AppleScript, 감시 폴더에도 적용됩니다.

설치 확인하기

언제든지 명령어가 제대로 응답하는지 확인할 수 있습니다:

jpgboost-cli --help