Shortcuts and AppleScript

JPGBoost integrates with macOS's built-in automation tools. A native action is available in Shortcuts and Spotlight, and a compress command is exposed to AppleScript and Automator.

Two ways to automate

JPGBoost exposes two automation interfaces native to macOS. Both work as standalone processing: they take files and settings as input, return compressed files as output, and are independent of the list currently open in the app's window.

• App Intents for the Shortcuts app and Spotlight.
• AppleScript for osascript, Script Editor, and Automator.

The app doesn't need to be open

This is the main difference from the local API and watched folders, both of which require the app to already be running.

Whether it's a Shortcuts action or the AppleScript compress command, macOS relaunches JPGBoost automatically as soon as a request comes in, just like any other scriptable app. You don't have to do anything, even if you had explicitly quit the app beforehand.

The "Compress Images" action

The action appears automatically in the Shortcuts app, under the JPGBoost category, as soon as the app has been launched once. No setup is needed.

1. Open the Shortcuts app and create a shortcut.
2. Add an action that supplies files, for example Select Files or Get Folder Contents.
3. Add JPGBoost's Compress Images action.
4. Fill in the parameters you want. Any you leave blank can be supplied by an export profile.
5. Chain another action after it if needed: the action returns the compressed files.

The "Destination Folder" field

This field expects a genuine folder reference in URL format, meaning a path starting with file:// (for example file:///Users/me/Downloads/), not plain text. The following methods fail with an Invalid URL error:

• typing a path by hand, for example /Users/me/Downloads;
• dragging a folder from the Finder onto the field, which only drops plain text there.

The macOS Shortcuts editor also offers no native "Choose a Folder" action to build one another way. The good news is that a hand-built shortcut is not required at all. It depends on what you want to trigger.

Case 1: no shortcut to build

Once JPGBoost has been launched at least once, the generic phrase it declares itself ("Compress Images with JPGBoost," "Compress with JPGBoost") is directly recognized by Spotlight, without ever opening the Shortcuts app.

This raw invocation only passes along the selected files. No other parameter is provided, which causes the "Missing destination folder" error until the setup below has been done.

For this invocation to work:

1. In JPGBoost, open Settings → Profiles and set a profile as the default profile, with a destination folder configured.
2. In the Finder, select the images to compress.
3. Press ⌘Space, then type "Compress Images."

JPGBoost then automatically fills in the missing parameters from the default profile, including the destination folder, format, and quality.

No shortcut is needed in the Shortcuts app.

Case 2: with a shortcut built

This case is useful when several behaviors need to be available under distinct names. For example, "Compress to Desktop" can use one profile, while "Compress to Archive" uses another. The default profile from case 1 only handles one behavior at a time.

1. In JPGBoost, open Settings → Profiles and create a profile with a destination folder, selected with the app's native picker.
2. In the Shortcuts app, create a new shortcut and give it a clear name, for example "Compress to Desktop."
3. In the shortcut's JPGBoost action, fill in only Export Profile with the name of the profile to use. Leave Destination Folder blank: the folder set in the profile will be used automatically.
4. The shortcut is then directly available in Spotlight under the name you gave it, instead of the generic phrase JPGBoost declares.

Spotlight

The action is also accessible from Spotlight. Trigger phrases, such as "Compress images with JPGBoost," are translated into the fifteen supported languages.

AppleScript

The compress command is used just like that of any other scriptable app.

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

The to, format, and quality parameters are optional. The profile parameter can replace them, or fill in whatever they don't cover, exactly like --profile on the command line.

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

The command returns a JSON string: one object per file, with the fields path, originalSizeBytes, compressedSizeBytes, ratio, destination, and error. It's the same shape as the CLI's --json output and the local API's responses.

From the Terminal

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

From Automator

Use the Run AppleScript action and paste in the same tell block. This lets you build a service accessible from the Finder's contextual menu.

"Automation" permission

Troubleshooting