Capture One
Install the ArtInStack publish plugin, OAuth-connect, pick a portfolio, and publish rendered JPEGs from Capture One on macOS or Windows.
This is the integration how-to for the official Capture One Publish Plugin. API reference: OAuth, Media, Portfolios.
Prerequisites
- Capture One Pro 12+
- ArtInStack account with at least one portfolio created in the dashboard
- Platform zip from Software (macOS and Windows are separate downloads)
Install
macOS
- Download Download for macOS from Software
- Unzip — you should get
ArtInStackCaptureOne.coplugin - Double-click the
.coplugin, or copy it to~/Library/Application Support/Capture One/Plug-ins/ - Capture One → Preferences → Plugins → enable ArtInStack
Windows
- Download Download for Windows from Software
- Unzip — you should get
ArtInStackCaptureOne.coplugin - Capture One → Preferences → Plugins → + → select the
.copluginpackage - Enable ArtInStack
Connect (OAuth PKCE)
- Preferences → Plugins → ArtInStack
- Click Connect… — browser opens
/oauth/authorize - Sign in if prompted → approve scopes
- Browser redirects to loopback (
http://127.0.0.1:54322/callback); plugin stores access + refresh tokens - Connected apps in Settings → Developer lists ArtInStack Capture One after consent
Optional for local API testing: paste a personal access token in Plugin Manager (development field). Prefer OAuth for normal use.
Pick a portfolio
- Select variants → Publish → Publish to ArtInStack
- Destination → Portfolio loads
GET /api/v1/portfolios - Choose the portfolio (confidential portfolios are labeled)
- Create portfolios in the ArtInStack dashboard — the plugin does not create them
Publish
- Confirm portfolio selection
- Run publish — Capture One renders JPEG (long edge 2048 by default in the plugin processing settings)
- Plugin uploads via
POST /api/v1/mediawithIdempotency-Keyandportfolio_id - On success, the photo appears in the dashboard portfolio; plugin stores remote
media_idfor support
Troubleshooting
| Symptom | Check |
|---|---|
| Connect fails | Loopback http://127.0.0.1:54322/callback registered on the Capture One OAuth client; firewall blocking localhost |
| Empty portfolio list | portfolios:read granted; portfolio exists in same workspace as consent; Connect completed |
| Upload 403 | Missing media:write or portfolios:write |
| File too large | Export a smaller JPEG; platform max image size applies |
| Duplicate uploads on retry | Stable Idempotency-Key per file content — safe to Publish again |
Disconnect
Use Disconnect in Plugin Manager or Revoke access under Connected apps in the dashboard.
