Help DeskApps › How do I install or update the Lightroom plugin?

How do I install or update the Lightroom plugin?

Updated: 03/02/2015

Are you installing or upgrading the SmugMug plugin? Here's how to do it.

The recommended locations are normally hidden in both Mac OS X and Windows. To make them visible follow these instructions:

  1. Install Lightroom, if you don't have it. If you are updating an existing installation then you should quit Lightroom before updating the plugin. 

  2. Download the latest version of the plugin HERE.

  3. Unzip the plugin (your browser may have done this for you, leaving you with SmugMug.lrplugin).

  4. Move the SmugMug.lrplugin to your desired storage location, replacing your-username as appropriate.

    Recommended Locations

    • Mac OSX:  /Users/your-username/Library/Application Support/Adobe/Lightroom/Modules

    • Windows Vista / 7 / 8: C:\Users\your-username\AppData\Roaming\Adobe\Lightroom\Modules

    • Windows XP:  C:\Documents and Users\your-username\Application Data\Adobe\Lightroom\Modules

    The recommended locations are normally hidden by default on Mac OSX and Windows. To make them visible use these instructions: Mac OSX  or Windows. You may also need to create the Modules folder for a first time installation.

    If you install the plugin as part of the Lightroom application installation then automatic updates will likely fail and the plugin may not operate as expected.

  5. Start Lightroom.

  6. Select File > Plug-in Manager.

  7. Click the Add button.

  8. Browse to the location where you saved the plugin, and select it.

  9. Click Add Plug-in.

  10. That's it, the plugin should show that it's Installed and Running.

