# Frameboard for Capture One

## Start here

1. **Double click the launcher for your machine.**
   `Frameboard (Mac).command` or `Frameboard (Windows).bat`.
2. **It asks for a code.** In Frameboard, go to Account, press
   **Connect a program**, and type the eight characters it shows you.
3. **Pick your production from the list.** That is the setup, once, for good.

On a Mac the first double click needs right click, Open, and confirm, because
macOS quarantines anything downloaded from the web.

Needs Python 3. macOS has it. On Windows, install it from python.org and tick
"Add Python to PATH".

## Shooting

Press **1** to start shooting, and drag your Capture folder into the window
when it asks.

From then on, every frame you shoot is sent to Frameboard and lands on the
shot you are on, as a take, keeping the camera's own file name.

**Press Enter to move to the next shot.** No menus, one hand.

## What else it does

- **Names your captures after the shot**, so the file already says 4A. macOS
  only, because Capture One's automation is AppleScript.
- **An album per shot** in Capture One, from the menu. macOS only.
- **The storyboard frames**, downloaded from the menu, so you can lay one over
  the live view with the Overlay tool.

On Windows the naming and albums are not possible, but the part that matters,
sending frames back onto their shots, works exactly the same.

## It labels your files, for Lightroom and everything else

Every capture gets the production, the scene and the shot written into it as
XMP: inside the file for JPEGs, and as a `.xmp` sidecar beside raw files, which
is where each of them is read from. Raw files are labelled even though they are
never sent to Frameboard, because the raw is the one that goes into Lightroom.

Import anywhere and the structure arrives as a keyword tree:

```
Frameboard
  Cold open
    Scene 4 The garage
      Shot 2A
```

**Already shot a job?** Menu option 5 labels a folder after the fact, matching
files to shots by their names.

## Raw files stay on your machine

Only JPEG, PNG and WebP are sent. Frameboard holds the frame that goes on the
board, not the negative. Either shoot RAW+JPEG, or point it at the output
folder of a process recipe.

## Stopping

In Frameboard: Account, Connected programs, and disconnect it. That machine
stops immediately and nothing else about your account changes.