Installation and Management of Lightroom Plugins
Quick Links

· My Lightroom Goodies
· My Photo-Tech Posts
· My Blog

Plugins are added and maintained via Lightroom's Plugin Manager, which is accessible from Lightroom's File menu, and also from a button on the Export Dialog itself.

Here's a screenshot of the Plugin Manager on my system, after I installed half a dozen plugins. At the moment, it's showing my “Metadata Wrangler” plugin selected. Mouseover the labels at left to highlight areas of the screenshot...

(Mouseover items below)
  • List of plugins I've
    already installed
  • Install new plugins here
  • Info / tools for the
    highlighted plugin
  • Some plugins provide
    additional sections
  • Opens Adobe's
    Plugin Exchange
    in a browser

Installing a New Plugin

(short version)

Installing a plugin for use with Lightroom usually involves these steps:

  1. Downloading a zip file from a trusted plugin source.
  2. Unzip the plugin, and move the resulting “...lrplugin” folder to wherever you'd like to store your plugins.
  3. Bring up Lightroom's Plugin Manager and tell Lightroom about that folder via the Add button.

Installing a New Plugin

(long version)

0. Clean out old versions of the plugin, if applicable.

If you're about to do a reinstall, it may be prudent to delete any old versions of the plugin from your drive so as not to confuse what you download and unzip later.

1. Download a zip file from a plugin source

Plugins are available from a variety of sources. My plugins are available from my Lightroom goodies page. I also list there other notable sources.

Warning: a Lightroom plugin has as much access to your system as Lightroom itself, so for most people this means that a Lightroom plugin can access (and read/delete) any file on your system, so when choosing to install a plugin, exercise the same prudence you would use when downloading programs from the Internet. Just as when choosing to install a program, choosing to install a Lightroom plugin involves trusting that the programmer is both trustworthy and competent.

Some browsers unzip the download automatically for you, and with others you unzip it yourself. In either case, you should end up with a folder whose name ends in “.lrplugin” or“.lrdevplugin”. (On a Mac, a “.lrplugin” folder actually appears as a “module” package.)

You don't normally ever need to be concerned with the contents of a plugin folder, but if you need to confirm that the folder actually contains a plugin in the first place, check for an “Info.lua” file. (On Macs, you may need to “Show Package Contents” in Finder to view the files inside.) I mention this because some programs that produce zip files create a “....lrplugin” folder into which they drop the actual plugin “.lrplugin” folder, which can cause confusion.

2. Move the plugin folder to wherever you'd like to store your plugins

Lightroom allows you to keep the plugins wherever you like — you just have to tell it where you place each one — so it's up to you to pick a spot to save them. Perhaps a Lightroom Plugins folder in your Documents?

When you Add the plugin to Lightroom, you're just adding a reference to the location. It's only natural to think that a copy of the plugin was made when you Add, but Adobe doesn't do that, so be sure not to delete the plugin files from disk.

3. Tell Lightroom where the plugin is

Bring up Lightroom's Plugin Manager, either from the File menu, or from the Plugin Manager button on the Export Dialog. Click the Add button, then navigate to the “.lrplugin” item from the previous step.

Kinds of Plugins

Plugins can add functionality in any combination of the following:

  • A Publish Plugin adds a new publish service to the list available in the lower left of the Library Module, in the Publish Services panel.

  • An Export Plugin adds a new destination to the list available in the “File > Export...” dialog. See here.

  • A plugin can add export filter modules that can be used with any Export or Publish action. See here.

  • A plugin can add features to the “File > Plug-in Extras...“ and/or the “Help > Plug-in Extras...“ menus.

Again, a plugin can have any combination of the above. In particular, plugins that send files to remote photo-hosting sites can be Publish only, Export only, or both Publish and Export.

A plugin might not provide services through any of the methods shown above. My Folder Watch plugin, for example, provides all of its services from the Plugin Manager itself.

Using an Export Plugin

An export plugin can be selected by bringing up Lightroom's export dialog, then clicking on the “Hard Drive” popup menu at the top...

That brings up a list of the export handlers available, the three built in items (Email, Hard Drive, and CD/DVD), as well as any added by plugins that are both installed and enabled...

