Exportprofile

Ein Exportprofil fasst unter einem einzigen Namen ein Dateiformat, eine Qualitätsstufe und einen Zielordner zusammen.

Es ist die gemeinsame Grundlage aller Automatisierungen von JPGBoost. Konfiguriere ein Profil einmal, dann kannst du es überall dort wiederverwenden, wo ein Export benötigt wird.

Wozu ein Profil dient

Ein Exportprofil hat einen Namen und speichert drei Informationen:

• ein Ausgabeformat (PNG, JPEG, HEIC, AVIF, WebP oder JPEG XL);
• eine Qualität von 1 bis 100;
• einen Zielordner, optional.

Einmal erstellt, wird dieses Profil von der Anwendung, der Kommandozeile, der lokalen API, den Kurzbefehlen und den überwachten Ordnern erkannt. So musst du dieselben Einstellungen nicht mehr in jedem Skript wiederholen.

Ein Profil erstellen

1. Öffne Einstellungen (⌘,), dann den Reiter Profile.
2. Erstelle ein neues Profil und gib ihm einen klaren Namen, zum Beispiel Web JPEG oder Kundenlieferung.
3. Wähle das Ausgabeformat und die Qualität.
4. Wähle bei Bedarf einen Zielordner über den nativen Auswähler.
5. Speichere. Das Profil ist sofort überall verfügbar.

Ein Profil in der Anwendung anwenden

Die Symbolleiste des Hauptfensters bietet ein Profilmenü. Es wendet das Format und die Qualität des Profils auf die aktuelle Gruppe an und zeigt immer den Namen des angewendeten Profils an.

Ein Profil anderswo wiederverwenden

Dasselbe Profil kann von jedem Einstiegspunkt aus namentlich aufgerufen werden:

Prioritätsregel

Ein Exportprofil ergänzt nur die fehlenden Einstellungen. Jeder explizit gesetzte Wert hat Vorrang vor dem des Profils. Diese Regel gilt in ganz JPGBoost.

# Das Profil liefert Format, Qualität und Ordner
jpgboost-cli --profile "Web JPEG" *.png

# Hier hat --output Vorrang vor dem Ordner des Profils
# (Format und Qualität des Profils gelten weiterhin)
jpgboost-cli --profile "Web JPEG" --output ./anderer-ordner *.png

Bei überwachten Ordnern ist die Regel leicht anders: Der im überwachten Ordner konfigurierte Zielordner hat immer Vorrang vor dem des Profils.

Standardprofil

Nur ein einziges Profil kann jeweils als Standard markiert werden, in Einstellungen → Profile. Es ist dasjenige, das JPGBoost anwendet, wenn überhaupt kein Profil benannt ist, eine andere Situation als die Prioritätsregel oben, die voraussetzt, dass bereits ausdrücklich ein Profil benannt ist.

Dieser Mechanismus dient insbesondere der Aktion „Bilder komprimieren" von Spotlight, aufgerufen über ihre generische Phrase, ohne von Hand erstellten Kurzbefehl. Dieser unmittelbare Aufruf übergibt keinen Parameter über die ausgewählten Dateien hinaus, und stützt sich deshalb vollständig auf das Standardprofil für Format, Qualität und Zielordner. Siehe die Anleitung Kurzbefehle und AppleScript für den vollständigen Ablauf.

Derselbe Mechanismus kommt der Kommandozeile ohne --profile, AppleScript ohne den Parameter profile, und einem überwachten Ordner ohne eigenes Profil zugute.

Wo Profile gespeichert werden

Profile werden in einer einzigen Datei gespeichert, die von der Anwendung, der CLI und der API gemeinsam genutzt wird:

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

Diese gemeinsame Nutzung ermöglicht es, dass ein in der Oberfläche erstelltes Profil sofort in einem Skript verfügbar ist, und umgekehrt.

Vollständiges Beispiel

Ziel: jede Woche für das Web optimierte Bilder liefern, immer im selben Ordner und mit denselben Einstellungen.

1. Erstelle das Profil Web JPEG: Format JPEG, Qualität 70, Ziel ~/Sites/media.
2. Wende es in der Anwendung über die Symbolleiste auf eine Gruppe an, um das Ergebnis visuell zu prüfen.
3. Sobald du zufrieden bist, rufe es aus einem Skript auf, ohne die Einstellungen wiederholen zu müssen.

# Kommandozeile: nichts zu wiederholen, alles kommt aus dem Profil
jpgboost-cli --profile "Web JPEG" ~/Bilder/woche-12/*.png

# Lokale API: das Profil anwenden, dann in deinen Ordner exportieren
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