Skip to content

Lightroom Classic

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.

  1. Download frameleaf-lightroom.zip. Its .sha256 checksum is on the plugin download page.
  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.

  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).
  4. Choose your options:
    • Add Lightroom keywords as Frameleaf tags asks for permission to add 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 needs a plan that includes it.

  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.

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 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.

  • 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.

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….

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.
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.