Profils d'export

Un profil d'export regroupe, sous un même nom, un format de fichier, un niveau de qualité et un dossier de destination.

Il constitue la base commune de toutes les automatisations de JPGBoost. Vous configurez un profil une seule fois, puis vous pouvez le réutiliser partout où un export est nécessaire.

Inclus dans Free

Cette fonction est disponible sur JPGBoost Free comme sur JPGBoost Pro, avec une limite : JPGBoost Free n'autorise qu'un seul profil. Le modifier, le renommer ou l'écraser reste toujours possible ; seule la création d'un second profil est refusée. Ce que le profil pilote, lui, reste plafonné par le quota Free : 50 images par jour et 5 Mo par fichier. JPGBoost Pro lève toutes ces limites.

À quoi sert un profil

Un profil d'export porte un nom et retient trois informations :

  • un format de sortie (PNG, JPEG, HEIC, AVIF, WebP ou JPEG XL) ;
  • une qualité de 1 à 100 ;
  • un dossier de destination, facultatif.

Une fois créé, ce profil est reconnu par l'application, la ligne de commande, l'API locale, les Raccourcis et les dossiers surveillés. Vous cessez ainsi de répéter les mêmes réglages dans chaque script.

Créer un profil

  1. Ouvrez Réglages (⌘,) puis l'onglet Profils.
  2. Créez un nouveau profil et donnez-lui un nom explicite, par exemple Web JPEG ou Livraison client.
  3. Choisissez le format de sortie et la qualité.
  4. Si vous le souhaitez, sélectionnez un dossier de destination à l'aide du sélecteur natif.
  5. Enregistrez. Le profil est immédiatement disponible partout.
Créer un profil sans ouvrir l'app

Sur un serveur ou dans un script d'installation, la CLI crée ou met à jour un profil directement : jpgboost-cli --create-profile "Web JPEG" --format jpeg --quality 70 --output ./compresse. Un nom déjà utilisé écrase le profil existant, comme dans l'app.

Un profil avec destination est plus qu'un confort

Renseigner un dossier de destination dans le profil est la seule méthode fiable pour fixer un dossier de sortie dans l'app Raccourcis. Voir le guide Raccourcis et AppleScript.

Appliquer un profil dans l'application

La barre d'outils de la fenêtre principale propose un menu de profils. Il applique le format et la qualité du profil au lot en cours, et affiche en permanence le nom du profil actuellement appliqué.

Réutiliser un profil ailleurs

Le même profil s'invoque par son nom depuis chacun des points d'entrée :

Point d'entréeComment l'appeler
ApplicationMenu de profils de la barre d'outils
Ligne de commande--profile "Web JPEG"
API localeChamp profile de /v1/settings et /v1/export
RaccourcisParamètre Export Profile de l'action
AppleScriptParamètre profile "Web JPEG"
Dossiers surveillésProfil sélectionné dans la configuration du dossier

Règle de priorité

Un profil d'export complète uniquement les paramètres manquants. Toute valeur définie explicitement est prioritaire sur celle du profil. Cette règle s'applique partout dans JPGBoost.

# Le profil fournit le format, la qualité et le dossier
jpgboost-cli --profile "Web JPEG" *.png

# Ici, --output l'emporte sur le dossier du profil
# (le format et la qualité du profil restent appliqués)
jpgboost-cli --profile "Web JPEG" --output ./ailleurs *.png

Pour les dossiers surveillés, la règle est légèrement différente : le dossier de destination configuré sur le dossier surveillé l'emporte toujours sur celui du profil.

Profil par défaut

Un seul profil à la fois peut être marqué par défaut, dans Réglages → Profils. C'est celui que JPGBoost applique quand aucun profil n'est nommé du tout, une situation différente de la règle de priorité ci-dessus, qui suppose qu'un profil est déjà désigné par son nom.

Ce mécanisme sert notamment à l'action Spotlight « Compresser des images » invoquée par sa phrase générique, sans raccourci construit à la main. Cette invocation brute ne transmet aucun paramètre au-delà des fichiers sélectionnés, et retombe donc entièrement sur le profil par défaut pour son format, sa qualité et son dossier de destination. Voir le guide Raccourcis et AppleScript pour la marche à suivre complète.

Le même mécanisme profite à la ligne de commande sans --profile, à AppleScript sans paramètre profile, et à un dossier surveillé sans profil dédié.

Réglable uniquement depuis l'application

Le marquage par défaut se règle dans Réglages → Profils, jamais par l'API locale ni par la CLI. Créer ou mettre à jour un profil via POST /v1/profiles ou jpgboost-cli --create-profile préserve son statut par défaut existant tel quel, sans jamais le réinitialiser.

Où sont stockés les profils

Les profils sont enregistrés dans un fichier unique, partagé par l'application, la CLI et l'API :

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

C'est ce partage qui permet à un profil créé dans l'interface d'être immédiatement utilisable dans un script, et inversement.

Exemple complet

Objectif : livrer chaque semaine des visuels optimisés pour le web, toujours dans le même dossier et avec les mêmes réglages.

  1. Créez le profil Web JPEG : format JPEG, qualité 70, destination ~/Sites/medias.
  2. Dans l'application, appliquez-le au lot depuis la barre d'outils pour vérifier visuellement le rendu.
  3. Une fois satisfait, appelez-le depuis un script sans avoir à répéter les réglages.
# Ligne de commande : rien à répéter, tout vient du profil
jpgboost-cli --profile "Web JPEG" ~/Images/semaine-12/*.png

# API locale : appliquer le profil puis exporter vers son dossier
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