Using a Filter-Module Plugin (a “Post-Process Action” Plugin)

Some plugins provide generic support that can be used with any Publish or Export action. For example, my Metadata Wrangler plugin allows you to strip selected metadata from exported copies as they are produced. It can be used with any Export or Publish action, whether via Lightroom standard methods or unrelated plugins.

Adobe calls these “Post-process Actions”, but most people call them “Export Filters”.

Once you've added and enabled a filter plugin via the Plugin Manager, it shows up in the lower-left of the export dialog....

Click on its name, then the Insert button at the bottom, and you'll see it added to the main dialog. In the screen snippet above, the “Metadata Wrangler” dialog section is shown collapsed, so you only see its banner. If you were to click on the little triangle beside the name, you'd see the full dialog for the plugin, which, in this case (my Metadata Wrangler filter) is huge (see here for a screenshot).

Plugin Maintenance & Upgrades

Once a plugin has been installed with Lightroom, you can enable or disable it from the Status section of the Plugin Manager. A disabled plugin can't be used from within Lightroom, but remains available in the Plugin Manager, so it can be easily enabled when you want to start using it again.

You can have Lightroom forget about a plugin with the Remove button, on the bottom of the left-hand column.

If the Remove button is grayed out for a particular plugin, it's because the plugin is located in Lightroom's system area. Such plugins can be removed only by deleting the plugin files from disk.

The Status section might also display plugin version and web-site information, if the plugin provides it (such as in the screenshot above).

Upgrading a plugin

Upgrading a plugin to a newer version is similar to installing the first time, except that if you replace the original “.lrplugin” folder with the new one, you don't have to re-register the location with Lightroom. In that case, you simply need to restart Lightroom, or click the “Reload Plug-in” button in the Plugin-Manager's “Plug-in Author Tools“ section.

If you install the new version in a new location, and register it via the Plugin Manager, the previous version will remain, but be disabled. You can enable only one version of any particular plugin at a time. Simply Remove the older versions when you no longer need them.

Upgrading one of my plugins

I've built an upgrade mechanism into my plugins, such that when a new version is available, you can simply press the Upgrade Now button in the Plugin Manager. That causes the new version to be downloaded and unzipped in place over top of the old version. You then press the Reload Plug-in button, or restart Lightroom, to have the new version take effect.

