Radiant Imaging Labs

Capture One catalogs and Sessions

Draft: not yet checked against the release

Radiant Flow can open a Capture One catalog or Session and show its folders and albums in the sidebar. You can look through the photos, check them in Quick Look and open them in Radiant Photo. On a Mac, the ratings, color tags, keywords and captions you set in Flow also go to Capture One. On Windows, Flow only reads the catalog or Session: nothing you do in Flow changes it.

Open a catalog or Session

  1. Choose File > Open Capture One Catalog or Session…, or click those words in the sidebar's empty Capture One section.
  2. On a Mac, pick the catalog's .cocatalog file. For a Session, open its folder and pick the .cosessiondb file inside it. On Windows, pick the catalog's .cocatalog folder, or the Session's folder.

It appears in the sidebar under Capture One, and its All Images opens in the grid. Every catalog and Session you open stays in the section, so you can come back to it. On Windows, a note under the header says Flow never changes them, for example Read-only — this catalog is never written to. A Mac shows no such note, because your changes go to Capture One.

Flow reads catalogs and Sessions from Capture One 16, and from Capture One 17 with the note Unverified version beside the name. It can't open older or newer ones. Two-way sync is tested with Capture One 16.9.

Browse folders and albums

Click the triangle beside a catalog's name to show what it holds. Until you open it, its row shows only its name. Click any row to show its photos in the grid.

RowWhat it shows
All ImagesEvery photo in the catalog or Session.
FoldersThe folders its photos are in. A Session lists its Capture, Selects, Output and Trash folders.
CollectionsYour albums and smart albums, and the projects and groups that hold them.

A smart album is listed but grayed out, with a dash instead of a count. Capture One stores a smart album's rule, not its photos, so there is nothing to show.

While Capture One is open

Flow reads a copy of the catalog, never the catalog itself, so you can browse it while Capture One has it open. On a Mac, the note Capture One is running beside the name reminds you that Capture One may change the catalog after Flow has read it.

Flow doesn't watch the catalog for changes. After you work in Capture One, refresh it to see them:

  • Click the refresh button on the catalog's row (Refresh Capture One Catalog), or
  • Click the folder or album you are in again.

Show a photo in Capture One

On a Mac, select one photo and choose File > Show in Capture One, or right-click it. Capture One comes to the front with that photo selected. If the album open in Capture One doesn't hold the photo, Capture One goes to All Images first.

Flow never starts Capture One or opens a catalog in it. If Capture One doesn't have the catalog open, Flow says Capture One doesn't have this catalog open. If the photo isn't in it, Flow says Capture One can't find this photo in the catalog.

Send your changes to Capture One (Mac)

