Skip to content
PhotoProofing PhotoProofing PhotoProofing Manual

Capture One

The Capture One toolkit is a lightweight shell-based integration that calls the public PhotoProofing API. It works well for tethered sessions, export recipes, and batch publishing.

Prerequisites

Section titled “Prerequisites”
  • Capture One 23 or newer.
  • A PhotoProofing organization owner account.
  • An API key generated from Admin > Settings.
  • macOS as the primary supported platform. Linux is best-effort.
  • curl available in your shell.
  • jq optional but recommended for the setup wizard.

Download

Section titled “Download”

1. Generate an API key

Section titled “1. Generate an API key”

In PhotoProofing, open Admin > Settings, then create a new API key with a label such as Capture One Studio.

Copy the key immediately. It is only shown once.

2. Run the setup wizard

Section titled “2. Run the setup wizard”
Terminal window
chmod +x photoproofing-setup.sh photoproofing-upload.sh photoproofing-upload-batch.sh
./photoproofing-setup.sh

The wizard stores your configuration in:

~/.photoproofing/config.json

If jq is installed, the wizard lets you select a gallery from the API response. Without jq, it falls back to manual gallery ID entry.

3. Test a single upload

Section titled “3. Test a single upload”
Terminal window
./photoproofing-upload.sh /absolute/path/to/frame-001.jpg

Successful uploads are appended to:

~/.photoproofing/upload.log

4. Configure Capture One Output Recipe

Section titled “4. Configure Capture One Output Recipe”
  1. Open Capture One > Settings > Plugins or your export workflow settings.
  2. Create or edit the Output Recipe used for tethering/export.
  3. Set the post-processing action to Open With.
  4. Choose photoproofing-upload.sh.
  5. Export a frame and confirm it appears in the target gallery.

5. Batch upload a folder

Section titled “5. Batch upload a folder”
Terminal window
./photoproofing-upload-batch.sh /absolute/path/to/export-folder

By default the script waits 1 second between files to stay well inside the rate limit. You can override it with PHOTOPROOFING_UPLOAD_DELAY=2.

Troubleshooting

Section titled “Troubleshooting”
  • 401 UNAUTHORIZED: the API key is missing, invalid, or revoked.
  • 404 NOT_FOUND: the configured gallery ID does not belong to the organization tied to your API key.
  • 413 FILE_TOO_LARGE: the image exceeds the 50 MB limit.
  • 429 RATE_LIMIT_EXCEEDED: lower your batch speed or wait for the retry window.

Check ~/.photoproofing/upload.log first when diagnosing failures.