내보내기 프로필

내보내기 프로필은 파일 포맷, 화질 수준, 대상 폴더를 하나의 이름 아래 묶어줍니다.

이는 JPGBoost의 모든 자동화 기능이 공유하는 기본 토대입니다. 프로필을 한 번 설정하면, 내보내기가 필요한 어디서든 다시 사용할 수 있습니다.

Free에 포함

이 기능은 JPGBoost Free와 Pro 모두에서 사용할 수 있지만 한 가지 제한이 있습니다. Free에서는 프로필을 1개만 보유할 수 있습니다. 수정, 이름 변경, 같은 이름으로 덮어쓰기는 언제든 가능하며 두 번째 프로필을 새로 만드는 것만 거부됩니다. 반면 프로필이 실행하는 작업은 Free 한도(하루 50장, 파일당 5 MB)에 계속 포함됩니다. JPGBoost Pro는 이 제한을 모두 없앨니다.

프로필의 용도

내보내기 프로필에는 이름이 있으며, 다음 세 가지 정보를 저장합니다:

  • 출력 포맷(PNG, JPEG, HEIC, AVIF, WebP, JPEG XL 중 하나);
  • 1에서 100 사이의 화질;
  • 대상 폴더(선택 사항).

한 번 만들어지면, 이 프로필은 앱, 명령줄, 로컬 API, 단축어, 감시 폴더에서 모두 인식됩니다. 이를 통해 스크립트마다 동일한 설정을 반복할 필요가 없습니다.

프로필 만들기

  1. 설정(⌘,)을 열고 프로필 탭을 선택합니다.
  2. 새 프로필을 만들고 Web JPEG이나 클라이언트 납품처럼 알아보기 쉬운 이름을 붙입니다.
  3. 출력 포맷과 화질을 선택합니다.
  4. 필요하다면 네이티브 선택기로 대상 폴더를 선택합니다.
  5. 저장합니다. 프로필은 즉시 어디서나 사용할 수 있게 됩니다.
JPGBoost 설정 창의 프로필 탭. 이름, 출력 포맷, 화질, 대상 폴더, 기본 프로필 항목과 저장 버튼으로 이루어진 프로필 추가 양식이 표시되어 있다
내보내기 설정 대화상자. 내보내기 환경설정을 구성하고 저장하는 옵션이 있습니다.
앱을 열지 않고 프로필 만들기

서버나 설치 스크립트에서, CLI로 프로필을 직접 만들거나 업데이트할 수 있습니다: jpgboost-cli --create-profile "Web JPEG" --format jpeg --quality 70 --output ./compressed. 이미 사용 중인 이름은 앱에서와 마찬가지로 기존 프로필을 대체합니다.

대상 폴더가 지정된 프로필은 단순한 편의 기능 이상입니다

프로필에 대상 폴더를 지정하는 것은 단축어 앱에서 출력 폴더를 안정적으로 고정하는 유일한 방법입니다. 단축어 및 AppleScript 가이드를 참고하세요.

앱에서 프로필 적용하기

메인 창의 도구 모음에는 프로필 메뉴가 있습니다. 현재 그룹에 프로필의 포맷과 화질을 적용하며, 적용된 프로필의 이름을 항상 표시합니다.

다른 곳에서 프로필 재사용하기

동일한 프로필은 어떤 진입점에서든 이름으로 호출할 수 있습니다:

진입점호출 방법
앱도구 모음의 프로필 메뉴
명령줄--profile "Web JPEG"
로컬 API/v1/settings와 /v1/export의 profile 필드
단축어동작의 Export Profile 매개변수
AppleScript매개변수 profile "Web JPEG"
감시 폴더폴더 설정에서 선택된 프로필

우선순위 규칙

내보내기 프로필은 누락된 설정만 보완합니다. 명시적으로 지정한 값은 항상 프로필의 값보다 우선합니다. 이 규칙은 JPGBoost 전체에 적용됩니다.

# 프로필이 포맷, 화질, 폴더를 제공
jpgboost-cli --profile "Web JPEG" *.png

# 여기서는 --output이 프로필의 폴더보다 우선함
# (프로필의 포맷과 화질은 계속 적용됨)
jpgboost-cli --profile "Web JPEG" --output ./another-folder *.png

감시 폴더의 경우 규칙이 약간 다릅니다. 감시 폴더에 설정된 대상 폴더가 항상 프로필의 대상 폴더보다 우선합니다.

기본 프로필

한 번에 기본으로 표시할 수 있는 프로필은 하나뿐이며, 설정 → 프로필에서 지정합니다. 이는 프로필이 전혀 이름으로 지정되지 않았을 때 JPGBoost가 적용하는 프로필로, 이미 프로필이 명시적으로 지정되어 있다고 전제하는 위의 우선순위 규칙과는 다른 상황입니다.

이 방식은 특히 손수 만든 단축어 없이 일반 문구로 호출되는 Spotlight의 "이미지 압축" 동작에 유용합니다. 이 순수한 호출은 선택된 파일 외에 다른 매개변수를 전혀 전달하지 않으므로, 포맷과 화질, 대상 폴더 모두를 기본 프로필에 전적으로 의존합니다. 전체 과정은 단축어 및 AppleScript 가이드를 참고하세요.

같은 방식은 --profile 없이 사용하는 명령줄, profile 매개변수 없이 사용하는 AppleScript, 전용 프로필이 없는 감시 폴더에도 도움이 됩니다.

앱에서만 설정 가능

기본 플래그는 설정 → 프로필에서만 지정되며, 로컬 API나 CLI를 통해서는 지정되지 않습니다. POST /v1/profiles나 jpgboost-cli --create-profile로 프로필을 만들거나 업데이트해도 기존의 기본 상태는 그대로 유지되며 절대 초기화되지 않습니다.

프로필 저장 위치

프로필은 앱, CLI, API가 공유하는 단일 파일에 저장됩니다:

~/Library/Application Support/JPGBoost/exportProfiles.json

이렇게 공유되기 때문에 인터페이스에서 만든 프로필을 스크립트에서도 즉시 사용할 수 있고, 그 반대도 마찬가지입니다.

전체 예시

목표: 매주 항상 같은 폴더에, 같은 설정으로 웹에 최적화된 이미지를 납품하는 것.

  1. Web JPEG 프로필을 만듭니다: 포맷 JPEG, 화질 70, 대상 ~/Pictures/media.
  2. 앱에서 도구 모음을 통해 이를 그룹에 적용해 결과를 눈으로 확인합니다.
  3. 만족스러우면, 설정을 반복하지 않고 스크립트에서 호출합니다.
# 명령줄: 반복할 필요 없이 모든 것이 프로필에서 옵니다
jpgboost-cli --profile "Web JPEG" ~/Pictures/week-12/*.png

# 로컬 API: 프로필을 적용한 다음 폴더로 내보내기
curl -s -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile": "Web JPEG"}' \
  http://127.0.0.1:51823/v1/export