(If something goes wrong with the upgrade process, you'll have to manually download and install the new version. In such a case, you might want to inspect the log file left in the temporary-files area of the system, named for the plugin, e.g. “flickr-log.txt” for my Flickr plugin).


The 30 most-recent comments (out of 202; see all), most recent last...

Jeff,

thanks for the plugin – I just downloaded / installed Lightroom to Photobucket. Installation went smooth but for some reason i’m having problems registering the api with Photobucket. It says The application will not be allowed to access your account. I tried being logged into Photobucket while trying to register and it gives me the same error. Any ideas????

Thanks!

Sean in Boise, ID

I’m not sure what to say… I’ve never heard of this problem. I just tried and it worked fine for me. Perhaps they were just having temporary issues? —Jeffrey

— comment by Sean on August 19th, 2013 at 1:59pm JST (2 years, 9 months ago) comment permalink

Jeff,

I got problems with your Facebook plugin. So far it worked very well, but now it tells, that it’s not properly autheticatetd. If I try to re-autheticate, Firefox tells me, that it couldn’t handle the protocoll (lightroom://). What is going wrong?

Jan

See this FAQ. —Jeffrey

— comment by Jan on September 23rd, 2013 at 9:28am JST (2 years, 8 months ago) comment permalink

I am trying to upload this to Lightroom so I can export directly to Exposure Manager. I don’t know if I am supposed to upload Wrangler or JF Exposure Manager or both. I have both plugins uploaded but I must have missed a step because the login button is grayed out. It says it’s up and running but even when I click the Visit Exposure Manager and log in, it still says I am not logged in. I am using Lightroom 5. Do I need to register first? (It says I don’t.) Or was I supposed to enter some Exposure Manager ftp site info first?. I was up until 3 am . Help Help help. Somebody please…..ALSO If I open the Download up, it enters a bunch of photos into Lightroom. That can’t be correct….Is there a Youtube link I can watch or something? I can’t seem to follow your directions.

Next to “Visit Exposure Manager” should be a place to enter your ExposureManager username and password. That’s where you log in. You don’t need the Metadata Wrangler unless you want what it provides (stripped selected metadata before uplaod). —Jeffrey

— comment by Anonymous on October 4th, 2013 at 2:35am JST (2 years, 8 months ago) comment permalink

Jeff,

A lot of photos have “no value” as the focal length in 35mm equivalent.
These certainly have their focal length displayed in the metadata box, so the actual focal length is not missing. Any idea why the plugin fails to calculate the 35mm equivalent focal length in some cases?

If the plugin doesn’t know the size of the sensor, it can’t calculate the 35mm equiv even though it may know the actual focal length. If you send a direct-from-camera photo, I might be able to figure it out and add it to the crop-factor database. —Jeffrey

— comment by Rick on October 24th, 2013 at 9:06am JST (2 years, 7 months ago) comment permalink

Hi Jeffrey,
Tried your Smugmug export plugin tonight and it seems to have broken the existing simple LR version. I needed a full export plugin to resize and watermark while publishing.
I’m running LR 3.3.
When I try to add a file to an existing collection or make changes, I get an error message “Can’t update this collection. Your smugmug account has expired.”
Not the case
Any ideas or fixes on this. If I uninstall yours will I get back to normal operation? Can they run concurrently?

Thanks.
James

There is absolutely no interaction between my plugin and theirs… at least there shouldn’t be and I’ve never heard of it before. I’m guessing that it’s just coincidental (and unfortunate) timing with some other issue, such as SmugMug having server issues or something…. —Jeffrey

— comment by James on October 28th, 2013 at 7:00pm JST (2 years, 7 months ago) comment permalink

Hello – I am trying to use the Photobucket plugin and can get it enabled, but when I try to export and authenticate I get an error message “Couldn’t authenticate to photobucket: Unexpected HTTP error…” I can get the other plugins working, but this one doesn’t seem to want to work. I’m not logged on anywhere and didn’t see a place for that. I’m on a trial version of LR. Thanks!

It’s difficult to guess from just this. Perhaps send a log the next time you run into it. —Jeffrey

— comment by Brad on November 24th, 2013 at 1:26pm JST (2 years, 6 months ago) comment permalink

Short story …. i bought a license for LR4 from a un-trusted source … shame on me … your plugin to export to Zenfolio no longer works.

I re-downloaded your plug in, Made a NEW donation, and upgraded to Photoshop CC and LR5. When i try to install your zenfolio plugin into LR5 , it is still saying disabled. How do i get it to let me register my new donation?

Thank you

The top section of the plugin manager tells you exactly what to do. —Jeffrey

— comment by Sean on December 19th, 2013 at 11:52am JST (2 years, 5 months ago) comment permalink

Many thanks for the Preview Extraction plugin. Worked great. Much appreciated!!

— comment by RSwift on January 17th, 2014 at 7:13pm JST (2 years, 4 months ago) comment permalink

Hey thanks for the great plugins!!!!! Toledo, Ohio photographer here.
Quick question…I have the fb plugin and the zenfolio plugins. I started working at a studio and they have their own copy of LR and I have my own copy at home. But I often take a LR Catalog back and forth between work and home. Will I be able to use the plugins in both places or not? If not is there a way to do so?

Adobe doesn’t make it easy, but it’s possible. You probably want to have the catalog and the master image files on a removable disk that you bring with you. Then you have your preferences, which you’ll likely have to set at both places. Then if you use special lens correction profiles, or sensor calibration profiles, etc., and presets of all manner, those also have to be replicated. (Many find Dropbox or the like useful for that.). The Lr/Backup plugin saves all these different files, so you can look at what it does to learn about what’s there to be replicated. —Jeffrey

— comment by Jen on March 26th, 2014 at 10:45pm JST (2 years, 2 months ago) comment permalink

When I try to update Picasa with your plugin I always have this error “Unexpected HTTP status from Google: 400
Error trying to parse element.”

I used lightroom 5.6 (64bits)

What can I do?
Thanks.

It’s probably just a glitch by Google, but if it persists then send a log after encountering the error… —Jeffrey

— comment by Emilio on April 26th, 2014 at 8:46pm JST (2 years ago) comment permalink

Initial success installing and using Google Drive plug-in on Lightroom 5.4, uploaded about a dozen pictures no problem.

Subsequent attempts to update/reupload and add new pictures consistently fails and return s

“Unexpected HTTP status from Google: 400
Invalid multipart request with 0 mime parts.”

Help!

Win7/64 I7 16Gb RAM

I believe this is a Lightroom bug… I’ve heard of it from time to time, where the plugin prepares everything to send to Google, but Lightroom sends only the header then tells Google it’s done. I’ve reported it to Adobe; beyond that, I can only cross my fingers and hope it doesn’t rear its ugly head very often. —Jeffrey

— comment by wtlloyd on May 1st, 2014 at 10:24am JST (2 years ago) comment permalink

Photobucket plugin not showing on LR5.4, Picasaweb is working correctly though and I installed both the same way. Photobucket shows in plugin manager but not in the Publish Services. Any ideas?

The Photobucket plugin has never been Publish… only Export. —Jeffrey

— comment by Gavin on May 17th, 2014 at 6:39pm JST (2 years ago) comment permalink

Hi Jeff,
The export to Zenfolio plugin says “Plugin Registration button appears here after Lightroom is registered with Adobe” I’m registered with Creative Cloud. Any ideas?
Thanks
Daniel

It’s a known issue as of yet without a known fix. )-: —Jeffrey

— comment by Daniel on June 27th, 2014 at 6:54am JST (1 year, 11 months ago) comment permalink

Hi, Jason writing from Oakland, CA, here.

I’m wondering if your LR->Facebook plugin will cure the dreaded “via Adobe Photoshop Lightroom” text in Facebook posts. This text drives me crazy.

Thanks,

Jason

Unfortunately, no, as far as I know, Facebook does not give users a choice to suppress the name of the upload app. Flickr does, FWIW, but FB chooses to make it obligatory. —Jeffrey

— comment by Jason on July 17th, 2014 at 3:02pm JST (1 year, 10 months ago) comment permalink

Hi, I reside in Melbourne , Australia.
I am using your Metadata Preset Builder plugin. Each time I restart LR5 the Metadata preset goes back to default. I was using it last year on another system and this didn’t happen – have I done something wrong while installing. I have just updated the plugin and it still reverts to default at start up.

It sounds like a classic symptom of your Lr preferences file going bad. —Jeffrey

— comment by Rex Harris on November 3rd, 2014 at 1:31pm JST (1 year, 7 months ago) comment permalink

writing from the San Francisco area…..I have used your export from LR to Zenfolio happily for years. Suddenly now whenever i export, it will only upload to one specifc folder from 2010. I try to create a new gallery but it doesn’t seem to see it. under upload destination it tells me that this old 2010 gallery is selected and I can’t seem to unselect. I’ve tried trashing the plug in and reinstalling it to no avail. Any thoughts on how to get this working again? Thank you!

Are you sure that when you try to create a new gallery, you’re not accidentally creating a new group instead? Groups don’t show up in the destination list. —Jeffrey

— comment by hilary Hood on December 10th, 2014 at 7:15am JST (1 year, 6 months ago) comment permalink

Thank you for your effort. I appreciate it!

— comment by Jogi on March 21st, 2015 at 10:18pm JST (1 year, 2 months ago) comment permalink

Is it possible in the folder status plug in to change the size of the box so I can include more columns horizontally. Thx. This is a really helpful plugin (and it successfully included my statuses as I moved to CC)

Unfortunately, Lightroom really limits plugins with regard to UI flexibility. If there are too many fields to fit in the width, it should automatically scroll, but sadly Lightroom doesn’t let the plugin just fill the width of the screen. )-: —Jeffrey

