Pelli Plugin for Lightroom Classic

Requirements

• Adobe Lightroom Classic 8.0 or more recent (2019+)

• An active Pelli account on app.pelli.io

• An internet connection

• macOS or Windows

Installation

Step 1 — Download the plugin

Download the file Pelli-Lightroom-Plugin.zip

Step 2 — Unzip the archive

Double-click the file .zip to unzip it. You will get a folder named PelliExport.lrplugin.

Tip: Move this folder to a permanent location (for example Documents/Lightroom Plugins/). If you delete it later, Lightroom will no longer find the plugin.

Step 3 — Install in Lightroom

1. Open Adobe Lightroom Classic

2. Go to the menu File → Plug-in Manager…

3. Click the button Add at the bottom left

4. Select the folder PelliExport.lrplugin

5. Click Add Plug-in

Step 4 — Verify the installation

In the Plug-in Manager, you should see:

• Pelli Export with the status Installed and running

If the status is red or shows an error, check that you have indeed selected the folder .lrplugin (and not a file inside it).

You can close the Manager. The plugin is ready!

Connecting to your Pelli account

The first time you use the plugin, you need to connect to your Pelli account.

Step 1 — Open the export

1. Select one or more photos in your library

2. Go to File → Export… (or Ctrl+Shift+E / Cmd+Shift+E)

3. At the top of the export window, choose Pelli from the list of destinations

Step 2 — Connect

1. In the Pelli Connection section, you will see the status Not connected

2. Click the button Connect to Pelli

3. Your browser opens automatically on the Pelli authorization page

Step 3 — Authorize in the browser

1. Log in to your Pelli account if you have not already done so

2. The page asks you to authorize Lightroom Classic to access your account

3. Click Authorize

Step 4 — Back to Lightroom

1. Lightroom automatically detects the authorization (no need to copy a code)

2. A message confirms: Authentication successful

3. The status changes to Connected with your name and email

Your session stays active for 30 days. You will not need to reconnect each time you use it.

Exporting your photos to Pelli

Step 1 — Select your photos

In the Library or Develop module of Lightroom, select the photos to export:

• A single photo: click on it

• Several photos: Ctrl+click (Windows) or Cmd+click (Mac)

• A range: click on the first one, then Shift+click on the last one

• All photos: Ctrl+A / Cmd+A

Step 2 — Open the export window

Go to File → Export… (or Ctrl+Shift+E / Cmd+Shift+E)

Step 3 — Choose the Pelli destination

At the top of the window, select Pelli as the export destination.

Step 4 — Choose your gallery

1. In the Destination gallery section, open the drop-down menu Gallery

2. Select the gallery to which you want to send the photos

3. (Optional) Choose a specific folder within this gallery

Don't see your gallery? Click the button ⟳ to refresh the list. If you do not have a gallery yet, click Create a gallery to create one from your browser, then refresh.

Step 5 — Adjust the image settings

In the File Settings section, configure your preferences:

Setting

Recommendation

These settings are Lightroom's, not the plugin's. Choose the quality according to your delivery needs.

Step 6 — Start the export

Click the button Export at the bottom of the window.

A progress bar appears during the upload. Lightroom notifies you once the export is complete:

• Pelli upload successful — All photos have been sent

• Upload completed with errors — Some photos could not be sent (the error details are displayed)

In the event of an occasional failure, the plugin automatically retries the upload up to 3 times before reporting the error.

Day-to-day use

Change gallery

Reopen the export window and select another gallery from the drop-down menu. Your last choice is remembered between sessions.

Log out

In the Pelli Connection section of the export window, click Log out. You will need to reconnect to export again.

Update the plugin

1. Download the new version of the plugin

2. In Lightroom, go to File → Plug-in Manager…

3. Select Pelli Export from the list

4. Click Remove to remove the old version

5. Click Add and select the new folder .lrplugin

Troubleshooting

"You must connect to Pelli before exporting"

Your session has expired (after 30 days) or you have not connected yet. Click Connect to Pelli in the export settings.

"Session expired"

Your authentication token has expired. Reconnect by clicking Connect to Pelli.

"Unable to contact the server"

The Pelli server cannot be reached. Check your internet connection and try again in a few moments.

"You do not have permission to access this gallery"

You do not have rights to this gallery. Check in your Pelli dashboard that you are indeed the owner of the gallery.

"The gallery no longer exists or has been deleted"

The selected gallery has been deleted from Pelli. Click ⟳ to refresh the list and choose another gallery.

The browser does not open during connection

Manually open app.pelli.io/lightroom/auth in your browser and follow the instructions.

The plugin does not appear in the export destinations

Check in File → Plug-in Manager that Pelli Export is indeed installed and running (green indicator).

Need help?

If you encounter a problem not listed here:

• Email: [email protected]

• Website: pelli.io

• Dashboard: app.pelli.io