書き出しプロファイル
書き出しプロファイルは、ファイルフォーマット、品質レベル、書き出し先フォルダを1つの名前にまとめたものです。
これはJPGBoostのあらゆる自動化機能の共通基盤です。一度プロファイルを設定すれば、書き出しが必要なあらゆる場所で再利用できます。
この機能はJPGBoost FreeでもProでもご利用いただけますが、1点だけ制限があります。Freeで保持できるプロファイルは1つだけです。編集・名前の変更・同名での上書きはいつでも可能で、拒否されるのは2つ目の新規作成だけです。一方、プロファイルが実行する処理は引き続きFreeの上限(1日50枚、1ファイル5 MB)に加算されます。JPGBoost Proはこれらの制限をすべて解除します。
プロファイルの用途
書き出しプロファイルには名前があり、3つの情報を保存します：
- 出力フォーマット(PNG、JPEG、HEIC、AVIF、WebP、JPEG XLのいずれか);
- 1から100の品質;
- 書き出し先フォルダ(任意)。
一度作成すると、このプロファイルはアプリ、コマンドライン、ローカルAPI、ショートカット、監視フォルダのすべてで認識されます。これにより、スクリプトごとに同じ設定を繰り返す必要がなくなります。
プロファイルの作成
- 設定(⌘,)を開き、プロファイルタブを選びます。
- 新しいプロファイルを作成し、Web JPEGやクライアント納品のようなわかりやすい名前を付けます。
- 出力フォーマットと品質を選びます。
- 必要に応じて、ネイティブのセレクターから書き出し先フォルダを選びます。
- 保存します。プロファイルはすぐにあらゆる場所で利用可能になります。
サーバーやインストールスクリプト上では、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監視フォルダの場合、ルールは少し異なります。監視フォルダで設定された書き出し先は、常にプロファイルの書き出し先より優先されます。
デフォルトプロファイル
一度にデフォルトとしてマークできるプロファイルは1つだけで、設定 → プロファイルから指定します。これは、プロファイルが一切名前で指定されなかったときにJPGBoostが適用するプロファイルであり、すでに明示的にプロファイルが指定されていることを前提とする上記の優先順位のルールとは異なる状況です。
この仕組みは特に、手作業で作成したショートカットなしで起動フレーズから呼び出されるSpotlightの「画像を圧縮」アクションに役立ちます。この生の呼び出しは選択されたファイル以外のパラメータを一切持たないため、フォーマット、品質、書き出し先フォルダのすべてをデフォルトプロファイルに委ねます。全体の流れについてはショートカットとAppleScriptガイドを参照してください。
同じ仕組みは、--profileを指定しないコマンドライン、profileパラメータを指定しないAppleScript、専用のプロファイルを持たない監視フォルダにも役立ちます。
デフォルトのフラグは設定 → プロファイルで設定され、ローカルAPIやCLIから設定されることは決してありません。POST /v1/profilesやjpgboost-cli --create-profileでプロファイルを作成または更新しても、既存のデフォルト状態はそのまま保持され、リセットされることは決してありません。
プロファイルの保存場所
プロファイルは、アプリ、CLI、APIで共有される単一のファイルに保存されます：
~/Library/Application Support/JPGBoost/exportProfiles.jsonこの共有により、インターフェースで作成したプロファイルがスクリプトから即座に利用でき、その逆も同様です。
具体例
目標：毎週、常に同じフォルダに同じ設定でウェブ向けに最適化された画像を納品する。
- Web JPEGプロファイルを作成：フォーマットJPEG、品質70、書き出し先
~/Pictures/media。 - アプリでツールバーからグループに適用し、結果を目視で確認する。
- 満足したら、設定を繰り返すことなくスクリプトから呼び出す。
# コマンドライン：繰り返す必要はなく、すべてプロファイルから来る
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