# Lightroom Classic

Source: https://frameleaf.app/docs/using/lightroom/

The Frameleaf plugin adds a **Frameleaf** publish service to Lightroom Classic. Each published collection becomes a Frameleaf album. Click **Publish** and Lightroom renders the photos and uploads them into that album.

It works with Lightroom Classic 13 or later on macOS and Windows. It doesn't work with Lightroom (the cloud version) and doesn't bring photos from Frameleaf into Lightroom.

## Download and install

1. Download [frameleaf-lightroom.zip](https://github.com/Frameleaf/frameleaf-app/releases/download/lightroom-plugin/frameleaf-lightroom.zip). Its `.sha256` checksum is on the [plugin download page](https://github.com/Frameleaf/frameleaf-app/releases/tag/lightroom-plugin).
2. Unzip it. Keep the `frameleaf.lrplugin` folder somewhere permanent, such as your Documents folder. Lightroom loads the plugin from there.
3. In Lightroom Classic, choose **File → Plug-in Manager**, click **Add**, and choose `frameleaf.lrplugin`.

To update, replace the folder with the new one and restart Lightroom.

## Connect to your library

1. In the **Publish Services** panel, click **Set Up** next to **Frameleaf**.
2. In **Library address**, enter the address you open Frameleaf at, such as `https://photos.example.com` or `http://192.168.1.20:2283`.
3. Leave **App ID** empty unless your administrator gave you one (see [App ID](#app-id)).
4. Choose your options:
   - **Add Lightroom keywords as Frameleaf tags** asks for permission to add [tags](https://frameleaf.app/docs/using/tags/). Tick it before you connect.
   - **Include location** sends GPS coordinates. It's off by default.
5. Click **Connect…**. Your browser opens Frameleaf. Sign in if asked, then choose what Lightroom may do:
   - the albums Lightroom may add photos to, and
   - whether it may create new albums. Allow this if you want each collection to get its own album.
6. Choose **Allow**. Your browser hands you back to Lightroom, which says **Lightroom is connected to Frameleaf**. Click **Save**.

Lightroom can only add to the albums you chose and the albums it creates. It can't see or change anything else in your library, and it can never remove or delete photos.

At home, connect with your server's home-network address or your own HTTPS address. That works without a Frameleaf plan. Connecting away from home through Frameleaf's [remote access](https://frameleaf.app/docs/cloud/remote-access/) needs a plan that includes it.

## Publish a collection

1. Right-click **Frameleaf** in **Publish Services** and choose **Create Published Collection**.
2. Under **Frameleaf album**, choose an album you allowed, or leave **Create a new album** to make one with the collection's name.
3. Drag photos into the collection and click **Publish**.

Photos you publish show in the album and in your timeline. **Show in Frameleaf** on a published photo opens it in Frameleaf.

## What Lightroom sends

| Sent | Not sent |
| --- | --- |
| A full-quality sRGB JPEG at the size you set under **Image Sizing** | The original raw file or your Lightroom edits |
| Title, caption, keywords, copyright and creator, embedded in the JPEG | Location, unless you tick **Include location** |
| Capture date and camera details | People and face names |

Frameleaf reads the title, caption and copyright from the JPEG. See [XMP sidecars](https://frameleaf.app/docs/using/xmp-sidecars/) for how those fields show in Frameleaf. With **Add Lightroom keywords as Frameleaf tags**, the first 20 keywords of each photo also become tags.

Videos aren't published.

## Republish, remove and disconnect

- **Republishing an edited photo adds a new copy.** The earlier copy stays in Frameleaf, so nothing you already shared changes underneath anyone. Delete old copies in Frameleaf if you don't want them.
- **Publishing the same photo again without changes doesn't add a duplicate.**
- **Removing a photo or deleting a collection in Lightroom never removes anything from Frameleaf.** Lightroom only forgets that it published it.
- **Disconnect** in the publish service settings signs Lightroom out and removes its access. You can also remove it in Frameleaf under **Settings › Your sign-in & privacy › Connected apps**, which is also where you change the albums it may use.

If an export is interrupted, publish again. Photos that finished aren't uploaded twice, and photos that didn't finish resume.

## App ID

Lightroom normally registers itself the first time it connects. If your administrator has turned that off, Lightroom says the library doesn't let apps register themselves. Your administrator registers it once for everyone:

- **Return address:** `lightroom://net.frameleaf.connect/oauth/callback`

Enter the app ID they give you in **App ID**, then click **Connect…**.

## Fixes

| Lightroom says | What to do |
| --- | --- |
| **Frameleaf couldn't reach your Library** | Check the address, and that this computer is on the same network or can reach your HTTPS address. |
| **This address isn't a Frameleaf Library that supports Lightroom** | Check the address. If it's right, update your server; Lightroom needs a Frameleaf version with Connect. |
| **This Library doesn't let apps register themselves** | Ask your administrator for an [App ID](#app-id). |
| **That sign-in has expired** | Click **Connect…** again and finish in the browser within 15 minutes. |
| **Your connection to Frameleaf has ended** | Access was removed or expired. Open the publish service settings and click **Connect…**. |
| **This connection can't create albums** | Pick an album under **Frameleaf album** in the collection's settings, or disconnect and connect again allowing new albums. |
| **This connection isn't allowed to do that** | The album is no longer one Lightroom may add to. Change it in **Connected apps** or choose another album. |
| **Keywords couldn't be added as tags** | Disconnect, tick **Add Lightroom keywords as Frameleaf tags**, connect again and republish. |

The plugin keeps your sign-in in your computer's keychain and never writes it to Lightroom's logs.
