LR Backup Plugin
The LR Backup plugin simplifies backing up your Lightroom environment. It does this by adding the ability to backup Lightroom's configuration files, schedule a Lightroom catalog backup for next shutdown (LR4 only), and compress Lightroom's catalog backups from within Lightroom itself. These tasks can occur automatically as the program starts or manually as required. Suggestions for using these capabilities can be found here.
Lightroom's configuration is stored in numerous files scattered around your hard drive. The configuration backup collates the various preference, preset, template, camera profile, lens profile, Camera Raw and other setting files used by Lightroom into a single compressed backup file. This can help you quickly find and restore your preferred Lightroom configuration when your system crashes, Lightroom preferences become corrupted, or you wish to move Lightroom to a different system.
While Lightroom already includes the capability to backup your catalog the resulting files can be quite large and quickly consume your available disk space. Fortunately these backups compress well, frequently reducing to 10% of their former size when zipped. The catalog backup compression feature helps you automate this process and conserve space for your image files or more frequent backups to further reduce the risk of lost work. The offer to backup at next shutdown feature (LR4 only) also helps conserve your disk space, by allowing you to request backups only when you need them rather then scheduling them overly frequently to minimise risk.
Automatic backup tasks are performed in the background as Lightroom starts. Regularity can be independently managed for each backup task so it is a simple matter to compress each catalog backup immediately at startup yet only backup your configuration once a week.
The plugin is compatible with Lightroom 2 and above.
Payment and Updates
The trial version does not execute automatic backup tasks at Lightroom startup and instead displays a notice to indicate when an automatic backup would have occurred. Donating to the plugin via the Photographer’s Toolbox will give you a registration code that will remove this notice. All future updates are free.
[…] Lightroom plugins add new menu items to the Lightroom user interface. Examples include my own Config Backup plugin, those from the prolific Jeffrey Friedl (the grandmaster of Lightroom plugin development) and […]
I can’t for the life of me figure out how one would manually trigger a backup (i.e. without relying on the broken backup stuff currently in LR2). Hint?
@Wade, The only official way to kick off the backup is to use Edit -> Catalog Settings -> Backup Catalog: Next time Lightroom starts only. Restart LR and then after backup completes, reset to the weekly (or whatever) setting again. i.e. the only official way is impractical.
In reality you might as well just write a script to check LR isn’t running, copy the catalog file to a subdirectory named using the same layout, and zip the result. That would be the only automatic way I can think of to perform the equivalent of the LR backup functionality without consuming too much space.
Does that answer your question?
PS Keep up the good work with those Lightroom Tuesdays!
what’s about presets?? i’ve a lot of them and it would be serious when they are not backed up. (i personally use a scheduled rar-skript for presets and catalog)
@Sven, you’ve just beaten me to the punch. I have an update ready to publish that backs up presets etc. I just need to update the web page content (inc screenshots) to align with the change in functionality. Hoping to get it up on the site tonight.
Oh, too bad.
I was hoping this would do this.
BTW, I worked on the lightroom team and one of my pushes for 2.0 was to overhaul the backup – obviously it didn’t make it as other things took priority.
Hope they get to it this time…
[…] recently released Config Backup plugin helps you backup your Lightroom configuration files and compress Lightroom generated catalog […]
@Sven, the updated plugin is now referenced above and it backs up presets and other configuration details.
[…] Newer version(s) of this plugin are now available. Please visit the Config Backup plugin page to download the latest […]
@Wade, there are no hooks provided by the SDK to trigger backups from a plugin, and to backup the database while open would be dangerous. The only other mechanisms available would be frowned upon by your former colleagues e.g. modifying the prefs file directly to trick the Lightroom backup mechanism to run at the next restart.
Will be interesting to see what they do with backups during LR3. I’m half hoping they borrow ideas or code from this plugin because they can take them further given they aren’t hampered by the limitations of the SDK.
I figured as much. I hope they get to an on demand backup – I’ll sit while they close and back it up. No sweat.
Of course, I’m out of the loop now 😉
Thank you! This is very useful and will save me a ton of disk space.
I’ll make a post about it on my blog and reference your blog. There’s a lot more information here I have not read yet.
Have you found any utility to the Lightroom “test integrity of this catalog” option when backing up? Does it do anything useful? Does it repair the catalog if it finds errors?
Thanks again from Bangkok, Thailand.
@Ian, glad you find it useful.
I use the “test integrity” option but haven’t looked too deeply into how it works. When making backups you should verify their integrity before relying upon them. I expect this option makes sure it is still a valid sqlite3 database and might do some LR specific checks to confirm the structure looks OK. I’d be surprised if it repairs issues. Relaunch and Optimise is more likely to tackle that requirement, and it takes a fair amount of time to run.
[…] Photo Geek z rovnomenného blogu je autorom šikovného pluginu pre Photoshop Lightroom, ktorý zabezpečí zálohovanie nastavení tohto programu. Zálohujú sa teda všetky presets, šablóny pre úpravu, tlač a export fotografií, zoznamy kľúčových slov, šablóny webových galérií. Dobrá správa – plugin pre Lightroom je k dispozícii zadarmo. […]
[…] Config Backup Plugin | The Photo Geek. I quote from the web site: The Config Backup plugin helps speed up and simplify backing up and compressing Lightroom files. It adds two new menu items to the File menu’s Plug-in Extras sub-menu. […]
[…] Plugin para backup no Photoshop Lightroom. O tutorial é em inglês, mas tem figuras! lol […]
I suppose that backups are not platform interchangeable. From Lightroom on OS X to Lightroom on Vista for instance. Am I correct here?
I guess Lightroom on Vista has no clue what a .plist file is …
Thank you for any clarification!
Thomas
@Thomas, Correct the preferences file backup won’t be interchangeable between platforms. It looks like the .plist preference files are a Mac platform specific feature. I expect it would be difficult to build a translator between the two, and Adobe would be unlikely to support you if you were running Lightroom over a converted preference file. As it is one of the possible resolutions suggested for problems is “delete your preferences file”…
The rest of the backup (presets, etc) should be interchangeable but you will need to unpack the zip in a temporary location, then carefully move the unzipped backup’s content into the correct location for that platform, directory by directory. Preference file directory structure varies across platforms.
All I get are “Error: Failed to create backup (return=1)” results for both backup and compress attempts. I’ve “browsed” to ID valid directories for each, and there’s plenty of disk space. Any suggestions?
@TW, what OS are you running this under? I’d assume this is a configuration problem but sounds strange because that return code implies a successful backup file test (with some warnings). Did you check whether the backup file was, in fact, created? If it was created could you open it OK using your normal zip application?
[…] nisto, o pessoal da The Photo Geek criou este plugin, muito simples e de grande ultilidade. Vale a pena seu […]
Using WinXp SP3, LR works fine, as do all other plugins. No, no backup files have been created, and box on your plugin’s screen is empty when the error message appears (in red type). Any ideas?
@TW, I’ve sent you an email requesting certain info. I’ll look into this offline as this might be a bit difficult to debug via blog comments.
Does Config Backup work with LR 64bit on Vista 64bit?
Seeing some strange behavior. Had a directory of 58 backups done by LR, after compression I have two compressed files.
The config backup directory is another issue. I create one or not but when plug-in runs there is one that is set with an unknown owner, and I can’t access it, but gets deleted along with contents if there were any when LR is exited.
Cliff
[…] a reminder from Lightroom Killer Tips about The Photo Geek’s Catalog and Preset Backup […]
@Cliff, I’m pretty sure Sean (one of the first users of the plugin) is using 64bit Vista because we originally thought one of his issues related to that. Its working OK for him so I believe it should work OK on Vista 64 bit.
The issues you are describing haven’t been reported before. Out of curiosity are you using LR2.4? There have been some reports of issues with plugins installed using this version. Can you please try uninstalling and reinstalling the plugin to see if that helps? I know it sounds trite but it really did help one of my colleagues when plugins misbehaved soon after installation.
UPDATE: It has been confirmed that some Config Backup users are successfully backing up with 64-bit Vista and 64-bit Lightroom (2.3). Will keep looking into the issue though.
[…] Config Backup Plugin | The Photo Geek. […]
@Cliff, Just confirming the results of our testing. The plugin functions properly on Vista and Lightroom 64 bit. I will be improving directory validation in the dialog, to prevent users from setting the compressed directory to be a child of the directory being backed up. Also will be adding some “plain English” error codes so users can now what the zip program was complaining about.
Hello,
Fisrt of all THANKS for your great plugin.
I have a question “How can I change the config base directory, as my \Adobe\Lightroom is not on C:???”
Thanks for your help read you soon
Greatings from Switzerland
Phil
@Philippe, The plugin asks Lightroom where its configuration base directory is so there shouldn’t be a need to configure this. Lightroom should know where it is reading its configuration from. Are you saying this isn’t working on your system? Are you storing your presets with your catalog or using the default setting (storing presets centrally)?
[…] had a backup of the file in a ZIP archive stored by my Config Backup plugin (http://www.thephotogeek.com/lightroom/config-backup/). I restored that file and everything was back to normal. It seems that Jeff Friedl stores plugin […]
[…] had a backup of the file in a ZIP archive stored by my Config Backup plugin (http://www.thephotogeek.com/lightroom/config-backup/). I restored that file and everything was back to normal. It seems that Jeff Friedl stores plugin […]
[…] een handige applicatie om iets te bereiken buiten Lightroom om. Twee in het oog springende zijn de Config Backup plug-in die je in staat stelt de Lightroom voorkeuren en de Catalogus te backuppen. Preview Extractions kan […]
Version 1.04 of the plugin has been released. It includes the ability to automatically schedule backups and compression of backups. The configuration backups have also been extended to include Camera Raw settings that Lightroom relies upon, including camera profiles and lens correction profiles. It also resolves an issue that caused LR3’s preferences file not to be backed up on OS X, so is a highly recommended upgrade on this platform.
LR Backup sounds perfect but I didn’t see instructions on how to restore everything when my drive crashes and I’ve just re-installed Lightroom. I’m on Windows 7 64bit.
Thanks,
Tom
@Tom, I have a draft post written on how I’ve setup LR Backup for my own usage and expect to have that out this week. The restore one will be written after that.
The short restoration description is the files are in a zip and need to be manually restored (unzipped) to the correct location for your operating system. I’m resisting the temptation to automate this because in some cases you might only have a partial corruption (e.g. accidentally corrupted a bunch of presets but not the whole configuration) and restoring the complete backup would not be advisable. As you’ve suggested I need to write up some guidance to help people understand what they should do when it all goes “pear shaped” and they need to rely upon the backups. Thanks for the reminder!
I have installed the plugin and Run Manual Backup. The Config files have been backed up fine, but when trying to compress Lightroom’s catalog backups nothing changes. The Backup Directory is set to the right place, and below it correctly states the number and size of backups it has found there.
The Compressed Directory is set to a new empty folder, but then when I click OK the status briefly changes to “Compressing backup of ()” before closing. The compressed folder remains empty.
Am I missing something?
[Running LR 3.4 on Win XP]
@Brian, That briefly changing status indicates your backup files do not follow the standard layout. The backup folders must exist directly below the Backup Directory nominated. If there are any intervening directories it will not work as the code currently stands. I’ll need to add some more error checks in that portion of the code to explain what is happening in this set of circumstances.
When I click on File/Plugin Extras/1-click Configuration Backup, the backup failed to run. Using LR3.4, Vista Home. The following is from the log file:
Plug-in error log for plug-in at: C:\Users\Don\Documents\3rd Party Software\Lightroom\Plugins\config-backup-20090606_002\config-backup.lrplugin
**** Error 1
An error occurred while attempting to run one of the plug-in’s scripts.
bad argument #1 to ‘pathComponents’ (string expected, got nil)
**** Error 2
The plug-in encountered an error when performing the menu item “&1-Click Configuration Backup”.
bad argument #1 to ‘pathComponents’ (string expected, got nil)
Thanks for the help.
@Don, You are running an older version of the plugin. The plugin has received significant updates in the past month or so and it would be advisable to try that before investing too much time with this issue. The 1-Click Configuration Backup menu option no longer exists as the whole process can be configured to automatically run at startup.
@Matt – the backups are as created by LR by default – in the Backup Directory the backup folders are then in the format ‘yyyy-mm-dd hhmm’ with the backup .lrcat in each folder. As I noted above , the plugin is recognising that they are there.
@Brian, I’ll need to look into this. The catalog detection and compression functionality are related but not identical, so it is possible that the detection code isn’t quite as rigorous in checking the backup layouts are 100% as expected. If there are an opportunities for differing results I’ll close them down as it is a nuisance when trying to debug issues like this.
Matt – I just installed this plugin and ran a manual backup. I notice that the paths are not being updated in the UI even thought I have made my own selections. The browse button does take me to the folder I previously choose. LR 3.4, MacOS 10.6.7, LR Backup 1.05.
I have a slightly unusual setup with my Mac “Users” on a separate disk. I use a symbolic link at /Users -> /Volumes/DataDisk/Users make this work. That hasn’t caused any problems for a long time (10.1 days) but might be contributing here.
@Louie, Thanks for reporting your experiences. I’ll have a look into this issue and see if I can reproduce it.
For those using an older version of the plugin, or who have auto-update disabled, please note that a new version of TPG-LR-Backup was released earlier this week. Most of the improvements are around robustness and detection (and provide guidance for resolving) of issues with plugin configuration. Hopefully it has resolved a number of the issues discussed above!
Matt, I installed the latest TPG-LR-Backup on my iMac, OSX Snow Leopard. The backup works for the LR Configuration files but appears to not backup the LR Catalogue(s). I wonder if I’m doing something wrong? The Catalogue files are in the default LR location on my hard drive.
@Phil, Apologies for the delay in replying. The plugin compresses your existing catalogue backups rather than creating a backup itself. If you go into either the automatic or manual backup menu item you will find a field for specifying where the catalog backups created by Lightroom live. Once you set this up correctly the manual backup dialog (and I think the automatic one as well) will show you how many backups it found there, to give you some assurance the plugin configuration is OK. Next time the compress catalog backup function is executed the backups created by Lightroom will be compressed and moved to the location your specified.
Matt,
I have been manually compressing the cat file for a while and seem to get a better compression ratio using WINRAR than your plugin does. Any chance that the config could allow a user to select their own compression exe and preferences.
Windows 7 64 bit LR 4
Lrcat file 799,404Kb
Winrar 47,053KB
LR-backup 71,394Kb
Great idea though….
@Mike, I’ll add it to the feature request list. I’m using zip for compression because I can have a common zip version across Windows and Mac. Users don’t need to download any extra software and the plugin requires only minimal configuration. The trade off for this simplicity is zip isn’t quite as efficient as WinRAR, 7-zip, or a number of other compression formats. I’ll see about adding a spot for you to enter your own command line but I need to be careful to do this in a way that is compatible with some upcoming features.
[…] TPG LR Backup plugin was created to help resolve these backup limitations. It reduces the disk space consumed by […]
Thanks Matt,
As a retired software engineer I understand the issue and appreciate your time and work on this.
Matt, Thanks for the reply from Jan. 15, 2012. And thank you for the LR Backup Plugin! Finally, I got the Catalogue backup portion to zip my LR catalogue backups. Not sure why but evidently I wasn’t telling the plugin the correct place to find the catalogue backups, but it’s doing fine now.
@Phil, Thanks for letting us know the plugin is configured correctly and working for you now.
[…] I’ll direct you to Matt “The Photo Geek” Dawson‘s great plugin LR Backup. Not only will this grab all of those little Lightroom bits it also solves the issue of the ever […]
Scratch all of thr above. I got it to work. I messed up the extract somehow. All good now. Seems to work well… Thanks!
@Kevin, glad to hear you managed to work through your installation hiccup OK. Please let me know if you have any other questions.
I downloaded the plug-in, made the donation, but the app
is still greyed out in the plugin-manager. Have to install
a new hdd and os soon, so getting this sorted out is important.
[UPDATE Nov 13: @Dale, thanks for confirming the steps below allowed you to resolve the issue.]
@Dale, Thanks for your support.
The plugin being greyed out is not due to a missing registration code. It should be caused by one of two things:
1) The plugin you’ve added might not have been unzipped correctly or the wrong plugin folder was added via the Plug-in Manager. The plugin files should be in a folder called TPG-LR-Backup.lrplugin , and a file Info.lua must exist in that folder. Sometimes people end up with two TPG-LR-Backup.lrplugin folders nested one inside the other, which can be a problem if the outer (not inner) folder is added in the Plug-in Manager.
2) The plugin is disabled. The button to enable the plugin is in a sub-section towards the end of the Plug-In Manager entry for TPG-LR-Backup. You might need to expand the second last section in the dialog to see the button.
Hope that helps.
Just wanted to say congratulations. Two of your plugins (including this backup plugin) were mentioned in Matt K’s Lightroom magazine in his list of five favorite plugins. Nice!
@Eric, Thanks! I really appreciate you pointing this out. As an Android user I can’t access the Lightroom magazine so was unaware of the mentions.
[…] das jetzt alles zu aufwendig ist, es gibt auch ein Plugin, das Einstellungen pp. aus Lightroom sichern […]
Can’t purchase anything … Photographer’s Toolbox down?
@Jonathan, To the best of my knowledge Photographer’s Toolbox hasn’t been down. We will need more information to diagnose the specific issue you are reporting. I’ll email you offline, but in the interim I’d suggest trying again.
When I attempt to automatically apply the update, I get the message that it cannot create a folder. My account does have admin privileges. What is the solution? Thanks!
@Dick, There have been occasional reports of errors like this for a while now. Very difficult to track down the cause. If you retry the update straight afterwards it often works.
You can manually restart the update from plugin manager using the update section on the entry for TPG-Lr-Backup.
If this still doesn’t work after an attempt or two, you will need to manually perform the update instead.
@Matt, LR-Backup stopped working after installing the latest (1.14) update. I went back to 1.13 and it is working again. When I try to run manually I see the progress dialog box flash briefly and I’m return immediately to LR. No error messages and I can’t find any log files or how to turn one on.
Just a SWAG but I’m thinking that it may have to do with the zip being imbedded. My whole Application Support/Lightroom is in a DropBox folder (using symlink) to allow sharing setup and configuration between desktop and laptop.
MacOS 10.7.5, LR 4.4
@Louie, Yes, sorry, the Mac build of v1.14 has an issue. I’m working on a fix right now and hope to have v1.15 out in the next 24 hours.
v1.15 was just released. It should resolve the issues reported by @Louie.
Thanks it works. FYI the version still shows as 1.14 although the build is updated.
@Louie, Thanks for the update. I’m sure the version number glitch is a temporary display issue and should correct itself after a restart.
@matt, Not a biggie but somewhere in the last several releases you are no longer deleting the folder that contained the original LR backup files. (MacOS 10.7.5 LR 5.2)
@Louie, Thanks for pointing this out. v1.17 will be released soon and it will resolve this issue.
Matt — Lightroom Classic 9 backs up each catalog into a unique folder in a compressed format. I typically backup my after each day of use. When TGP LR backup runs on the next startup, it doesn’t find an uncompressed catalog file to process as part of the “Automatically Compress Existing Lightroom Catalog Backups.” What am I doing wrong?