Free and Pro Licence
JPGBoost Free gives you every feature that runs with the app open, automation included, though simply capped. Only the command-line tool, which runs without the app, requires a Pro licence. Here is how the two tiers work, how to activate a licence and how to manage your devices over time.
Free and Pro at a glance
JPGBoost doesn't rely on any user account. Activating a licence and adding a device happen online, but every check below, run each time the app launches, stays entirely local and requires no network request.
| Feature | Free | Pro |
|---|---|---|
| Import and export in all 6 formats | Yes | Yes |
| Global and per-image quality | Yes | Yes |
| Before/after preview and comparator | Yes | Yes |
| Individual and batch export | Yes | Yes |
| Export history and undo | Yes | Yes |
| Update check | Yes | Yes |
| Maximum file size | 5 MB | Unlimited |
| Images compressed per day | 50 | Unlimited |
| Export profiles | 1 profile | Unlimited |
| Local API | Yes, within the quota | Yes |
| Command line | No | Yes |
| Shortcuts and AppleScript | Yes, within the quota | Yes |
| Watched folders | 1 folder, within the quota | Unlimited |
Limits of the Free version
The free version gives you every compression, conversion and automation feature that runs with the app open. Two compression limits apply:
- 5 MB per file. Size is checked before decoding: a heavier file is flagged in the list without being processed.
- 50 images compressed per day. The quota resets at midnight, local calendar day.
The day's counter is visible at any time in Settings (⌘,) → Licence.
A third limit, separate from the two above, applies to export profiles. JPGBoost Free allows a single one. A profile compresses nothing by itself. It is a named configuration, and editing it, renaming it or overwriting it stays possible at all times, and only creating a second profile is refused. JPGBoost Pro has no such limit.
A fourth limit, also separate from the ones above, applies to watched folders. JPGBoost Free allows saving a single one. Editing or disabling it stays possible at all times, and only creating a second watched folder is refused. JPGBoost Pro has no such limit.
Security and bug fixes are free and available for an unlimited time on both tiers. New features, on the other hand, are reserved for Pro licences. A Pro licence never needs to be renewed or repurchased to keep benefiting from them. Learn more in the Update Check guide.
Activating a Pro licence
After purchase, you receive a single-use activation token by email, in the form ACT-XXXX-XXXX-XXXX-XXXX-XXXX.
- Open JPGBoost, then Settings with ⌘, (or the JPGBoost → Settings menu).
- Select the Licence tab, then Activate My Licence.
- Simply paste the token you received by email. The app automatically retrieves this machine's identifier and links it to the token during activation. There's nothing else to copy.
- The displayed tier switches to Pro immediately, and the token is permanently consumed.
The tier change applies immediately. Already-configured watched folders resume watching and the local API server starts as soon as activation completes, with no need to quit the app or toggle a setting.
One licence per user
The JPGBoost Pro licence is personal: it is assigned to a single user and lets them use JPGBoost on up to two installations they use personally.
The number of installations allowed doesn't correspond to the number of Macs used, but to the number of installed instances. The graphical app (user interface) and the command-line tool (CLI) are considered two distinct installations, even when used on the same Mac.
In the app's Licence tab, these two slots are shown as Devices (1/2), indicating how many installations are currently associated with the licence, out of the two allowed.
These two slots can be split up freely, for example:
- the app on your Mac and the CLI on a server you use for your own automations (continuous integration, a scheduled task);
- the app and the CLI on a single Mac, laptop or desktop;
- the app on two different Macs, for example a laptop and a desktop;
- the CLI alone, on a server that never opens the app (see Licence on a server).
An additional licence becomes necessary as soon as you go beyond these two installations, or one of them moves outside this strictly personal use:
- a machine or server shared between several people;
- a colleague's Mac or server, who needs their own licence.
Adding a device
Every device you add to your licence is authorised online, in seconds, without going through email again:
- On a device already activated, open Settings → Licence → Add a Device. A temporary pairing code is displayed (valid for 10 minutes, single use).
- On the new device, open Settings → Licence, choose I Already Have a Licence, and enter this code.
- The app reads this new machine's identifier, sends it along with the code, and the tier switches to Pro as soon as it's validated.
The Licence tab lists your devices, numbered, with a counter (Devices (1/2)). Once the limit is reached, Add a Device disappears until a slot frees up (see "Removing a device" below).
On a server with no graphical interface, the same operation is done with jpgboost-cli --pair <code> or --add-device. See Licence on a server.
The exact scope of the licence is set out in the terms of sale.
Removing a device
JPGBoost licences are perpetual. To free up a slot and cover another Mac, remove an existing device from the list (Settings → Licence, Remove button next to the device). The last remaining device cannot be removed.
The removed Mac drops back to Free locally, but no data is deleted: export profiles, watched folders, and export history stay intact and reappear if that device rejoins the licence (via a pairing code generated from one of the remaining devices).
Long-running Pro services stop immediately on the removed device: folder watching stops and the local API server shuts down, with no need to quit the app.
Only a device currently on the licence can manage it. On a removed Mac the device list stays visible, but the Remove and Add a device buttons no longer appear: the server refuses any management request from a device that is no longer authorised, even one still holding a validly signed licence. To bring that Mac back, generate a pairing code from one of the remaining devices.
Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| The activation token is rejected | Incomplete or already-used token, or altered by copy-paste | Copy the entire token again from the purchase email, with no space or line break |
| The pairing code is rejected on the new Mac | Expired code (10-minute validity) or already used | Generate a new code from Add a Device on an already-activated Mac |
| "Add a Device" has disappeared | The 2-device limit has been reached | Remove a device from the list to free up a slot |
jpgboost-cli exits with code 77 | No active Pro licence for this machine | Activate or add this device in the app, then rerun the command |
| The local API returns a quota error | JPGBoost Free's daily limit has been reached (50 images) | Wait for the reset at midnight, or upgrade to JPGBoost Pro to remove the limit |
| A watched folder leaves files pending | JPGBoost Free's daily quota has been reached, but the remaining files are not lost | They are processed automatically the next day, or straight away once a Pro licence is activated |
| A removed Mac no longer offers Remove or Add a device | Only devices currently on the licence can manage it | Do it from one of the remaining devices, or bring this Mac back with a pairing code generated from one of them |
Since there is no JPGBoost account, there's no automatic recovery portal. As long as one of your devices stays activated, others can be added freely with a pairing code. If you lose access to all your devices at once, contact us with the address used at purchase to get a new activation token.