Capture One

Il toolkit Capture One e una integrazione shell leggera che usa l'API pubblica di PhotoProofing. E adatta a sessioni tethered, output recipe ed export batch.

Prerequisiti

• Capture One 23 o successivo.
• Account owner di un'organizzazione PhotoProofing.
• API key generata da Admin > Settings.
• macOS come piattaforma primaria supportata. Linux best-effort.
• curl disponibile nella shell.
• jq opzionale ma consigliato per il setup wizard.

Download

• photoproofing-upload.sh
• photoproofing-upload-batch.sh
• photoproofing-setup.sh
• config.example.json

1. Genera una API key

In PhotoProofing apri Admin > Settings e crea una nuova API key, ad esempio Capture One Studio.

Copia subito la chiave: viene mostrata una sola volta.

2. Avvia il setup wizard

chmod +x photoproofing-setup.sh photoproofing-upload.sh photoproofing-upload-batch.sh
./photoproofing-setup.sh

La configurazione viene salvata in:

~/.photoproofing/config.json

Se jq e installato, lo script mostra la lista gallery e permette la selezione guidata. In caso contrario passa alla modalita manuale con inserimento gallery ID.

3. Testa un upload singolo

./photoproofing-upload.sh /percorso/assoluto/frame-001.jpg

Gli upload riusciti vengono registrati in:

~/.photoproofing/upload.log

4. Configura la Output Recipe in Capture One

1. Apri le impostazioni del workflow/export in Capture One.
2. Crea o modifica la Output Recipe usata per tethering/export.
3. Imposta l'azione post-processing su Open With.
4. Seleziona photoproofing-upload.sh.
5. Esporta uno scatto e verifica che compaia nella gallery target.

5. Upload batch di una cartella

./photoproofing-upload-batch.sh /percorso/assoluto/cartella-export

Di default lo script aspetta 1 secondo tra i file per restare entro il rate limit. Puoi cambiare il valore con PHOTOPROOFING_UPLOAD_DELAY=2.

Troubleshooting

• 401 UNAUTHORIZED: API key mancante, invalida o revocata.
• 404 NOT_FOUND: il gallery ID configurato non appartiene all'organizzazione associata alla chiave.
• 413 FILE_TOO_LARGE: il file supera il limite di 50 MB.
• 429 RATE_LIMIT_EXCEEDED: rallenta il batch o attendi la finestra di reset.

Il primo file da controllare in caso di problemi e ~/.photoproofing/upload.log.