What's Different About This Version?

  • fix cornercases which may prevent galleries or folders from being created on SmugMug

  • add support for Private Sharing

  • refactor storage of local Preferences

  • Remove “A security vulnerability was fixed” dialog

  • add code to attempt to automatically fix the SSLv3 POODLE vulnerability on Windows

  • fix bug with revoked tokens not showing the correct status

  • improve image syncing with LR Smart Galleries

  • allow new galleries or folders to connect to existing object on SmugMug when the Custom URL is the same

  • in-app upgrade enhancements: improve logging, copy plugin to recommended location on read-only folder (Mac only)

  • add code to handle nickname changes more gracefully

  • fix cornercases for oauth_timestamp refused on OAuth flow endpoints

  • minor enhancement to photo digest generation

  • use a different method to determine Legacy status

  • add automatic correction for oauth_timestamp on uploads

  • add an option to include filenames as a keyword on upload

  • fix a bug that prevented accounts from authorizing

  • fix cornercase that deals with modified images that need to be reuploaded

  • add error handling for images over the megapixel limit

  • prompt users to resync their hierarchy on 404s during gallery/folder creation

  • fix cornercase where galleries may have legacy settings

  • fix minor image sync bug when searching on filename only

  • fix potential issue with keyword export when “Write Keywords as Lightroom Hierarchy” is not selected

  • fix issue with metadata that was causing “Assertion failed” during image syncing

  • migrate remaining legacy API calls to v2

  • tweak the image sync ranking algorithm

  • fix cornercase for image syncing with Canon 9000F

  • CC compatible release (installs to $userdatafolder/Adobe/Lightroom/Modules)

  • moved to use SSL for all API v2 requests

  • fix issue with video to small to render error being displayed erroneously

  • fix issue with reading API responses under error conditions

  • fix minor bug with experimental image sync

  • fix bug where "Show on SmugMug" displayed the origin album for a collected or smart gallery image

  • fix issue with single multi-word keywords on replaces being split into multiple words

  • fix cornercase with photo digest generation

  • fix issue with API response being too large during image syncing

  • show progress dialog earlier during image syncing

  • bug fix for LR3 users getting an error when creating/editing a gallery

  • fix minor bug for schema revision on upgrading from old API to new

  • Hierarchy syncing enhancement for folders

  • fix Windows compatibility issues with gallery feature image selection (LR4 and LR5 only)

  • Allow selection of unpublished images as feature image

  • Automatic plugin update improvements

  • add ability to set Feature Image for Galleries (LR4 and LR5 only)

  • Remove "Sync before Edit" option and make that the default option


  • fix error "attempt to index field 'pluginContext' (a nil value)"

  • fix image sync issue with NIKON cameras

  • change privacy setting names to reflect website

  • fix issue where stale album data may be overwritten locally in LR

  • fix quicksetting privacy issue

  • fix unsharp defaults

  • add metadata trigger for IPTC headline

  • add fallback support for IPTC headline when title is empty

  • added support for creating/editing/removing quicksettings

  • added support for editing/removing printmarks and watermarks

  • fixed issue where an error message was disabled when a comment was attempted to be added to an image in a gallery with comments disabled

  • readded "Rename" functionality for LR3 and LR4, due to an issue with the LR SDK

  • refactored hierarchy sync to use a single API call at each level of hierarchy, rather than two

  • fixed image sync issue for Canon CanoScan 9000F

  • fixed image sync issue where DateTimeDigitized was not being obtained correctly

  • fixed "system error" issue for replaces with legacy ImageUris

  • fixed "constraint failed" error during conflict resolution

  • fixed image sync cornercases for Pentax and HTC cameras

  • increased image retrieval response size for image sync and comments

  • fixed "constraint failed" error

  • fix image sync regression with Nikon cameras

  • fix a few more image sync cornercases

  • truncate album/folder text fields that are too long

  • fix the UrlName generate code to prevent multiple hypens

  • fix a hierarchy sync cornercase

  • refactor video error handling

  • add error handling for rendered videos that are too small

  • disable syncing for expired accounts

  • fix image syncing cornercase

  • proactively handle http 400 errors on album creation

  • bug fixes

  • fixed a few image sync cornercases

  • bug fix for LargestSize QuickSetting parameter being set incorrectly for Basic or Power accounts

  • fix error "An internal error has occured: ?:0: attempt to index a nil value" while publishing

  • add support for new Folder options

  • add support for Gallery Style for NeXT accounts

  • add support for Custom Sort Order

  • fix syncing cornercases to prevent items from being deleted inadvertently

  • fix cornercase for expired accounts

  • fix issue with custom messages not being displayed

  • fix logging so it always starts instead of having to reload the plugin

  • fixed bug where settings of a newly sync'd quick setting weren't applied

  • added warning dialog for when users have selected both filenaming and minimizing metadata

  • added a failsafe to prevent uploading if album creation failed

  • fixed bug where an internet connection message was shown instead of some other error

  • fixed bug with Basic accounts on the new SmugMug not being able to enable video

  • Added SortMethod and SortDirection for folders

  • Fixed bug where syncing images for a gallery removed images incorrectly

  • Fix issue with previously created folders/galleries with invalid "Custom URL" failing to be created

  • Remove Model and ISO as sync criteria for videos

  • Image sync improvements with various metadata changes for the new API

  • Allow existing unpublished folders/galleries to match existing items on SM when hierarchy syncing

  • Fix error "bad argument #3 to 'format' (number expected, got boolean)"​

  • Fix cornercase where the account nickname had been changed prior to schema upgrade resulting in invalid Uris

  • Auto-update release

  • Fix issue with allowing some illegal characters in NiceName/UrlName

  • Image sync improvements

  • Prompt to 'Sync Hierarchy' on accounts that didn't migrate correctly

  • Fixed error "An internal error has occurred: ?:0: attempt to concatenate a nil value"

  • Fixed image syncing with older metadata

  • Fixed issues where album creation was resulting in 400 (Bad Request) due to AlbumTemplateUri being sent

  • Fixed error "bad argument #1 to 'len' (string expected, got nil)"

  • Fixed JSON error for Windows users

  • Fixed a lot of issues :)

  • Fixed issue with removing images from a album, resulting in albums not being able to be republished afterwards

  • Fixed bug that prevented albums from syncing in the root

  • Fixed trimWhitespace error

  • Support for the new SmugMug
    Note: This version requires a schema update, so please ensure you have a catalog backup

  • Migrated to using POST for create/edit to prevent timeouts on some cornercases.

  • Fixed image sync bug where Camera Model might have trailing whitespace

  • Minor image sync improvements

  • Fixed a few UI issues related to Portfolio accounts

  • Add support for Portfolio accounts

  • Fixed corner case that caused uploading to stop when a file fails to render to disk

  • Fixed issue with comments not showing in local time

  • Fixed a logging bug

  • Image syncing enhancements

  • Added "Refresh..." option to Communities, Printmarks, Quick Settings, Themes and Watermarks dropdown lists on the Gallery dialog.

  • Fixed error "Attempt to index global 'logger' (A nil value)"

  • Support for MacBookPro Retina Displays

  • Fixed error "An internal error has occurred: recordPublishedPhotoUrl: must be called after recordPublishedPhotoId"

  • Increased video limit from 1.5GB to 3GB

  • Image syncing improvements

  • Improved uploading for slow connections

  • Bug fix for upgrading on Windows where profiles are on a different partion

  • Bug fixes

  • Fix for Unknown key "trimmedDurationInSeconds" error with LR4.0

  • Added the ability to sync hierarchy and photos from a category or subcategory (right-click the item and select 'Edit Category...')

  • Expose metadata triggers to users to allow customisation of when a photo get marked for republishing (see the Republishing section of the Publish Manager)

  • Allow users to either republish both the 'File and Metadata', 'File Only' or 'Metadata Only' when republishing (see the Republishing section of the Publish Manager)

  • Hold all the Conflict Resolution over to the end of the image syncing process

  • Support for Upload Key in gallery settings

  • Don't export map locations set as Private (requires releases later than LR4.1 RC2)

  • Support 'Remove Location Info' setting (see the Metadata section of the Publish Manager)

  • Improve handling of timed out video uploads

  • Enable syncing of videos using the 'Sync Photos' feature

  • Fixed keywording issue for single keywords that have multiple words

  • Added a dialog to indicate that you're up-to-date if no updates are available

  • Minor bug fixes

  • Fixed incorrectly built zip file that prevented automatic updating

  • Bug fix for GPS data not being exported with LR4

  • Minor bug fixes

  • Minor bug fix

  • Minor bug fix

  • Minor bug fix

  • Various bug fixes

  • Minor bug fix

  • Many bug fixes and enhancements

  • Improved comments retrieval

  • Fixed a bug that was causing published galleries to disappear from LR

  • Improved support for image uploading.

  • Improved error handling.

  • Improved upload retry policies.

  • Added support for Printmarks.

  • Fixed a bug that was causing the incorrect watermark to be selected.

  • Fixed a bug that was causing galleries to be created in the wrong category.