On a Mac, these changes you make to a catalog's or Session's photos in Flow go to Capture One:

  • the rating;
  • the label, which becomes Capture One's color tag of the same color;
  • keywords you add or remove;
  • the caption, title, headline, creator and contact details, place names, copyright notice and most other text fields in the Metadata panel (the ones that can't go are below).

Flow shows your change at once. It doesn't touch the photo's file or write a sidecar: Capture One makes the change in its own catalog. Flow sends it about a second after you make it, while Capture One is running with that catalog or Session open. Flow never starts Capture One and never opens a catalog in it. While Capture One is closed, or has another catalog open, your changes wait. Flow tries again every 30 seconds while changes wait, each time you start Flow, and when you open the catalog in Flow. Waiting changes are kept when you quit Flow, and when you remove the catalog from the sidebar.

Flow finds the photo in the catalog's All Images, so your change reaches it even while Capture One shows an album or folder without it. Capture One keeps showing what you chose. If the photo is no longer in the catalog, for example because you moved it to Capture One's Trash, the change is dropped, and Sync History says Capture One did not apply it.

Some things can't go to Capture One:

  • Flags. Capture One has no flags, so you can't flag a photo here.
  • The location, with its altitude and direction. Capture One doesn't let another app change it, so the Metadata panel shows it without letting you change it.
  • The copyright status, the web statement and the event. Flow keeps what you type, but Capture One has no place for them.
  • A keyword with a comma or a vertical bar (|) in it. Capture One doesn't accept one, so Flow doesn't send it.
  • Copyright owner, Image creator and Licensor, the Model Release and Property Release rows, AI training and Other constraints. The Metadata panel grays them out.
  • A gray label. Capture One has no gray color tag.

Flow sends changes only while Update the files of Lightroom Classic photos in Settings > Sidecars is on, as it is unless you turn it off. While it's off, your Capture One changes wait, and the catalog's row counts them without saying why. The switch's name and hint mention only Lightroom Classic, but on a Mac it also holds Capture One changes.

The first time: allow Automation

On a Mac, Flow sends your changes to Capture One through macOS Automation, and macOS has to allow that first. Flow asks while you're looking, before it sends anything.

Flow checks quietly whenever it looks at a Capture One catalog or Session in your sidebar: when you open Flow, when you open the catalog, after you change a photo, and when you turn on Update the files of Lightroom Classic photos. macOS can answer only while Capture One is running. If macOS hasn't asked yet, Flow sends Capture One nothing and opens a window, Let Radiant Flow control Capture One. It says Two-way sync sends your ratings, color tags, keywords and captions to Capture One, and macOS has to allow it first. macOS is asking now: click Allow in its box. A box left unanswered for two minutes counts as Don't Allow.

Beside it, macOS asks whether Radiant Flow may control Capture One, with Flow's reason: "Radiant Flow uses Automation to send your ratings, color tags, keywords and captions to Capture One." Click Allow. Flow's window closes by itself, and your changes go to Capture One as usual.

The window waits until no other window is open in Flow, and Flow asks at most once each time you open it. Not now closes Flow's window.

If you click Don't Allow, your changes wait. If Flow's window is still open, it says so, and its Not now button becomes Close. Under the catalog's or Session's name in the sidebar, Flow says macOS isn't letting Radiant Flow send changes to Capture One. Grant it in System Settings › Privacy & Security › Automation. even when no change waits. macOS's own error may follow in parentheses. Then come There, open Radiant Flow and turn on Capture One. and an Open System Settings row.

To allow it later:

  1. Click Open System Settings in the window or in the sidebar. macOS opens Privacy & Security at Automation.
  2. Open Radiant Flow in the list and turn on Capture One.
  3. Switch back to Flow. While macOS refuses, Flow checks again every 30 seconds, so you don't need to restart it. Then it sends your waiting changes.

What the catalog's row says

While changes wait, lines under the catalog's or Session's name say what is happening. The first counts the changes waiting for Capture One. Click it to see each one in the Waiting Changes list, where you can retry or discard them. The next line says why they wait:

The line saysWhat it means
Capture One isn't runningStart Capture One and open the catalog. Flow won't start it for you.
Capture One doesn't have this catalog open.Capture One is running with another catalog open. For a Session, the line says Session.
macOS isn't letting Radiant Flow send changes to Capture One. Grant it in System Settings › Privacy & Security › Automation.macOS doesn't let Flow control Capture One. This line shows even when no change waits. See The first time: allow Automation.
Radiant Flow couldn't ask Capture One: Capture One did not answer in timeSomething else stopped Flow. Your changes wait, and Flow tries again 30 seconds later.

If Capture One refuses a change five times, a line names the photo and Capture One's error. Click Discard This Change to drop it.

After Capture One takes your changes, Flow reads the catalog again, so the grid shows what Capture One kept. To see what became of each change to a photo, select it and open Sync History in the Metadata panel. See Lightroom Classic catalogs.

When both apps changed a photo

If a photo's rating, color tag or text changed in Capture One too before your change reached it, Settings > Sidecars > When a photo changes in two apps > Capture One decides which change stays: Capture One wins (the default), Radiant wins or Newer change wins. Keywords from both apps are always kept. See Settings.

Thumbnails and adjustments

In the grid, Flow uses Capture One's own thumbnail when the catalog has one, and that thumbnail shows your adjustments. It is small (450 pixels), so a large tile, Quick Look and Single Photo show the original file instead.

A photo you adjusted in Capture One carries a small Capture One mark. Point at it to read Adjusted in Capture One. Flow shows the original without these adjustments.

If an original isn't on disk, for example because its drive isn't connected, the grid still shows Capture One's thumbnail on a small tile when there is one. Otherwise the tile shows a broken-link mark; point at it to read Original offline. Quick Look and the Stage can't show that photo, and Open leaves it out.

Variants show as stacks

When an image has two or more variants in Capture One, Flow shows them as one stack, with the first variant on top. You can't change these stacks, on a Mac or on Windows: every row of View > Stacks is grayed out with This source is read-only. See Stacks.

What you can do in a catalog or Session

  • Filter by rating, label and keyword. Labels are Capture One's color tags, and Capture One has no flags. The filter row says Other filters are not available for Capture One catalogs. Any other filters you had on are suspended, and the row says how many. They come back in a folder.

  • Group by Year, Month or Day with View > Sort by > Group By. Photos come in capture-time order, and sorting by another field is not available.

  • Rate, label, add keywords and write captions, on a Mac. See Send your changes to Capture One (Mac).

  • Look with Quick Look and Single Photo, and open photos in Radiant Photo. On a Mac, a rating or label you set there goes to Capture One too, through Flow; other changes you make there, such as keywords and captions, don't reach the catalog. On Windows, Radiant Photo opens each one as a plain file, so nothing you change there reaches the catalog.

  • Copy photos to a folder with Copy To, or by dragging them onto a folder. Each copy gets the photo's rating, color tag (as its label) and keywords, in an .xmp sidecar. A folder inside that catalog or Session is refused: The Capture One catalog Capture One Catalog keeps files in this folder. Choose a folder outside it.

What stays read-only

  • On Windows, ratings, flags and labels can't be set here, and the Metadata panel shows a photo's fields without letting you change them. Make those changes in Capture One, then refresh.
  • On a Mac, flags and the location can't be set here. See Send your changes to Capture One (Mac).
  • The rows under Move To are grayed out with Capture One catalogs these photos. Moving one would leave it with a missing file.
  • Other file commands, such as Reveal in Finder (Show in Explorer on Windows), Copy Path, Rename… and Move to Trash, are grayed out with This source is read-only. Flow never moves a catalog's or Session's photos to the Trash.
  • Rotating, Edit Capture Time…, the Columns grid style and Include Subfolders are not available.
  • Photos can't go in a Job from here: Photos can’t join a Job from a Capture One catalog. Open their folder and add them from there.

In a folder, Flow asks before renaming, moving or trashing photos that a catalog or Session in the sidebar uses. See Working with files.

Locate or remove a catalog

If a catalog or Session can't be read, the section says This catalog could not be opened: followed by the reason. If you moved it, or its drive isn't connected, right-click it and choose Locate…. Pick it where it is now, and it takes the old row's place.

To take one off the list, right-click it and choose Remove from Sidebar. You can also click its row and press Delete. Flow then asks Remove “Capture One Catalog” from the sidebar? Click Remove from Sidebar to confirm. The catalog or Session itself is not touched.

Learn more