— comment by alan on April 26th, 2015 at 2:05pm JST (1 year ago) comment permalink

Excellent work as always Jeffrey, your Flickr/Facebook/Twitter plugins are an absolute must have for me. I keep banging on about them to all my Camera Club members.
I have just upgraded to Lightroom CC, so expect a whole bunch of donations again soon….

— comment by Danny on April 29th, 2015 at 4:40am JST (1 year ago) comment permalink

I am moving my lightroom to a new computer, how do I transfer my folder status program? I want to keep the information already stored in it. I am actually delaying the move until I find this out, I am 100,000 photos in my review (of 250,000 photos) and can’t afford to lose the info.

I love this plug in!

THANKS

Alan

Folder Status keeps its data in the catalog, associating the data about a folder with its path. If you copy the catalog, and the folder paths remain the same on the new system, then everything will just work out right. The plugin also writes data to each folder in the form of a hidden file (“.Lr-folder-status-plugin-data”), so if folder paths change, the plugin can revert to the hidden file to access current settings. —Jeffrey

— comment by alan on May 16th, 2015 at 12:12am JST (1 year ago) comment permalink

Hi,

Recently moved LR5 to a new drive almost everything came over except your plugin for Zenfolio. It says the “nil” file is not installed or working properly. So I decided to download a new copy of the plugin. Unfortunately it will not unzip. Whenever I click on the download file it just tries to open LR and import your logo. Any thoughts?
Thanks

