AutoReplace A Lightroom Plug-in User Guide
Contents
1. suggest limiting the number of codes within a single file to twenty five or fewer The number of code files that AutoReplace can handle at any one time is essentially unlimited Here is a screenshot of a code file being edited in a spreadsheet program AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 20 of 33 A B Eis fe BYRNE of ASM Clermont Auvergne cid itiveni SIVIVATU of ASM Clermont Auvergne ci3 Regan KING of ASM Clermont Auvergne ci2 Wesley FOFANA of ASM Clermont Auvergne P Ww pe Figure 21 Editing a code file in OpenOffice In this case if for example the text t15 is entered in monitored field it will be replaced by Geordan Murphy of Leicester Tigers Hint If a squad list is cut and pasted from a team website into a spreadsheet pro gram the squad list will almost certainly be in the required format To save the code file in the required format ensure that you select csv Comma Separated Variable or simi lar as the file format when saving the code file To save the code file in OpenOffice select the File gt Save as csv as the value in the file type combo box as shown below menu item and select Text csv AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Save i _ ooo eO Save As London Irish a 3s m im Gj2. You should avoid it The structure of a AutoReplace code file is very simple each code replacement pair is defined on a single line The code and replacement texts are separated by a delimiter Currently the permitted delimiters are commas and tabs An individual line within a code file must use either comma or tab as its delimiter but you may freely switch between the two on different lines within the same file For example t1 John Smith defines a code replacement pair in which every instance of t1 will be replaced with John Smith A delimiter at the end of the replacement text is optional If AutoReplace finds a tab anywhere on the line it uses tab as the delimiter for that line Otherwise it uses the comma Note spreadsheet programs appear to be particularly sensitive to whitespace at the begin ning of fields You should avoid it For example if the line in the example above had read t1 John Smith then the replacement text would be John Smith instead of John Smith This is nota problem with text editors Although it is not essential recommend that both the code and the replacement texts are enclosed in ei ther single or double quotes To reduce the possibility of error suggest using double quotes to avoid con fusion with an apostrophe within the replacement text The number of code replacement pairs in a code file is unlimited However due to the current restrictions of the Lightroom plug in UI
3. Auto Replace dialog boxes previously marked Do Not Show Check for newer version of tb Auto Replace via the internet Update plugin to newer version must be downloaded amp unzipped already Show log file using default app Clear log file by moving it to trash Report problem with th Auto Replace to Tile Barn Photographic Verbose Logging Uninstall Figure 7 The tb AutoReplace section of the AutoReplace management panel Buy tb AutoReplace Reset Warning Dialogs Check for update Update plug in View logs Clear logs Report problem Check for updates upon startup Verbose logging Uninstall Registration Takes you to the purchase page of the tilebarn com website where you may use PayPal to purchase a registration code for AutoReplace Several dialogs in AutoReplace include a Don t show this to me again option If you ve selected any of thses options clicking on this button will display them again Queries the tilebarn com website to see if there s a newer version of AutoRe place available AutoReplace can also check for updates automatically each time Lightroom starts if you click the Check for updates upon startup check box at the bottom of this section Automatically installs an updated version of AutoReplace For more details see Updates on page 25 below Opens the AutoReplace log file in your default text file editor Deletes the AutoReplace log file In the unlikely event that you run into a prob
4. Plug in Author Tools section is helpful only in the case of a problem so hopefully you ll never need it YF Plug in Author Tools Reload Plug in _ Reload plug in on each export Recommended for plug in authors only Save Diagnostic Log to File No diagnostic messages Figure 18 The Plug in Author Tools section of the management panel If AutoReplace falls over with a fatal error the number of error messages will appear here andthe Save Diagnostic Log to File button will be enabled If you find yourself in this situation please save AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 18 of 33 the diagnostic log it s a simple text file and send it to me with a description of what you were doing at the time This will help me find a solution for you The Reload Plug in button simulates Lightroom being started from scratch This differs from AutoRe place s reset required in that resetting the plug in simply reloads the active code files can t think of a situation where reloading AutoReplace would be helpful in normal circumstances But if you can think of an example please let me know Preset Manager The Preset Manager section of the management panel is common to all plug ins built with Rob Cole s Elare framework It allows you to save frequently configurations so that they can be selected with a single click of the mouse rather than a circuitous journey around all the plug in s options Y
5. Rugby Union qQ FAVORITES Name Date Modified Size Kind fet john E Backups 11 04 11 Folder E Desktop 2 Leicester Tigers csv 11 04 11 999 bytes Co lues E Analicat London Irish csv 11 05 11 1 KB Co lues y Applications Northampto ts copy lua 11 04 11 2KB _LUA rce ee Documents Northampton Saints lua 11 04 11 2 KB LUA rce DEVICES LJ MacBook Pro ea BOOTCAMP File type Text CSV csv Automatic file name extension Save with password Edit filter settings New Folder Cancel Save Figure 22 Saving a CSV file using OpenOffice Note the default location in which code files are saved is in the Codefiles folder within your home folder However they can be saved anywhere on any disk that is available to the current user Note Some users have reported difficulties when creating CSV files using spread sheets such as OpenOffice or Excel code replacement simply does not happen de spite the code file being correctly formatted The problem appears to be that the spreadsheet software prepends non printing control characters each line of the csv Page 21 of 33 file This confuses AutoReplace Consequently recommend that you use a plain text editor to create your code files Alternatively you can fix affected CSV files by simply opening them in a plain text editor and then forcing a save The Code File Manager Efficient management of code files is the key to successful use of AutoReplace You may define as man
6. email Re registration after upgrading Lightroom As previously explained you registration code is tied to your Lightroom serial number If your Lightroom serial number changes then so will your AutoReplace registration code After a major version upgrade to Lightroom click the Get upgrade code button to obtain your new registration code will provide this free of charge Note A major version upgrade is from say Lightroom 3 to Lightroom 4 Upgrading a minor version upgrade from for example Lightroom 3 4 to Lightroom 3 5 does not require a new registration code Note If you intend to run different major versions of Lightroom on the same computer Au toReplace can be fully licenced for only one of them It will run in trial mode in the other ver sion of Lightroom You can choose the Lighroom installation tin which to run the full version of AutoReplace but you must choose one Even if you purchase a second AutoReplace regis tration code it will not be possible to run the full version of AutoReplace in both major ver sions of Lightroom Lost registration codes You should have received an email containing details of your registration code after each purchase from tilebarn com If you have mislaid your e mail or if you need to retrieve your registration details for some other reason and then simply enter the email you used to make your purchase in the Email text field and click on Send registration code reminder button An e
7. running Is AutoReplace enabled The simplest way to see if AutoReplace is running is to check the Status section of the plug in management panel Open the Plugin Manager menu item File gt Plug in Manager and select tb Auto Replace in the left hand panel Find the Status section If it s expanded look at the last line of text It should read either Status This plug in is enabledor Status This plug in is currently disabled AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 27 of 33 YF Status L Path Volumes Clients lightroom tb AutoRepla oReplace_LrPlugin_0 5 AutoReplace Irplugin Show in Finder Web Site http www tilebarn com lightroom AutoReplace Yersin eee 30 09 36 05 Status This plug in is enabled Enable Disable Figure 35 Checking if AutoReplace is enabled when the Status section of the management panel is expanded If the Status section isn t expanded the plug in s status is reported in the right hand side of the section banner E Plucinis enabled A ml bli ee b Status Figure 36 Checking if AutoReplace is enabled when the Status section of the management panel is collapsed If the plug in is disabled expand the status section of the plug in management panel if you haven t done so already and click the Enable button Has AutoReplace finished initializing Look at the top left hand corner of the main Lightroom window If you see the AutoReplace Starting Up messag
8. the destination folder isn t empty or if an existing file will be overwritten by the back up you ll be asked to confirm your decision When the backup is complete you ll be told how many code files were backed up If any errors occurred during the process you ll be told about that too AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 16 of 33 Info oO Auto Replace has something to Say Successfully copied 32 code files to Volumes Users Users john Desktop testing OK Figure 14 Confirming a successful code file back up Clicking the Import button reverses the process Question I ve included this feature primarily as a workaround to help get round the problem of the failing auto update process Once auto update is working will it be worth keeping backup available or is it then redundant Fields to process The EXIF and IPTC fields that AutoReplace is currently monitoring for codes are listed under Fields to pro cess The monitored fields may be changed by simply checking the boxes to the left of the metadata fields that you wish to monitor and uncheck the others Fields to process Til title Til caption headline label copyName creator creatorlobTitle creatorAddress creatorCity creatorStateProvince creatorPostalCode creatorCountry iptcSubjectCode creatorPhone creatorEmail creatorUrl descriptionWriter ipteCategory iptcOtherCategories dateCreated intellectualGenre scene location city stateProvince count
9. 04 44 Folder a Desktop gt iS Developer 3 2 6 21 Mar 2011 12 18 Folder eT john Eye One_Pro_2009 06 28 log 28 Jun 2009 07 50 5 KB Log file wos Applications gt ij Library 13 Nov 2011 04 47 Folder Figure 31 Part of the upgrade selection dialog Once you click on OK you ll see a standard progress bar You may need to wait a few seconds for the up grade to start but don t worry once it does it runs very quickly the progress bar rarely has time to report any progress before the update is complete Updating plugin Copying files f Cancel Figure 32 The Update plug in progress dialog When the update has completed you ll see a dialog which reports the location of the log file that describes what happened during the upgrade Info Li Auto Replace has something to say Update log file is Volumes Users Users john Documents com tilebarn lightroom AutoReplace_20120103155730 log OK 7 Figure 33 The update log file and then confirmation that the update has succeeded AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 26 of 33 Info o Auto Replace has something to Say tb Auto Replace update successful either reload plugin see plugin author section or restart Lightroom now Figure 34 Confirmation of a successful update Licensing The process of obtaining a licence key for AutoReplace is described in Registration above A full AutoRep
10. AutoReplace A Lightroom Plug in User Guide Version 1 2 Tile Barn Photographic www tilebarn com Last updated August 2013 AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 1 of 33 Contents MO O e a E E E 4 POW AROR DI CEWOTK arrene E E E E 4 Multiple code replacements vesetcce te cctstetctatacecacetadetadecetesadetedetedadaccdadeiatadetsantetadetededeteiadeiadatatecetedodsbetabeses 4 VON a E E E a eeemeep sees oee sepamenapeeeuennsenaneeseecepenecenacenaueuens 5 Miended audiente eers p rere E re ee ee ee 5 FUT O E R 6 Changes from previous versions ccceccseccseccsecenccseccecceuceseccneceuceeceseeeuceeceeeeeucteeeeseeeuetseeeeeeeuctseeeseeeueteeeaaes 6 POWYS ION A a E 6 NOW IVO OA aE A E 6 EES Ue cc E E E E E E E E T 6 PESENE p A E E E E E 7 S E E E 9 OLN cl AE ec a e E E T 9 TAO PUEN MONEO aeiia AAAA AIARA AAAA 9 EAVORE DIOC Oa E E O ee re ee eereereereee 11 Reer aO e a E E E E AA E E E a 11 Using AutoReplace to purchase a registration COdC cccceccssccsecceecceceenceseceseceuceseceseeeueeseceseeeueeseeeees 12 Purchasing AutoReplace using other Methods ccccccseccscccsccseccsecenceeceseceseeeueeseceseeeuctseceseeeuceseeeees 13 Re registration after Upgrading Lightroom cccceccesccsscceeceseeeccseceseceuceseceseceuctsecesceeuetseceeeeeueeseeenes 13 Lost FOSS Cire 1 COC CS ices te cerca sens sane ceca cannnncececacadaaecadedetececadasedatacauatedadadedateaetacatanadedadadatadadace
11. F Preset Manager Enter preset name to be created if not already existing else loaded Select Preset Select name of preset and load settings Delete Preset Delete settings associated with the named preset Load Defaults Reset settings for this preset to factory default values Edit Advanced Settings Edit plugin configuration file corresponding to named preset Reload Advanced Settings Reload recently edited preset support file Figure 19 The preset Manager section of the AutoReplace management panel So if you had say one set of code files that you always use with one sport and a complete different set that you use with another you could define one preset with each and then easily switch between them To save your current settings as a preset simply type a name in the text filed at the top of the section The name is arbitrary and any keyboard characters are permitted To change to an existing preset click on the Select Preset button select the required preset from the combo box that appears and click the OK button To delete the current preset you won t be surprised to learn that you need to click on the Delete Pre set button Note Deleting the current preset doesn t alter your current settings Nor does it delete any code files associated with the preset To return to the straight out of the box state of AutoReplace click the Load Defaults button This will result in the following settings Search pattern Fi
12. Figure 1 Adding a plug in in the Plugin Manager Navigate to the folder containing the AutoReplace 1rplug in file select it and click on the Add Plugin button Also you will only be able to do a complete uninstall of AutoReplace including the deletion of all plug in specific settings if you install the plug in in the default user specific plug in folder On the Mac this is Library Application Support Adobe Lightroom Modules and on Windows 7 C Users username AppData Roaming Adobe Lightroom Modules This is a limitation of the framework on which AutoReplace is built AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 7 of 33 AOOO Add Lightroom Plug in si FAVORITES ame Date Modified ey john AuUTORe place LICENSE txt 4 Nov 2011 17 55 AuUTOReplace Irplugin 4 Nov 2011 17 55 n Desktop AutoReplace README txt 4 Nov 2011 17 55 PAN Applications ae Documents DEVICES LJ MacBook Pro BOOTCAMP Figure 2 Adding the AutoReplace plug in file to the Plug in Manager You should now see AutoReplace added to the list of Lightroom Plugins with a small green dot glowing to the left of its entry indicating that the plug in is installed and running If you see an red amber or grey dot beside its entry please see Troubleshooting on page 27 below Add Re move Figure 3 A green dot indicates that AutoReplace has been successfully installed When you first install th
13. Plug in Manager See Registration on page 11 for more details New in version 1 1 e Support for Lightroom 4 on Windows AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 6 of 33 e Support for code files using tab as well as comma as a delimiter This should aid with the import of code files produced by other systems such as codereplacements com Installation Installation of AutoReplace follows the standard model for Lightroom plug ins Download AutoReplace and save the AutoReplace 1rplugin file anywhere on your computer In Lightroom the default location for plug ins is defined as follows Mac OS Current user Library Application Support Adobe Lightroom Modules All users Library Application Support Adobe Lightroom Modules Windows XP C Documents and Users username Application Da ta Adobe Lightroom Modules Windows Vista amp C Users username AppData Roaming Adobe Lightroom Modules Windows 7 Table 1 default plug in locations 1 Not confirmed for Lightroom 4 or 5 You are free to install AutoReplace anywhere on your computer However recommend that you install AutoReplace in the default location By doing so you will be able to take advantage of the automated up date and uninstallation facilities that AutoReplace provides 1 Open Lightroom 2 Clickthe File gt Plug in Manager menu item 3 Click the Add button in the bottom left hand corner of the Plug in Manager window Add Remove Plug in Exchange
14. Wesley FOFANA of ASM Clermont Auvergne is tackled by Geordan Murphy of Leicester Tigers during the comp match between ht and vt at venue 2011 12 30 13 01 15 0000 DEBUG Processing TigersClermont_20111217_ 134435 2264 jpg 2011 12 30 13 01 15 0000 DEBUG title has initial value 2011 12 30 13 01 15 0000 DEBUG No placeholders found No changes made 2011 12 30 13 01 15 0000 DEBUG caption has initial value 17 12 2011 Leicester England Wesley FOFANA of ASM Clermont Auvergne is tackled by Geordan Murphy of Leicester Tigers during the comp match between ht and vt at venue 2011 12 30 13 01 15 0000 INFO TigersClermont 20111217 134435 2264 jpg caption is now 17 12 2011 Leicester England Wesley FOFANA of ASM Clermont Auvergne is tackled by Geordan Murphy of Leicester Tigers during the Heineken Cup match between Leicester Tigers and ASM Clermont Auvergne at Welford Road 2011 12 30 13 01 15 0000 DEBUG Processing TigersClermont 20111217 134435 2264 jpg 2011 12 30 13 01 15 0000 DEBUG title has initial value 2011 12 30 13 01 15 0000 DEBUG No placeholders found No changes made 2011 12 30 13 01 15 0000 DEBUG caption has initial value 17 12 2011 Leicester England Wesley FOFANA of ASM Clermont Auvergne is tackled by Geordan Murphy of Leicester Tigers during the Heineken Cup match between Leicester Tigers and ASM Clermont Auvergne at Welford Road Figure 41 Detailed reporting of a recursiv
15. anel There is no need to define a code replacement pair before it is used in a recursive replacement For example home 1t 1lt Leicester Tigers is valid However if two or more code replacement pairs share the same code then the replacement text that is defined last is the one that will be used AutoReplace does show a warning message in this case Multiple code replacements The example above illustrates the simplest use of AutoReplace It is also possible to associate multiple re placement texts with variants of a single code For example if a line of your code file looks like this AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 4 of 33 t15 Geordhan Murphy of Leicester Tigers Geordan Murphy Tigers full back Geor dan Murphy Then AutoReplace will create the following code replacement pairs e t15 Geordan Murphy of Leicester Tigers e t15a Geordan Murphy of Leicester Tigers e t15b Geordan Murphy e t15c Tigers full back Geordan Murphy AutoReplace will create up to 26 variants of a single code replacement pair each suffixed by the letters a to z in order If AutoReplace detects more than 26 variant texts on a single line of a code file it will display a warning dialog when loading the code file Note the Trial version of AutoReplace does not support multiple code replace ments Versions AutoReplace comes in two versions trial and full The trial version is fully functional except for the use of mu
16. cess and searchString parameters If either of these two values is incorrect fix it They are both defined in the Settings section of the man agement panel which is described on page 13 of this guide Next AutoReplace reports the number of code files it is using and for each file in turn its absolute location and every code replacement pair it finds in each This can be a quite lengthy report Po11 12 30 11 10 05 0000 INFO Beginning to process 3 code files 2011 12 30 11 10 05 0000 DEBUG In readCodeFile Codefiles actions csyv 2011 12 30 11 10 05 0000 DEBUG Absolute path Volumes Clients lightroom tb AutoRepli 2011 12 30 11 10 05 0000 DEBUG table 1 string otb 2 string on the ball 2011 12 30 11 10 05 0000 DEBUG table 1 string ota 2 string on the attack Figure 40 The start of a detailed code file report If the active code files aren t the ones you were expecting you can fix the problem using the Code File Manager which is described starting on page 22 of this guide If the code files are correct but the code replacement pairs aren t you ll need to edit their contents You can use the Code File Manager to do this if you wish see page 24 but recommend using an external editor because of the clunky nature of the Light room plug in Ul Don t forget to force a reset if you take the latter option How is AutoReplace processing a specific image Select the image that s giv
17. d 13 Aug 2013 Page 24 of 33 Note There is currently no way of deleting existing code replacement pairs or of adding new pairs within Lightroom To add or remove code replacement pairs you will need to edit the code file outside of Lightroom All that can be done with in the code file editor at the present time is that existing code pairs can be modi fied This may change in the future A backup copy of the code file is created before the changes are saved A dialog box tells you where the back up has been saved ti Auto Replace has something to say backing up Codefiles Rugby Union Leicester Tigers csv to Leicester Tigers_25 Nov 2011 09 10 11 csv in Codefiles Rugby Union Backups OK Figure 30 Confirming the backup of a code file Note by default the backup copy is saved in the Backup folder under the code file s parent folder with the name lt codefile gt _dd mmm yyyy hh mm ss csv where lt codefile gt is the original name of the code file and dd mmm yyyy hh mm ss is the current date and time If the backup folder does not already exist it will be created This location cannot currently be changed To abandon your changes click the Cancel button Updates Once you ve bought an AutoReplace registration code all updates will be free for the lifetime of the prod uct AutoReplace will check for updates automatically every time it starts up if you check the Check for updates on startup checkbox in the tb AutoReplac
18. dedanetecanadt 13 DUIS E A noaioa aoeis ucaaraue noo aI UUaatoanAN ueoRAE No NLINeMMNCNGMMeEoueuasucaoDL 14 DEE a e E E E nn a no O 14 The Open Code File Manager Dutton cccccccsccssccseccsecncesecceeeeuceseceseeeuceeeceseeeuetseceseeeuctseceeeeeucteeeges 15 The default code file IOCATION neresi r iiras rar an Are oA AOON ANAO OAO 15 Then uve COGS mE oen E EN A E 16 BaO K UD a E E aetna ne eas eecionere ameteameteeutnaaeenaneaammanteannees 16 Fields tO process ccc cts verre se cece accctseecerisencisnmceaussancienccenescacesiceaucaasouscensseceeeadeaeccanceuccucesaccsscesesecscecesneed 17 DECO tig i ee re 17 DOCE AO aan rrtns eenentt ete erent eet een ntti ete tt ee ere 18 UALS a E 18 PUE MAUNO TOOL ririri AAA OAA OONAN OANA 18 Pe EEC EI o E E E E ee 19 PE creer E er E E N PEE A A A A A E E E E EE 20 AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 2 of 33 Pel atest dls 0 24a mEn arrene een en ee ee ee re 20 Code TE iaa ee eae er Caer re eee te ten Ut ran an AAA et A an CER Anan A RnR AN en eA RR an 20 Crearine code Tiles OUTSIG HIG MUFO OI hess 20 Hatem Clore ERNA E E aeeeenne ee eae PnP REMC ME MERE A ee ae me Re a a ae a me eee ee ae ee ee eee eee 22 Activating Code ho ee r e 22 Degctiva alh ay 24261610 a ic eee ene ene nee rr ne eee EAE 23 Creating code files within LIZGNTFOOM cccecccsccsecseccseeeneceeccseceseceeceeeceeeteuceseceeeeeuctseceeeeuctseeeeeeeeeeseeanes 24 Editine code file eana e
19. e Trial version of AutoReplace you ll be asked to accept the terms of the EULA tb AutoReplace Accept End User Licence Agreement _ have read the End User Licence EULA and agree to its terms Display the EULA PDF Cnet E Figure 4 The EULA acceptance dialog You will also see a nag screen reminding you that you are running a Trial version of the plug in AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 8 of 33 ti Auto Replace has something to say This copy of Auto Replace is not registered The unregistered version is fully functional save for the fact that only the first ten code replacement pairs will be honoured To remove this restriction and to stop this dialog appearing please purchase a serial number by clicking on the Buy tb Auto Replace button in the Plugin Manager OK Figure 5 The unregistered version nag screen This screen will appear every time AutoReplace starts and every time you change one of AutoReplace s pa rameters for example when you add or remove a code file The process of registering AutoReplace is described in Registration on page 11 below Set up Quick Start The remainder of this section describes each section of the AutoReplace plug in manager in order and in detail However only a few sections are relevant for day to day use of the plug in If you want to get started quickly here s what you need to do 1 If you have a registration code us
20. e User Guide PDF button to display this User Guide Click onthe End User License Agreement PDF button to display the EULA In either case you ll need to have Adobe Acrobat Reader or Adobe Acrobat installed to open the file Adobe Acrobat Reader is free and can be downloaded from the Adobe website Status The Status section of the plug in manager is primarily informational YF Status Path Library Application Support Adobe Lightr oReplace_LrPlugin_1 0 AutoReplace Irplugin Show in Finder Web Site http wwew tilebarn com lightroom AutoReplace Version 1 0 Build 2012 03 20 07 22 33 Status This plug in is enabled Enabli Disable Figure 17 The Status section of the AutoReplace management panel However two items are practically relevant the Enable and Disable buttons will unsurprisingly enable or disable the plug in If AutoReplace isn t making any code replacements at all this is your first port of call Note When the Status section isn t expanded the section header will still show whether or not the plug in is enabled See Figure 6 above for an example The Show in Finder button will open a window displaying the contents of the folder in which the plug in files are found This is probably the quickest way of getting to the default code file folder from within Light room Mac users will need to right click and select Show package contents to see the files within the plug in folder Plug in Author Tools The
21. e code replacement Close examination of verbose log file should enable you to identify where things are going wrong although itis hard to give any more general guidance In my experience the most likely reasons for a problem are e m using the wrong code files e AutoReplace hasn t finished initializing e ve made a typo ina code file e ve accidentally changed the search pattern Feedback If you find a problem with the AutoReplace plug in or this guide please let me know Equally if you think of a way that can improve the plug in feel free to make suggestions I m always happy to hear your ideas for improvements or additional functionality You can reach me either via my website www tilebarn com contact php or the Report Problem button in the tb Auto Replace section of the management panel John Kirkpatrick April 2012 AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 31 of 33 Appendix 1 Uninstallation If you have installed AutoReplace in the default Modules folder you can use the Uninstall button in the tb AutoReplace section of the management panel Otherwise you will need to remove the plug in manual ly by clicking on the remove plug in in the bottom left hand corner of the Plug in Manager The advantage of using the Uninstall button is that this will also allow you to delete all of AutoReplace s preferences and settings if you so wish If you haven t installed AutoReplace in the default pl
22. e in AutoReplace isn t yet ready You ll just need to wait a few seconds See Is Lightroom busy below for more details L _ Auto Replace Starting Up Please wait Figure 37 The AutoReplace initialisation message Is Lightroom busy AutoReplace runs as a background process This means it operates only when Lightroom has time to spare Usually because humans work so slowly compared to a computer s CPU this is effectively instantly and all the time However on occasion this may not be the case Typically this will be when Lightroom has just started up or when a very large number of new images are being ingested or perhaps when some other operation that involves intensive CPU activity is being performed Unfortunately there is no way to alter the priority that Lightroom assigns to its various activities so when this situation arises there is nothing to do but wait until Lightroom has finished whatever it is doing Lucki ly the codes you type won t go away All that needs to be done is to revisit the photos you ve edited once Lightroom is less busy The code replacements will then be made in the usual way My own personal experience is that this happens occasionally when Lightroom first starts up I ve never had AutoReplace hang once it has started to work The longest I ve had to wait for the first edit to take place on start up has been around ninety seconds but the delay is usually much less than this five to t
23. e it See on page 27 below If you don t it s not a problem You can use AutoReplace in trial mode but only ten code replacement pairs will be recognized 2 Create at least one code file preferably in an external editor Microsoft Excel OpenOffice or a simple text file editor will do See Creating code files outside Lightroom on page 20 below 3 Activate the code files in the Code File Manager See Activating code files on page 22 below Enable AutoReplace See Status on page 18 below That s it You re in business The Plugin Manager It has to be said that the Lightroom plug in user interface is limited and awkward Whilst the interface can display a certain amount of dynamic information that is information which changes in response to user input it is very difficult if not impossible to create an interface that is itself dynamic Since the parame ters to AutoReplace are very dynamic the current user interface is clumsy to say the least am aware of this and now that the core functionality of AutoReplace is in place will put more effort into improving the interface However it is unlikely to ever be perfect without a considerable upgrade to the Lightroom plug in Ul AutoReplace s status is described in the Plugin Manager dialog The Plugin Manager is opened by selecting the File gt Plugin Manager menuitem The Plugin Manager consists of two panels On the left hand side you ll find a list of plug ins t
24. e section of the management panel If an update is available you ll be prompted to download and install it You can also force an update check by loading the AutoReplace window in the plug in manager and clicking onthe Check for update button Note the remainder of this section assumes that you have installed AutoReplace in the de fault Modules folder for Lightroom Plug ins If you have installed the plug in elsewhere you should manually uninstall the old version and then manually install the new update Once an update has been downloaded it should be installed by clicking on the Update Plug in button on the AutoReplace window of the Plug in Manager Note In versions 1 0 x and 1 1 x of AutoReplace if you use the default folder for storing your code files it is vital that you take a back up copy before upgrading AutoReplace The upgrade process deletes all code files without warning This behaviour will be changed in a future re lease The process works like this AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 25 of 33 You ll be prompted to browse to the folder to which you have downloaded and unzipped the new version of the plugin Choose newly downloaded and unzipped plugin file name must end with Irplugin rit wml E Macintosh HD FAVORITES Name Date Modified Size Kind pms gt b i i E All My Files Les Applications l Jan 2012 12 57 Folder H Developer 13 Nov 2011
25. elds to process Title Caption Active code files The Edit Reload Advanced Settings buttons open the currently selected settings file in your default text file editor You re welcome to do this if you wish but wouldn t recommend it AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 19 of 33 Debug Access to the Debug section of the plug in manager is only necessary when investigating bugs that are par ticularly hard to track down If this is necessary will provide detailed personalized instructions Acknowledgements The acknowledgements section is self explanatory Y Acknowledgements AutoReplace uses Rob Cole s Elare Framework See weww robcole com Rob ProductsAndServices ElarePluginFramework for more details Figure 20 The Acknowledgements section of the AutoReplace management panel Code files The limitations of the Lightroom plug in Ul are most evident in the definition of code files Currently rec ommend that code files are created outside of Lightroom as CSV files most probably in a spreadsheet pro gram However the management of existing code files is relatively straight forward within the Lightroom plug in Ul Creating code files outside Lightroom The screenshots in this section have been taken from OpenOffice Other spreadsheet programs such as Microsoft Excel will work just as well Note spreadsheet programs appear to be particularly sensitive to whitespace at the beginning of fields
26. en seconds or so AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 28 of 33 Are you running a Trial version The trial version of AutoReplace will honour only ten code replacement pairs The pairs it chooses are arbi trary A warning message will be printed in the log file 2p12 01 04 13 23 07 0000 INFO Plugin is not registered Replacement texts limited toa 2012 01 04 13 23 07 0000 INFO table t13 string Horacio Agulla of Leicester Tigers t3 string Martin Castrogiovanni of Leicester Tigers 213 string Daniel KOTZE of ASM Clermont Auvergne 215 string Lee BYRNE of ASM Clermont Auvergne t7 string Julian Salvi of Leicester Tigers 29501 string Alexandre AUDEBERT of ASM Clermont Auvergne t17 string Boris Stankovich of Leicester Tigers t95 string Sam Harrison of Leicester Tigers c14 string Sitiveni SIVIVATIU of ASM Clermont Auvergne 2195 string Nathan HINES of ASM Clermont Auvergne Figure 38 The trial version of AutoReplace will only accept ten code replacement pairs To enable all your code replacement pairs to be recognized you will need to upgrade to the Full version Getting more detailed information If the suggestions above haven t solved your problem you probably need more detailed information about what AutoReplace is trying to do The best way to do this is to turn verbose logging on and take a look at the log file It s probably also worth restar
27. ext character that is not an alphanumeric character An alphanumeric ll Z character is any of the lower case letters a through z any of the upper case characters A through z and the digits O through 9 So the text on each of the following lines will match the default pattern n10 x5 itb XXX So why is the backslash there Quite simply it doesn t have to be But it is useful for two reasons e t helps to prevent accidental replacements I m happy to assume that any set of letters immedi ately followed by a number eg n13 is not something that I m going to want to type in normal circumstances so it s probably something that want replaced But l m not so sure about normal words For example it type itb did really mean to type it or its or did mean it to be a code for the replacement text is tackled by That I m not so sure of e It helps prevent unintended recursion AutoReplace s code replacements are recursive It s most unlikely that you ll ever want a backslash to appear in a caption so providing the option to prefix codes with a backslash helps prevent unwanted recursion wanted a single keystroke character that I d rarely if ever want to type into a metadata without an ulteri or motive There aren t many choices and settled on W Of course you re at liberty to make your own choices and choose your own lead in character or to do away with i
28. g in Author Tools Should you encounter an error whilst running AutoReplace this is where you can save the error log before requesting support Preset Manager Allows quick and easy switching between frequently used AutoReplace configu rations Debug Normally you can ignore this section However if you run into a problem that is particularly difficult to track down I may ask you to change a few settings in this section Acknowledgements As it says acknowledgements to those who have made significant contributions to the development of the plug in Table 2 Summary of management panel sections Each section can be expanded by clicking on the corresponding grey shaded header and is described in more detail in the following sections AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 10 of 33 tb AutoReplace The tb AutoReplace section of the management panel provides a link allowing you to buy the Full version of AutoReplace check for updates and to install them view log files produced by AutoReplace and control the level of detail they contain and finally to uninstall AutoReplace F tb Auto Replace Windows Mac Lr3 Author Tile Barn Photographic Authors Website www tilebarn com Buy tb Auto Replace Reset Warning Dialogs Check for Update Update Plugin Report Problem Check for updates upon startup View Logs Clear Logs Go to website with purchasing info Show
29. hat Light room knows about Scroll down the list until you find the entry for tb AutoReplace The plug ins appear in alphabetic order Click on tb AutoReplace entry and the AutoReplace management panel will ap pear on the right hand side of the dialog AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 9 of 33 th Auto Replace Windows Mac Lr3 Registration Settings Documentation Status Plug inis enabled Plug in Author Tools No diagnostic messages Preset Manager Debug FF FTIF TTI YT Disabled Acknowledgements Figure 6 The AutoReplace management panel The AutoReplace management panel consists of several sections Section Description tb Auto Replace Gives a general description of the plug in provides links to the AutoReplace web site for purchase updates and support allows access to AutoReplace log files for initial debugging Registration Records registration information allows retrieval of lost registration codes al lows re registration of AutoReplace following an upgrade to Lightroom itself Settings The most important section of the management panel for day to day use Allows the definition of code replacement pairs and all other aspects of AutoReplace s operation Documentation Provides links to this User Manual and your EULA Status Allows the plug in to be enabled or disabled Also provides details of the plug in s physical location version number Plu
30. hy This is an area where ac curate captioning is just as important as sports and other journalistic photography albeit usually without the time pressures have a hopeless memory when it comes to scientific names even for common spe cies So one idea might be to create series of code files one for each habitat or genus perhaps For example for Fowlmere RSBP reserve might have 1 Some early versions of Lightroom 3 report an error when installing AutoReplace The error message will refer to LrUUID This is a problem with the Lightroom API released with these versions The problem is fixed with the most recent Lightroom 3 release version 3 6 which may be downloaded from the Adobe website AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 5 of 33 bs Bewick swan Cygnus columbianus ge Goldeneye Bucephala clangula rtd Red throated diver Gavia stellata and so on whereas for my back garden I d need something more like gsw Greater spotted woodpecker Dendrocopos major bt Blue tit Cyanistes caeruleus gt Great tit Parus major gf Green finch Carduelis chloris bf Bullfinch Pyrrhula pyrrhula Future plans would like the development of AutoReplace to be driven by you its users If you can think of a useful ad dition to its capabilities please do let me know If you discover a problem with using AutoReplace in its current form or can think of a way of making it easier to use then once aga
31. igure 25 The Code File Manager after some code files have been activated Deactivating code files To deactivate a code file select the corresponding tab and click the Deactivate button in the top left hand corner of the Code File Manager The code file will be deactivated immediately but once again the limitations of the Lightroom plug in UI mean that the changes will not be visible immediately A dialog con firms the deactivation of the code file Li Auto Replace has something to say Codefiles actions lua has been removed from the code file list The next time the code file manager is displayed its tab will not appear Figure 26 Confirming deactivation of a code file AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 23 of 33 Creating code files within Lightroom Code files can be created within the Code File Manager but once again the limitations of the Lightroom UI make the process awkward The recommended way of creating a code file is to use a text editor or spread sheet program as described in above However if you wish to create a code file within Lightroom click on the Create button in the top left hand corner of the Code File Manager A dialog will appear and you will be asked to provide a name for the new code file and the number of code replacement pairs you want it to contain Create code file Code file location Browse Code file name New Code File lua 20 Cancel OK I
32. imple click anywhere else on the on the management panel before clicking the button Then everything will work as expected apologise for the inconvenience and am working on a solution Using AutoReplace to purchase a registration code The easiest way to register AutoReplace is to click the Buy tb AutoReplace button inthe section of the plug in management panel By doing this will automatically obtain the information need to provide you with your licence key which will be sent to you by email and which will be displayed on the order acknowledgement screen if you return to my website after completing your purchase on PayPal Once you receive your licence email copy and paste your email address and registration code into the ap propriate text fields and click the Register button If all is well you ll see a dialog confirming that Au toReplace is fully functional Info Li Auto Replace has something to say Thank you for registering AutoReplace The plugin is now fully functional Figure 9 Acknowledging successful registration If something has gone amiss you ll see a message similar to the following Warning A Auto Replace is concerned Sorry that does not appear to be a valid registration code Please check that you ve typed your details correctly If you believe your registration code is correct please consult the Troubleshooting section of your user guide in the first instance and then if that does not resolve yo
33. in please do get in touch My future plans for AutoReplace already include O An improved user interface I know it s not great at the moment see Set up below for a few reasons why My initial focus has been on the core functionality Now that is working properly I ll start to make things look prettier O Integration with keywords O Integration with IPTC fields O Other features as requested by users Changes from previous versions New in version 1 2 e Support for Lightroom 5 previous versions will run in Lightroom 5 the only change is the removal of the AutoReplace is unsupported nag screen e Support for multiple replacement texts associated with variants of a single code text similar to PhotoMechanic s multiple code replacement e The default code file location is changed from within the AutoReplace I rlpugin folder to the user s home folder This will preserve existing code files when upgrading AutoReplace e Support for a user defined default code file location e The ability to retrieve registration code emails New 1n version 1 1 2 In rare circumstances a Lightroom crash could partly or completely remove registration details for AutoRe place leaving the user with no way of retrieving their registration details or successfully reregistering the plug in once the registration code was known The problem has been addressed by adding a Send registra tion code reminder button in the registration section of the
34. ing you problems in Lightroom s library module Make the changes to the metadata that you think should be working making sure that you remove the focus from the last metadata field that you edit Open the log file and scroll down to the bottom Look for the name of the file you ve just edited AutoReplace will list exactly how it has handled each field in the fieldsToProcess list it will print out the ini tial value of each field and then either report that it found no placeholders or the edited value of the field having changed the placeholders it did find Figure 36 Detailed reporting of a recursive code replacement below shows an example involving a two stage replacement I have added some line breaks manually to improve readability AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 30 of 33 2011 12 30 13 01 14 0000 DEBUG caption has initial value 17 12 2011 Leicester England 2011 12 30 13 01 14 0000 DEBUG No placeholders found No changes made 2011 12 30 13 01 14 0000 DEBUG Processing TigersClermont_ 20111217 _ 134435 2264 jpg 2011 12 30 13 01 14 0000 DEBUG title has initial value 2011 12 30 13 01 14 0000 DEBUG No placeholders found No changes made 2011 12 30 13 01 14 0000 DEBUG caption has initial value 17 12 2011 Leicester England c12 itb t15 evt 2011 12 30 13 01 14 0000 INFO TigersClermont 20111217 134435 2264 jpg caption is now 17 12 2011 Leicester England
35. ions provider source copyright rightsUsageTerms l copyrightInfoUr personShown nameOfOrgShown codeOfOrgShown event additionalModelinfo modelAge minorModelAge modelReleaseStatus modelReleaselD sourceType propertyReleaselD propertyReleaseStatus Figure 12 The settings section of the AutoReplace management panel in its initial state The search string The search string is the most difficult of the inputs to AutoReplace to explain Fortunately it is the one that you are least likely to need to change As the name suggests the search pattern is a pattern rather than a fixed string that AutoReplace uses to scan the words of the selected fields Note AutoReplace regards a word as a contiguous string of letters and numbers delimited by either a another character such as a punctuation mark or whitespace b the start of the text or c the end of the text AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 14 of 33 When it finds a string that matches the pattern AutoReplace then searches its code files for an exact match to the string it has located If it finds an exact match it replaces the code text with the replacement text it found in its code files Technically speaking the search pattern is a regular expression By default its value IS Swt which translates as an contiguous group of one or more alphanumeric characters optionally starting with a backslash terminated by the n
36. lace licence is tied to your Lightroom serial number and to your email address You may therefore install the AutoReplace plug in on as many computers as share the same Lightroom serial num ber You will however need to use the same email address when registering An obvious consequence of this policy is that you will need a new licence key for AutoReplace whenever you upgrade your copy of Lightroom will supply all such replacement licence keys free of charge To ob tain an upgrade key simply click on the Get upgrade code button in the Plugin Manager and follow the on screen instructions The Get upgrade code button is enabled only if you have a full version of AutoReplace and the version of Lightroom that you are currently running is more recent than the version you were running when you purchased or last upgraded AutoReplace Note One upgrade code will be provided for each combination of AutoReplace li cence key Lightroom serial number and Lightroom version Troubleshooting You may find that AutoReplace isn t working as you expected This section is intended to help you track down exactly what s gone wrong The first thing to try to decide is whether or not AutoReplace isn t detecting all of the codes you ve defined or just some of them If it s just some of them then you know that AutoReplace is at least running and the problem is with your code file set up If the former you need to make sure that AutoReplace is actually
37. lem with AutoReplace gives you a simple method to cut and paste a section of the Autoreplace log file into an email message so that can resolve the problem for you Does what it says on the tin Startup refers to Lightroom not AutoReplace Writes a detailed description of AutoReplace s operation to the log file Note verbose logging can result in very long log files recom mend that you use this option only when trying to track down a problem The uninstallation process is described in Appendix 1 Uninstallation on page 32 below If your copy of AutoReplace is unregistered the Registration section of the AutoReplace management panel looks like this AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 11 of 33 Y Registration Email Either Registration code Or Register Paypal transaction id Click here before clicking the Register or Get upgrade code buttons Apologies for the inconvenience Get upgrade code Serial number hash 30c2188714df6067af7b9a212000be8a Send registration code reminder Figure 8 The Registration section of the AutoReplace management panel in Unregistered mode Note There is a minor glitch with this section of the management panel at the moment If you move directly from any of the text fields to either the Register or Get upgrade code buttons the process will fail because AutoReplace will not detect the information in the text field you last used The workaround is s
38. ltiple code replacements discussed above and has no time limitation The only restriction is that the trial version will recognise only a random selection of ten code replacement pairs defined by the code files you specify In the full version the number of code replacement pairs is limited only by the capabilities of your computer A full licence for AutoReplace has no expiration date You will be entitled to download and use all upgrades to the plug in including all future major releases without limitation subject to the terms of the original licence AutoReplace can be used in both Mac OS X and Microsoft Windows versions of Lightroom from 3 upwards Your AutoReplace licence is tied to a combination of your email address and Lightroom serial number If you change either for example through a major version upgrade of Lightroom then you will need a new licence If you need a new licence as a result of a Lightroom upgrade will provide you with a new licence key free of charge Currently if you require a new licence key as a result of a change of email address will also supply you with a new licence key free of charge However reserve the right to introduce a small administrative charge in this situation in the future Intended audience wrote AutoReplace to help me in my work as a sports photographer think sports photography will be its main market But it s not the only one For example also enjoy natural history photograp
39. mail containing details of all of your pur chases together with their current status will be sent to you If you have multiple installations of AutoReplace on multiple copies of Lightroom you can use the serial number hash to work out which registration code is associated with each installation The serial number AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 13 of 33 hash appears in the Plug in Manager just above Send registration code reminder button and in the reminder email If you have lost all of your details then am afraid will be unable to help you Settings The settings section is absolutely central to the plug in s operation this is the section of the management panel that you will visit most frequently from day to day In its initial state the settings section looks like this Status Reset required Search string w Code files Open Code File Manager Default code file location C Users John Codefiles Back up Export Import Fields to process I title W caption headline label copyName creator creatorJobTitle creatorAddress creatorCity creatorStateProvince 7 creatorPostalCode creatorCountry iptceSubjectCode creatorFhone creatorEmail I creatorUrl descriptionWriter ipteCategory iptcOtherCategories dateCreated intellectualGenre scene location city stateProvince country isoCountryCode jobIdentifier instruct
40. nitial number of codes in file Figure 27 The Create code file dialog If you click the OK button a dialog will appear confirming that an empty code file has been created Info Li Auto Replace has something to say A new code file has been created and added to the code files list Please close the Code File Manager and then reload it to display the file Figure 28 Confirming creation of a new code file You should now close the Code File Manager and re open it The new empty code file will appear in a tab in the Code File Manager as it is redisplayed You may now edit the new code file as for any other code file as described in below Editing code files To prevent accidental damage to code files the Code File Manager displays them in read only mode by de fault To allow a code file to be edited click the Editable checkbox in the top right hand corner of the code file s tab actions lua Leicester Tigers csv Codefiles Rugby Union Northampton Saints lua iv Editable inS Northampton s Greig TONKS nl4 Northampton s Paul DIGGIN Figure 29 The Editable checkbox on a code file tab The codes and replacement texts contained in the file may now be edited To save your changes click on the OK button in the bottom right hand corner of the Code File Manager Any changes that you have made are immediately written to the code files and made available to the AutoReplace plug in AutoReplace User Guide v1 2 Last update
41. o process MF title label creatorlobTitle creatorSstateProvince iptcSubjectCode creatorUrl iptcOtherCategories scene stateProvince jobldentifier source copyrightinfoUr nameOrOrgshown additionalModelinta modelReleaseStatus propertyReleaselD PUP Reset required ITAW Open Code File Manager Codefiles actions csv Codefiles Rugby Union Leicester Tigers csv Codefiles Rugby Union London lrish csv Edit externally Edit externally Edit externally Export Import eal caption copyName creatorAddress creatorPostalCode creatorPhone descriptionWriter dateCreated location country instructions copyright colorNameForLabel codeOfOrgShown modelAge moadelReleaselD propertyReleaseStatus headline creator creatorCity creatorCountry creatorEmail ipteCategory intellectualGenre city isoCountryCode provider rightsUsageTerms personShown event minorModelAge sourcelype Figure 13 The Settings section showing three active code files As you might expect clicking the Edit externally button alongside each code file will open your default external editor to allow you to make changes to the file Note If you edit a code file externally you ll need to check the Reset required Checkbox be fore AutoReplace will recognize the changes Back up You can take a back up of all code files in the default code file folder at any time Simply click on the Ex port button and select the destination folder If
42. ry isoCountryCode jobldentifier instructions provider source copyright rightsUsageTerms copyrightinfoUr colorNameForLabel personShown nameOfOrgShown codeOfOrgshown event additionalModelinta modelAge minorModelAge modelReleaseStatus modelReleaselD sourcelype propertyReleaselD propertyReleaseStatus Figure 15 The Fields to process section of the Settings tab of the Plug in Manager Figure 15 shows the default fields to process title and caption Other controls The other two controls are less critical The Status field shows you what AutoReplace is doing Normally the field will read running When AutoReplace first starts it will read starting If the plug in is disa bled it will read Plugin disabled You cannot edit this field On very rare occasions you may need to force AutoReplace to restart Typically this will be to update the code replacement list after editing a code file externally or rarely to check that the correct code files are being loaded when debugging a problem after turning verbose logging on You can do this by checking the Reset required checkbox After a few seconds the checkbox will clear and the Status field will re flect the new state of the plug in AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 17 of 33 Documentation F Documentation User Guide PDF End User Licence Agreement PDF Figure 16 The Documentation section of the AutoReplace management panel Clicking on th
43. t all together However if you do so you ll need to understand regular expressions and to re member that the backslash character has a special meaning in Lua the language in which Lightroom plug ins are written and therefore needs to be escaped That level of detail is beyond the scope of this user guide but you can find the relevant information at http lua users org wiki PatternsTutorial and many other sites on the web The Open Code File Manager button The function of the code file manager is explained in The Code File Manager below The default code file location You are free to store code files anywhere on your computer However it will usually make sense to keep them all in a central location By default this is the Codefiles folder your home folder Your home folder is Cc Users lt username gt on Windows and Volumes Users lt username gt on OS X You may change The search is locale aware so accented and other special characters will be matched if the locale is set appropriately on your computer AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 15 of 33 the default location by clicking on the associated Browse button and or store individual code files else where as you wish The active code file list When one or more code files have been activated the active code files are listed below the Open Code File Manager button F Settings Status Search string Code files Back up Fields t
44. tct cree sates se E oer ese vnc Sate baw eee eee wae see eo ee TOO 24 EN E E attested cette ote seine eee eal vote ett A vse rae eevee IOSIS S A 25 PIC SINS NG eA A AAR E A A E T A A A AA A O E A RR 27 TOUDICSROOLUN E iiaa EA OAA A T OAO AO AAAA AAO 27 LAUORepace r i 0 reer mm er e E 27 Has AUTOR EDlaCe finished IMITIANZING iseen 28 e LENTOM OSV Torir E AE N xan OI ecawone danse OOI O IO OOA AOOO OOE 28 Are Vou running atrial version aen heel teci tec taiaeb testing bars tasi las eee barieestartncsbastentneaiste 29 Getting more detailed INTO MAtlON atxcicteteitercheie rete retebiteleies tte E Enek EREEREER aaee ciel cialis 29 Is AutoReplace USING the correct settings ccceccecccsecsscceeccseceuceeceneceucceeceeeeeueteeeeeeeeeeteeeeeeeeucteseseeeeeees 29 How is AutoReplace processing a specific MALO ssvesivcesccoieein iw serseivediesied xe axe a 30 Se hess uay tee tanebiae eos ie me tusa tebe EEEE S 31 Append ied UninstallatlOn ccenccees terete teeta etc eerc ct tcct at ctat atte tii tellers es cere cea cee caer rae ee cle la Iu a taal 32 AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 3 of 33 Introduction How AutoReplace works AutoReplace is a plug in that runs in the background whilst you use Lightroom in your normal workflow To use AutoReplace you need to define three things 1 The fields you want to search for replacement codes 2 The pattern by which replacement codes are identified 3 The text that you want
45. ting AutoReplace so that you can check that it is initializing cor rectly Clearing the log file before you restart AutoReplace will reduce the amount of output you need to wade through To turn verbose logging on check the Verbose Logging check box at the bottom of the tb Auto Replace section of the management panel To clear the log file click the Clear Logs button also in the tb Auto Replace section of the management panel To view the log file you won t be surprised to learn that you need to click on the View Logs button in the same section The tb Auto Replace section of the management panel is described in detail on page 11 of this guide The remainder of this section assumes that you have verbose logging enabled Is AutoReplace using the correct settings Open the log file and take a look at the top of the file Search for the line INFO Starting to reset process parameters It s about twenty five to forty lines from the top Immediately following this line AutoReplace prints the current values of its fieldsToProcess and searchString parameters AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 29 of 33 011 12 30 11 10 05 0000 INFO Starting to reset process parameters 2011 12 30 11 10 05 0000 DEBUG fieldsToProcess 2011 12 30 11 10 05 0000 DEBUG title 2011 12 30 11 10 05 0000 DEBUG caption 2011 12 30 11 10 05 0000 DEBUG searchPattern w Figure 39 Current values of the fieldsToPro
46. to add when it AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 22 of 33 constructs the Code File Manager it can t display the code file once you have add ed it It s awkward but unavoidable Note You may select multiple code files in the File Open dialog All the files se lected will be activated Here s an example of what the Code File Manager looks like once some code files have been activated 008 Code File Manager Add Remove Create AEGSE NER actions lua Leicester Tigers csv Codefiles Rugby Union Northampton Saints lua _ Editable nls Northampton s Greig TONKS n14 Northampton s Paul DIGGIN n13 Northampton s Jon CLARKE n12 James DOWNEY of Northampton Saints nli Northampton s Scott ARMSTRONG n10 Northampton s Ryan LAMB n9 Northampton s Lee DICKSON nl Northampton s Paul DORAN JONES Northampton s Mike HAYWOOD n3 Northampton s Brian MUJATI n4 Northampton s Samu MANOA n5 Northampton s Christian DAY Northampton s James CRAIG n7 Northampton s Calum CLARK ng Northampton s Ph l DOWSON n16 Northampton s Ross MCMILLAN n17 Northampton s Alex WALLER nig Northampton s Tom MERCEY n19 Northampton s Mark SORENSON n20 Northampton s Roger WILSON n21 Northampton s Martin ROBERTS n22 Northampton s Stephen MYLER n23 Northampton s Tom MAY Neil CLARK of Exeter Chiefs evt during the Aviva Premiership match between their two sides at Franklin s Gardens The final Cancel o F
47. to take the place of each replacement code Once you have done this AutoReplace will constantly scan the contents of the fields you have identified in step 1 and every time it finds one of the codes defined by the pattern in step 2 it searches through the list of code and replacement pairs you defined in step 3 and replaces each code with the corresponding text For example you might type the following text in an images Caption field al itb b2 during match and with the correct definitions AutoReplace will automatically change the text of the caption to John SMITH of Newtown United is tackled by David BROWN of Anywhere Rovers during the Sponsor company s football league match between their two sides at the New town Arena on March 22nd Configuration of AutoReplace is simple and intuitive and can be done without leaving Lightroom Code replacement is recursive without limit For example if you have the following set up 1lt Leicester Tigers ns Northampton Saints home lt away ns venue Welford Road comp Aviva Premiership event during the comp match between home and evt at venue Then event will eventually translate as during the Aviva Premiership match between Leicester Tigers and Northampton Saints at Welford Road Code replacement pairs are defined in the order in which they are defined within a code file Code files are processed in the order in which they appear in the Settings section of the management p
48. ug ins folder when you click on the Uninstall but ton you ll be told that this won t work for you Warning Auto Replace is concerned You must use the plugin manager s Remove button to uninstall this plugin OK Figure 42 Unable to uninstall Otherwise you ll be asked to confirm that you really want to remove the plug in Confirm Auto Replace is asking Are you sure you want to remove tb Auto Replace from Volumes Users Users john Library Application Support Adobe Lightroom Modules AutoReplace Irplugin Cancel OK Figure 43 Confirmation of removal And then what you want to do with AutoReplace s preferences and settings Info Li Auto Replace has something to Say Remove plugin preferences too If unsure then answer No No I m not sure this isa good idea Cancel Figure 44 Confirm removal of preferences AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 32 of 33 If you answer Yes all preferences will be removed this includes your licence key Finally you ll see con firmation that the plug in has been removed Info Auto Replace has something to say tb Auto Replace has been uninstalled and its preferences have been wiped clean restart Lightroom now ok Figure 45 Confirmation that AutoReplace has been uninstalled AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 33 of 33
49. ur problem please feel free to contact us ok Figure 10 Reporting a registration problem Please check your details and try again You may find the Troubleshooting section of this document helpful If you are certain your details are correct and your problems persist please contact me AutoReplace User Guide v1 2 Last updated 13 Aug 2013 Page 12 of 33 Once your copy of AutoReplace has been successfully registered the registration section of the manage ment panel will look like this Y Registration Email Registration code Figure 11 The Registration section of the AutoReplace management panel after successful registration Purchasing AutoReplace using other methods If you didn t start the purchase process by clicking on the Buy tb AutoReplace button at the top of this section of the management panel you won t have a registration code This might happen for example if you bought AutoReplace from one of my sales partners In this case you can obtain your registration code by entering your email address and PayPal transaction id in the appropriate fields and then clicking the Get licence key button Your registration code will appear and a confirmation email will be sent to you As before after successful registration the Registration section of the management panel will look as it does in Figure 11 above Note you can also use this method to retrieve your registration code if you ever lose your reg istration
50. y code files as you wish and may choose which of them if any are currently active You can display the Code File Manager by clicking on the Open Code File Manager button on the Au toReplace management panel The Code File Manager dialog will be displayed The Code File Manager shows the currently active code files as well as their contents The content of each file is displayed in a separate tab The first time you use the Code File Manager it looks like this OO CodeFile Manager Activate Deactivate Create Cancel 0K Figure 23 The Code File Manager in its initial state Activating code files To activate an existing code file click the Activate button in the top left hand corner of the Code File Manager This will display a File Open dialog Browse to the code file you wish to add and click OK AutoReplace will display a message informing you that the file has been added and that its contents may be viewed when the Code File Manager is next opened Info Oo Auto Replace has something to say Codefiles actions lua has been added to the code file list Its tab will appear the next time the code file manager is opened a Figure 24 Confirmation that a code file has been activated Note This is one of the unfortunate restrictions of the Lightroom Plug in UI the controls that appear on a dialog cannot be changed once the dialog has been dis played As Lightroom doesn t know about the code file you wish
Download Pdf Manuals
Related Search