# Frameboard for Lightroom Classic

Your production becomes a collection set: one collection per shot, with the
photographs already filed into them.

**Lightroom Classic only.** The cloud version of Lightroom has no plug-in
system, so there is nothing to install there.

## Start here

1. In Lightroom: **File > Plug-in Manager > Add**, and pick the
   `Frameboard.lrplugin` folder.
2. **Library > Plug-in Extras > Connect to Frameboard.** In Frameboard, press
   **Connect a program** in your account and type the eight characters here.
3. **Library > Plug-in Extras > Build collections from a production.** Pick
   your production.

## What you get

A collection set called after the production, with a collection per shot named
like `4-2A`, and every photograph in your catalogue whose file name starts with
that shot filed into it.

Nothing is moved, renamed or changed. A Lightroom collection is a list of
references, so a photograph sits in its shot's collection and stays wherever
else it already was. Undoing the whole thing is deleting the collection set.

## Sending photos back

Select photographs and choose **Library > Plug-in Extras > Send selected photos
to Frameboard**. Each one lands on its shot as a take, so the board shows what
was shot next to what was planned. There is a tick box for sending only the
ones flagged as picks.

What travels is Lightroom's 1600px preview, not your master. A board wants a
picture of the take; the raw file is yours.

## How photographs find their shot

By file name. `4-2A_0007.CR3` belongs to shot 2A of scene 4, because that is
what the Capture One helper named it during the shoot.

If your files are not named that way, run the Capture One helper's **Label a
folder already shot** first. It writes the production, scene and shot into the
files as keywords, and then Lightroom shows the whole structure as a keyword
tree on import even without this plug-in:

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

## Honestly

This plug-in has not been run against a real Lightroom install. It is written
against Adobe's documented Lightroom SDK, its JSON reading and its file name
matching are tested, but the parts that talk to the catalogue have never
executed. If something misbehaves, say so and it gets fixed quickly.

The keyword route above needs no plug-in at all and does work today.