It sounds like your browser automatically unzipped it for you, so just move it to where you want it to live on your system, and point Lightroom’s Plugin Manager at at. But, if it truly is a bad download, try with another browser. For reasons I’ve never understood, some folks have trouble with one browser but not another. —Jeffrey

— comment by Byron Capo on May 29th, 2015 at 12:25pm JST (11 months, 27 days ago) comment permalink

Hello,

I just installed the plugin ” timelapse support” , but I do not understand how to operate in lightroom .
I took a sequence of pictures, click plugin extra, fade developp setting, and then ?
I exported the pictures but nothing is corrected.

Thanks for your help, Phil

Yeah, sorry, I really need to write the docs. If you want to vary some develop settings (e.g. exposure) across a set of photos, make whatever adjustments you want for the first and last photos, then select those two and all the photos in between, then invoke the fade dialog… the plugin will incrementally adjust the settings you select, for the photos between the first and the last, to ramp them between the first and the last. —Jeffrey

— comment by Phil on July 1st, 2015 at 6:11pm JST (10 months, 24 days ago) comment permalink

I have tried everything I suggested and Zenfolio gives me no option to upgrade. Which I have already done and is living on my computer. It seems to be focused on an old version.
Really need this ASAP.
Thanks

I’m not sure what you’re saying (or asking?), but if you want to upgrade a plugin, just delete all copies that you might have on your disk, download a new version, unzip and move it to where you want it to reside on your disk, then point Lightroom’s plugin manager at it. —Jeffrey

— comment by aphra pia on September 8th, 2015 at 8:55am JST (8 months, 17 days ago) comment permalink

I just acquired a secondary laptop to complement my main desktop PC where Lightroom and your Flickr plugin are installed. I have installed Lightroom on the secondary laptop, and would like to install the Flickr plugin as well. (I recognize that I’ll need to register/pay for it and have no issues with that).

My question is: how can I copy the Flickr plugin settings from my main computer to my laptop so that I can maintain (or at least start with) the same configuration on both machines?

Thanks!

Plugin settings are kept in both the preferences file and, for Publish, the catalog. The preference file can simply be copied over, so that’s easy. To clone a catalog, just copy over the LRCAT file and when you open it on the new machine, remove all the images from it (just making sure that you’re not actually deleting images from disk that might still actually be available on the new machine, e.g. via a shared disk). If you want to register the plugin, you can just go ahead and use the same registration code as on the main computer, if your LR serial is the same as on the main computer.—Jeffrey

— comment by Eric on September 29th, 2015 at 2:25am JST (7 months, 26 days ago) comment permalink

Yesterday I downloaded and registered the plugin “Metadata-Viewer Preset Editor”. It is working. I made two metadata presets and saved them in the “Metadata Presets” folder. I know it’s the correct folder because it also has the two copyright custom presets that I made with Lightroom. The two new metadata presets have the same file type name.

