Профили экспорта

Профиль экспорта объединяет под одним именем формат файла, уровень качества и папку назначения.

Это общая основа всех автоматизаций JPGBoost. Настройте профиль один раз, затем используйте его повторно везде, где требуется экспорт.

Входит во Free

Эта функция доступна как в JPGBoost Free, так и в Pro, но с одним ограничением: во Free можно создать только один профиль. Изменить, переименовать или перезаписать его можно всегда — отклоняется лишь создание второго профиля. А то, чем управляет профиль, по-прежнему учитывается в лимитах Free: 50 изображений в день и 5 МБ на файл. JPGBoost Pro снимает все эти ограничения.

Для чего нужен профиль

Профиль экспорта имеет имя и хранит три параметра:

  • формат вывода (PNG, JPEG, HEIC, AVIF, WebP или JPEG XL);
  • качество от 1 до 100;
  • папку назначения, опционально.

После создания этот профиль распознаётся приложением, командной строкой, локальным API, Быстрыми командами и отслеживаемыми папками. Так вам больше не нужно повторять одни и те же настройки в каждом скрипте.

Создание профиля

  1. Откройте Настройки (⌘,), затем вкладку Профили.
  2. Создайте новый профиль и дайте ему понятное имя, например Web JPEG или Доставка клиенту.
  3. Выберите формат вывода и качество.
  4. При желании выберите папку назначения с помощью нативного диалога выбора.
  5. Сохраните. Профиль немедленно становится доступен везде.
Создание профиля без открытия приложения

На сервере или в скрипте установки CLI может создать или обновить профиль напрямую: jpgboost-cli --create-profile "Web JPEG" --format jpeg --quality 70 --output ./сжато. Уже используемое имя заменяет существующий профиль, точно так же, как в приложении.

Профиль с назначением — это больше, чем удобство

Определение папки назначения в профиле — единственный надёжный способ задать выходную папку в приложении Быстрые команды. См. руководство Быстрые команды и AppleScript.

Применение профиля в приложении

Панель инструментов главного окна предлагает меню профилей. Оно применяет формат и качество профиля к текущей группе и всегда показывает имя применённого профиля.

Повторное использование профиля в другом месте

Один и тот же профиль можно вызвать по имени из любой точки входа:

Точка входаКак вызвать
ПриложениеМеню профилей на панели инструментов
Командная строка--profile "Web JPEG"
Локальный APIПоле profile в /v1/settings и /v1/export
Быстрые командыПараметр Export Profile действия
AppleScriptПараметр profile "Web JPEG"
Отслеживаемые папкиПрофиль, выбранный в настройках папки

Правило приоритета

Профиль экспорта только дополняет недостающие настройки. Любое явно заданное значение имеет приоритет над значением профиля. Это правило действует во всём JPGBoost.

# Профиль предоставляет формат, качество и папку
jpgboost-cli --profile "Web JPEG" *.png

# Здесь --output имеет приоритет над папкой профиля
# (формат и качество профиля по-прежнему применяются)
jpgboost-cli --profile "Web JPEG" --output ./другая-папка *.png

Для отслеживаемых папок правило немного отличается: папка назначения, настроенная в отслеживаемой папке, всегда имеет приоритет над папкой профиля.

Профиль по умолчанию

Только один профиль одновременно может быть отмечен как используемый по умолчанию, в Настройках → Профили. Это тот профиль, который JPGBoost применяет, когда вообще не указано имя профиля, что отличается от описанного выше правила приоритета, предполагающего, что профиль уже назван явно.

Этот механизм в первую очередь служит действию «Сжать изображения» из Spotlight, вызванному по общей фразе, без созданной вручную команды. Такой прямой вызов не передаёт ни одного параметра сверх выбранных файлов, и поэтому полностью полагается на профиль по умолчанию для формата, качества и папки назначения. См. руководство Быстрые команды и AppleScript для полного описания.

Тот же механизм полезен для командной строки без --profile, для AppleScript без параметра profile, и для отслеживаемой папки без отдельного профиля.

Настраивается только из приложения

Отметка по умолчанию задаётся в Настройках → Профили, никогда через локальный API или CLI. Создание или обновление профиля через POST /v1/profiles или jpgboost-cli --create-profile сохраняет его существующий статус по умолчанию неизменным, никогда его не сбрасывая.

Где хранятся профили

Профили хранятся в едином файле, общем для приложения, CLI и API:

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

Именно это совместное использование позволяет профилю, созданному в интерфейсе, быть немедленно доступным в скрипте, и наоборот.

Полный пример

Цель: каждую неделю доставлять оптимизированные для веба изображения, всегда в одну и ту же папку и с одними и теми же настройками.

  1. Создайте профиль Web JPEG: формат JPEG, качество 70, назначение ~/Изображения/media.
  2. В приложении примените его к группе через панель инструментов, чтобы визуально проверить результат.
  3. Убедившись в результате, вызывайте его из скрипта, не повторяя настройки.
# Командная строка: ничего повторять не нужно, всё берётся из профиля
jpgboost-cli --profile "Web JPEG" ~/Изображения/неделя-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