ショートカットとAppleScript

JPGBoostはmacOSのネイティブ自動化ツールと連携します。ショートカットとSpotlightではネイティブなアクションが利用でき、AppleScriptとAutomatorにはcompressコマンドが公開されています。

自動化の2つの方法

JPGBoostは2つのmacOSネイティブ自動化インターフェースを公開しています。どちらも独立した処理として動作します。ファイルと設定を入力として受け取り、圧縮されたファイルを出力として返し、その時点でアプリのウィンドウに開かれているリストとは無関係です。

• ショートカットアプリとSpotlight向けのApp Intents。
• osascript、スクリプトエディタ、Automator向けのAppleScript。

アプリを開いている必要はない

これが、両方ともアプリがすでに起動していることを必要とするローカルAPIや監視フォルダとの主な違いです。

ショートカットのアクション経由であれ、AppleScriptのcompressコマンド経由であれ、リクエストが届くとmacOSは他のスクリプト対応アプリと同様にJPGBoostを自動的に再起動します。以前にアプリを明示的に終了していたとしても、何もする必要はありません。

「画像を圧縮」アクション

アプリが一度でも開かれると、このアクションはショートカットアプリのJPGBoostカテゴリに自動的に表示されます。設定は一切不要です。

1. ショートカットアプリを開き、ショートカットを作成します。
2. ファイルを選択やフォルダの内容を取得など、ファイルを提供するアクションを追加します。
3. JPGBoostの画像を圧縮アクションを追加します。
4. お好みのパラメータを入力します。空欄のままにした項目は、書き出しプロファイルで補完できます。
5. 必要に応じて、次に別のアクションを連結します。このアクションは圧縮されたファイルを返します。

「Destination Folder」フィールド

このフィールドは、単純なテキストではなく、file://で始まるパス、つまりURL形式の実際のフォルダ参照(例:file:///Users/me/Downloads/)を期待しています。以下の方法はInvalid URLエラーで失敗します：

• 手入力でパスを書く(例:/Users/me/Downloads);
• Finderからフォルダをフィールドにドラッグする(単純なテキストが入るだけになります)。

macOSのショートカットエディタには、別の方法で構築できる「フォルダを選択」のようなネイティブアクションもありません。

ケース1：ショートカットを一切作成しない場合

JPGBoostが一度でも起動されると、アプリ自身が宣言する起動フレーズ(「JPGBoostで画像を圧縮」、「JPGBoostで圧縮」)は、ショートカットアプリを一切開くことなく、Spotlightから直接認識されます。

この生の呼び出しは選択されたファイルのみを渡します。他のパラメータは一切なく、以下の手順を行うまでは「書き出し先フォルダが見つかりません」というエラーになります。

この呼び出しを機能させるには：

1. JPGBoostで設定 → プロファイルを開き、書き出し先フォルダを設定したプロファイルをデフォルトプロファイルとして設定します。
2. Finderで、圧縮する画像を選択します。
3. ⌘Spaceを押してから「画像を圧縮」と入力します。

JPGBoostは、デフォルトプロファイルから不足しているパラメータを自動的に補います。これには書き出し先フォルダ、フォーマット、品質が含まれます。

ショートカットアプリでショートカットを作成する必要はありません。

ケース2：構築したショートカットを使う場合

このケースは、複数の異なる動作をそれぞれ別の名前で使えるようにしたい場合に便利です。たとえば「デスクトップに圧縮」は1つのプロファイルを使い、「アーカイブに圧縮」は別のプロファイルを使う、といった具合です。ケース1のデフォルトプロファイルでは、一度に1つの動作しか扱えません。

1. JPGBoostで設定 → プロファイルを開き、アプリのネイティブセレクターで選んだ書き出し先フォルダを持つプロファイルを作成します。
2. ショートカットアプリで新しいショートカットを作成し、たとえば「デスクトップに圧縮」のような、わかりやすい名前を付けます。
3. ショートカットのJPGBoostアクションでは、使用するプロファイルの名前をExport Profileにのみ入力します。Destination Folderは空欄のままにします：プロファイルに設定されたフォルダが自動的に使用されます。
4. このショートカットは、JPGBoostが宣言する起動フレーズの代わりに、あなたが付けた名前でSpotlightから直接利用できるようになります。

Spotlight

このアクションはSpotlightからもアクセスできます。「JPGBoostで画像を圧縮」のような起動フレーズは、対応する15言語すべてに翻訳されています。

AppleScript

compressコマンドは、他のスクリプト対応アプリと同様に使用します。

tell application "JPGBoost"
    compress {"/path/to/image1.png", "/path/to/image2.jpg"} ¬
        to "/path/to/output" format "webp" quality 80
end tell

to、format、qualityのパラメータは任意です。profileパラメータは、これらを置き換えたり、これらがカバーしていない部分を補完したりでき、コマンドラインの--profileとまったく同じ動作をします。

tell application "JPGBoost"
    compress {"/path/to/image.png"} profile "Web JPEG"
end tell

このコマンドはJSON文字列を返します。各ファイルにつき1つのオブジェクトで、path、originalSizeBytes、compressedSizeBytes、ratio、destination、errorのフィールドを含みます。これはCLIの--json出力やローカルAPIのレスポンスと同じ形式です。

ターミナルから

osascript -e 'tell application "JPGBoost" to compress {"/path/image.png"} profile "Web JPEG"'

Automatorから

AppleScriptを実行アクションを使い、同じtellブロックをそこに貼り付けます。これにより、Finderのコンテキストメニューからアクセスできるサービスを作成できます。

「オートメーション」の許可

トラブルシューティング