But the presets do not appear in Lightroom. I tried putting copies at the root level for presets, i.e. the Edit-Preferences “Lightroom Presets Folder”. I also tried creating a folder named ” User Presets” in the “Metadata Presets” folder (as is found in some other presets folders but not others). None of these attempts worked.

The two newly created presets do not appear as presets in the Metadata panel. Am I doing something wrong?

Are you perhaps confusing two kinds of presets, one being “what metadata fields are to be shown?” (which is the kind of preset that this plugin works with; they are selectable via the dropdown menu in the “Metadata” section header), and the other being “update the image metadata with this specific data” presets (selectable via the dropdown menu at the top of, but still within, the “Metadata” section)? —Jeffrey

— comment by Richard Sweeney on November 17th, 2015 at 4:51am JST (6 months, 8 days ago) comment permalink

Dear Jeffrey,

Thank you so much for your help!!!

I managed to extract the JPEGS from Lightroom with the help of your plugin!!!

Brilliant work!!!

Regards.

Amelia

PORTUGAL

— comment by Amelia on January 6th, 2016 at 12:03am JST (4 months, 20 days ago) comment permalink

First, Thanks for this plug-in.
Secondly, I hate to complain, especially since I haven’t donated yet…but I get this error message.
“PicasaWeb does not accept “.dng” files for upload.”
I want to upload high quality pics. I want to donate too:) but this is a big deal to me.
Can anyone tell me why this is happening? I searched the error message but found nothing. I am using Lightroom 6.

Google’s 3rd-party API, that non-Google apps like my plugin must use, don’t accept DNGs. I’ve heard that Google’s tools do, so I guess they save those goodies for themselves. —Jeffrey

— comment by Eric on January 13th, 2016 at 3:33am JST (4 months, 12 days ago) comment permalink

using LR Facebook plugin – When I create a new collection under a publish service the name seems to be automatically prefixed with [photographer] – is there a way to modify this behaviour so I can either have no prefix or one of my own preference ?

If your account is permissioned for albums for more than one page (your personal albums, plus albums for a business page, shared groups, etc.), a prefix is sometimes applied so that you know which page the album is for. This is shown only in the list (in the Publishing Manager dialog), but shouldn’t show up in the collection name once the collection has been made. If it does, please send a log with full details. —Jeffrey

— comment by Kish Woolmore on March 8th, 2016 at 12:04am JST (2 months, 18 days ago) comment permalink

Greetings

I’m installing the Folder Watch plug-in. I don’t want it to import files that already exist in Lightroom (no duplicates). Is that a going to be a problem? If so, what do I do?

Thanks for your help.

Dave Stout

If a particular file is already in Lightroom it won’t be added again, but a copy of the file in a different location or with a different name will be imported. The Lightroom import dialog has an “ignore duplicates” feature that avoids importing copies, but Lightroom doesn’t export that functionality to plugins. —Jeffrey

— comment by David J Stout on March 8th, 2016 at 5:17am JST (2 months, 17 days ago) comment permalink

Hi Jeffrey. I am finding that in Lightroom CC (latest version as of 4/24/2016) running on OS X 10.11.4 (with 16gb ram), that when I update any of your four plugins I have installed, that after the update when the “restart Lightroom” message appears, my Lightroom locks up and requires a forced restart. Is this normal now with Lightroom CC? Thank you in advance for any help you can provide!

This is not normal… I’ve never seen this. When I do see something unexplainably strange like this, I wonder whether your Lr preferences file has gone bad. Perhaps reset your preferences, keeping your fingers crossed that it actually does fix whatever is wrong. —Jeffrey

— comment by Rich Harrison on April 24th, 2016 at 9:22pm JST (1 month ago) comment permalink
Leave a comment...

Please do not report bugs or other comments related to my plugins here. Please do those on the appropriate per-plugin page (linked from my Lightroom Goodies page).


All comments are invisible to others until Jeffrey approves them.

Please mention what part of the world you're writing from, if you don't mind. It's always interesting to see where people are visiting from.


You can use basic HTML; be sure to close tags properly.

Subscribe without commenting