Profili di esportazione

Un profilo di esportazione raggruppa, sotto un unico nome, un formato di file, un livello di qualità e una cartella di destinazione.

È la base comune di tutte le automazioni di JPGBoost. Configura un profilo una sola volta, poi puoi riutilizzarlo ovunque sia necessaria un'esportazione.

Incluso in Free

Questa funzione è disponibile sia in JPGBoost Free sia in Pro, con un limite: JPGBoost Free consente un solo profilo. Modificarlo, rinominarlo o sovrascriverlo resta sempre possibile; viene rifiutata soltanto la creazione di un secondo profilo. Ciò che il profilo comanda, invece, resta soggetto alla quota Free: 50 immagini al giorno e 5 MB per file. JPGBoost Pro rimuove tutti questi limiti.

A cosa serve un profilo

Un profilo di esportazione ha un nome e memorizza tre informazioni:

  • un formato di output (PNG, JPEG, HEIC, AVIF, WebP o JPEG XL);
  • una qualità da 1 a 100;
  • una cartella di destinazione, opzionale.

Una volta creato, questo profilo è riconosciuto dall'applicazione, dalla riga di comando, dall'API locale, dai Comandi Rapidi e dalle cartelle monitorate. Così non devi più ripetere le stesse impostazioni in ogni script.

Creare un profilo

  1. Apri Impostazioni (⌘,), poi la scheda Profili.
  2. Crea un nuovo profilo e assegnagli un nome chiaro, ad esempio Web JPEG o Consegna cliente.
  3. Scegli il formato di output e la qualità.
  4. Se lo desideri, seleziona una cartella di destinazione con il selettore nativo.
  5. Salva. Il profilo è immediatamente disponibile ovunque.
Creare un profilo senza aprire l'applicazione

Su un server o in uno script di installazione, la CLI può creare o aggiornare un profilo direttamente: jpgboost-cli --create-profile "Web JPEG" --format jpeg --quality 70 --output ./compresse. Un nome già usato sostituisce il profilo esistente, esattamente come nell'applicazione.

Un profilo con destinazione è più di una comodità

Definire una cartella di destinazione nel profilo è l'unico modo affidabile per fissare una cartella di output nell'app Comandi Rapidi. Consulta la guida Comandi Rapidi e AppleScript.

Applicare un profilo nell'applicazione

La barra degli strumenti della finestra principale offre un menu dei profili. Applica il formato e la qualità del profilo al gruppo attuale, e mostra sempre il nome del profilo applicato.

Riutilizzare un profilo altrove

Lo stesso profilo può essere richiamato per nome da ogni punto di ingresso:

Punto di ingressoCome richiamarlo
ApplicazioneMenu dei profili della barra degli strumenti
Riga di comando--profile "Web JPEG"
API localeCampo profile di /v1/settings e /v1/export
Comandi RapidiParametro Export Profile dell'azione
AppleScriptParametro profile "Web JPEG"
Cartelle monitorateProfilo selezionato nella configurazione della cartella

Regola di priorità

Un profilo di esportazione completa solo le impostazioni mancanti. Qualsiasi valore definito esplicitamente ha priorità su quello del profilo. Questa regola si applica in tutto JPGBoost.

# Il profilo fornisce il formato, la qualità e la cartella
jpgboost-cli --profile "Web JPEG" *.png

# Qui, --output prevale sulla cartella del profilo
# (il formato e la qualità del profilo continuano ad applicarsi)
jpgboost-cli --profile "Web JPEG" --output ./altra-cartella *.png

Per le cartelle monitorate, la regola è leggermente diversa: la cartella di destinazione configurata nella cartella monitorata prevale sempre su quella del profilo.

Profilo predefinito

Solo un profilo alla volta può essere contrassegnato come predefinito, da Impostazioni → Profili. È quello che JPGBoost applica quando non viene indicato alcun profilo, una situazione diversa dalla regola di priorità precedente, che presuppone che un profilo sia già stato indicato esplicitamente.

Questo meccanismo serve soprattutto l'azione «Comprimi immagini» di Spotlight invocata con la sua frase generica, senza alcun comando costruito a mano. Quell'invocazione diretta non porta alcun parametro oltre ai file selezionati, e quindi si affida interamente al profilo predefinito per il formato, la qualità e la cartella di destinazione. Consulta la guida Comandi Rapidi e AppleScript per il percorso completo.

Lo stesso meccanismo avvantaggia la riga di comando senza --profile, AppleScript senza un parametro profile, e una cartella monitorata priva di un profilo dedicato.

Impostabile solo dall'applicazione

Il contrassegno predefinito si imposta in Impostazioni → Profili, mai tramite l'API locale né tramite la CLI. Creare o aggiornare un profilo tramite POST /v1/profiles o jpgboost-cli --create-profile conserva il suo stato predefinito esistente così com'è, senza mai reimpostarlo.

Dove vengono salvati i profili

I profili sono salvati in un unico file, condiviso dall'applicazione, dalla CLI e dall'API:

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

È proprio questa condivisione che permette a un profilo creato nell'interfaccia di essere immediatamente disponibile in uno script, e viceversa.

Esempio completo

Obiettivo: consegnare ogni settimana immagini ottimizzate per il web, sempre nella stessa cartella e con le stesse impostazioni.

  1. Crea il profilo Web JPEG: formato JPEG, qualità 70, destinazione ~/Sites/media.
  2. Nell'applicazione, applicalo a un gruppo dalla barra degli strumenti per verificare visivamente il risultato.
  3. Una volta soddisfatto, richiamalo da uno script senza dover ripetere le impostazioni.
# Riga di comando: niente da ripetere, tutto viene dal profilo
jpgboost-cli --profile "Web JPEG" ~/Immagini/settimana-12/*.png

# API locale: applicare il profilo, poi esportare nella tua cartella
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