You are on page 1of 10

LR/M

Mogrify2
LR/Mo
ogrify 2 is a postprocess plugin for Lightroom 2 a nd higher that can embellish your im ages as theyy are exported from
Lightro
oom.It'sflexibleinterface allowsyouto
oaddouteraandinnerborrders,waterm
marksandtexttannotationsstoyourimagges.It's
alsocaapableofexp
portingoptimu
umJPEGimaggesthatarennolargerthan
nyourrequesstedsize;greaatforuploadingtowebsittesthat
limit the
t file size. LR/Mogrify 2
2 usesImageMagickto proocess the im
mages. ImageM
Magick is a ccollection of powerful, freeeware
command line utilitties for proceessing images. In contrast tto the originaalLR/Mogrify for Lightroom
m 1.3 and above, LR/Mogrrify 2 is
mentedasa""postprocess"plugin(new
wtoLightroom
m2.0),allowin
ngittoworkintandemw
withanyexporrtplugin.Thissallows
implem
youto
o process your imagesusin
ng LR/Mogrifyy 2and still hhave them sen
nt toyour final destinationn using the export plugin ofyour
o
choice
e.

Installation
Step1:Installin
ngImageM
Magick(Windowsuseersonly)
(Macu
usersdonotn
needdothissiincethepluginincludesits ownversion)
To use
e this plugin, Windows ussers must insttallImageMaggick. Mac use
ers do not ne
eed do this ssince the pluggin includes its own
version
n.
Ifyouhaveanyprob
blemswiththeplugin,you''llmayalsoneeedtoinstallttheseMicroso
oftpacakges:

(32bitwin
ndows)VisualC++2008Red
distributablePPackage(x86)
(64bitwin
ndows)VisualC++2008Red
distributablePPackage(x64)

64bitWindowsreq
quiresbothpaackages(x86&
&x64).

Step2:Installin
ngLR/Moggrify2
Downloadandunzip
pLR/Mogrify2.Youshould
dnowhaveapplugincalled'LR2Mogrify.lrrplugin'.
Lightro
oom2hasan
newpluginmaanager.Toinsttallusingthis youshould:
1.
2.
3.
4.

MoveLR2M
Mogrify.lrpluggintoaconvenientlocationnofyourownchoosing.
OpenLighttroom'splugin
nmanagerfro
omtheFilemeenu.
Clickthe"A
Add"button.
Browsetothepluginandclick"OK"o
onaMacor"A
Addplugin"on
naPC.

Step3:Unlockthetrialversion
If you have donateed towards th
he project yo
ou should unl ock the trial version using
g the registraation code th
hat you shoulld have
receive
ed.
1.
2.
3.

Openthep
pluginmanageerfromtheFilemenu.
Choose"LR
R/Mogrify2"ffromthelisto
ofplugins.
Enteryourregistationco
odeintotheU
UserRegistrattionsection

Step4:Setup((Windowsusersonlyy)
Windo
owsusersnow
wneedtotellthepluginwh
heretofindIm
mageMagick's mogrifyappliication.
1.
2.
3.

GotoLighttroom'sLibrarrymodule,clicckonanimaggeandthenprresstheExporrtbutton.
Onthelefttsideoftheexxportdialogb
box,under'PoostProcessActions'doubleclickon'MoggrifyConfigura
ation'.
In theMog
grify Configuration panelwhich is now
w showing on the right, press 'Choosse', browse to
t the ImageMagick
installation
n (e.g. C:\Proggram Files\Im
mageMagick66.4.1Q16 th
his will vary with
w the versiion of ImageMagick) and choose
mogrify.exe

QuicckGuidee
FindiingLR/Mogrify2
OnceiinstalledLR/M
Mogrify2can befoundintthelistofposstprocessactionsintheexxportdialog.YYoumaychoo
osetheLR/Mo
ogrify2
featuresthatyouw
wishtouse,an
ndtheywilla
appearontheerighthandsidealongwith
hthesectionssthatarepro
ovidedbythe export
ose:
pluginthatyouchoo

Configuration
PCuse
ersshoulduseethispanelto
ospecifythelo
ocationoftheemogrifyapp
plicationthatw
wasinstalled byImageMaggick(Macuserrsdon't
needttodothis).
Advancedusersmayyalsoenterth
heirowncom
mmandlinepa rameterswhichwillbepassedtotheap plication.

Oute
erborders
Version1.40ofLR/M
Mogrify2oveerhauledtheb
borderoptionss.It'snowpossibletoadda
anynumberoofborderstoa
animage(preeviously
dto5),andeachbordercaanbeindepen
ndentlydefineedinpixelsorasapercenttageofthew
widthorheightoftheimagee,orof
limited
thelon
ngestorshorttestside(regaardlessoforientation).
Outerbordersareaaddedaroundtheimage,so
ononeofthe imageisobsccured.

Innerrborders
Innerb
bordersarein
nsetintotheiimage,andth
hereforeobsc urepartofth
heimage.Byvvaringtheopaacityofthebo
orderit'sposssibleto
exporttimageswith someverycrreativeborderreffects.You manycreateanynumbero
ofinnerbordeer,andeachssidemaybeggivenits
ownw
widthandinsetvalue.


Here'sanexample. Thecombinaationofinnerandouterboordersettingsshowninthe
eprevioustwooscreenshotsswouldprodu
ucethe
followingresult.

Grap
phicalWateermarking
Youcaaneasilyaddm
multiplewatermarkstoyou
urimages.

Here'sanexample.Theimagew
wasexported asa400x4000pixelTIFFdirectlyfromLightroom,theenapreprep
paredPNGfileeofmy
logow
wasusedasaw
watermark,h
havingfirstbeenresizedto 300x116pixe
els.NotethatinthiscasethhePNGfileis50%transparrent,so
"Norm
mal"modewassused.A2x2pixelwhitebo
orderwasadddedfollowedbya13x12%b
brownborderr.

TextAnnotatio
ons
LR/Mo
ogrify2alsoallowyoutoad
ddmultiplete
extannotationnstoyourimaages.Thetextmaybebrokkenupontose
everallines,andmay
include
ereferencesttothephoto'ssmetadata.Siimplyclick"Adddmetadatatoken"toadd
dthetokentootheendofyo
outext.

Metad
datatokensarrereplacedduringtheexportoperationnbyrealmetaadatafromth
hephoto.Theeycaneasilyb
berecognisedbythe
curlyb
bracketsaroun
ndtheirnamee.Youdon'tn
needtoremem
mberallthep
possibletoken
ns,justclick"A
AddMetadata
aToken"andchoose
onefro
omthelist.
A pho
oto being exp
ported may not
n have the
e particular ppiece of metaadata that yo
ou've asked ffor. LR/Mogrrify 2 will elide any
unnecessarypunctu
uationthatreesults.Forexa
ample,ifyou rtemplateis "{city},{state
e},{country}" andstateha
appenstobe empty,
ot"Paris,,Fra
ance".
you'dhave"Paris,FFrance"andno
uebya
Anotherapproachisgiveavalueetobeusedincaseofmisssingmetadatta.Todothis, separatetheetokenname fromthevalu
nspeed}willrresultin'Unkn
nownspeed'iftheshuttersspeedinformationisn'tavaailable.
comma.Forexamplle,{shutterSpeed,Unknown
ns.Forexampple,{dateTime
e,{dateTimeOrriginal}}.Andtthiscangoon
nwithoutlimitt:
Thereplacementcaanevencontainothertoken
Dateaandtime:{dateTime,Originaaldateandtim
me:{dateTimeeOriginal,Digitiseddateand
dtime:{dateTTimeDigitized}}}}
Furthe
ermore,metad
dataforthevvariousdatesa
andtimescannbeformatted
daccordingto
oyourownsppecification.T
Theformatsho
ouldbe
givinginsquarebracketsfollowin
ngthetokenn
name,asthiseexampleshow
ws:
Nodateortim
mefound}
{dateTTime[%Y/%m//%d%H:%M],N
Theformatcanconttainthefollow
wingspecialcharactersequuencesfortim
meanddateelements:

%B:Fullnaameofmonth
%b:3letteernameofmo
onth
%m:2digittmonthnumber
%d:Daynu
umberwithleadingzero
%e:Daynu
umberwithou
utleadingzero
o
%j:Juliand
dayoftheyearwithleadinggzero
%y:2digityearnumberr

%Y:4digityearnumbeer
%H:Hourwithleading zero(24hourrclock)
%I:Hourw
withleadingzzero(12hourclock)
%M:Minu
utewithleadinngzero
%S:Secon
ndwithleadinngzero
%p:AM/P
PMdesignatioon
%%:%sym
mbol

Resizzingoption
ns
Youm
maychooseto
oresizeyouriimagesusing Mogrify.Inccomparisonto
oLightroom's standardressizeoptionsthiswillallow youto
choose
ebetweenan
numberofad
dvancedresizingalgorithmsstosuityour taste.Youca
analsoresize toagivento
otalnumbero
ofpixels
regard
dlessofaspecttratio,whichisusefulforstockphotograapherswhohavetosupply
yimageswith acertainnum
mberofpixels..
The"FFitanyborderrsintothistargetsize"opttionwilltrytoofitandbord
dersthatyou'readdinginttothesizetha
atyousethere.The
imageisthereforem
madesmallertoallowforthis.
willoverridean
nysizingconsttraintsthatyo
ousetusingLiightroom'sstaandardsizeop
ptionsintheI mageSettingstab.
Thisw

CanvvasOption
Therearetimesthaatyoumaybeeaskedtopro
oducesafixeddsizeimages,butyoudon'twishtocroppthem.Forexxample,someephoto
htodisplayim
magesonapro
ojector.
laboratoriesmayrequirethis,oryoumaywish
o define the absolute finaal output size
e of your image. The imagge is first resized using thee other
The caanvas option allows you to
option
nsavailable,andbordersarreadded.Theimagesistheenplacesonth
hefixedsizeccanvas,which mayhaveanyycolouryoucchoose.
Iftheimageisbiggeerthanthecanvasthenitw
willbecroppedd.

Comp
pressingJP
PEGstoattargetfilessize
This option is inten
nded for creating the highest quality JPPEG possible that'll be no larger than tthe requested
d file size (meetadata
ed).Youmayfindthisusefulforwebsite
esthatlimitthhemaximumffilesizethatyoucanuploadd.
include

Toach
hievethismaggicLR/Mogrifyy2firstcreate
esaTifffileuusingallyour othersettingss(watermark,,annotations,,etc.).Itthen
nhasto
converrt the Tiff filee to a JPEG at
a various quality settings to find the optimum
o
qua
ality. Up 9 JP EG conversions are requirred per
exporttedfilepleassebepatient!

Sharp
peningopttions
Youcaanalsosharpeenyourimageesfromhere;thesharpeninngisappliedaaftertheresizzeoperation. Thisoptionh
hasreallybeen
nmade
obsole
ete by Lightro
oom 2's own
n export sharrpening optioon, however I've kept the
e panel for tthose who prrefer ImageM
Magick's
sharpe
eningtools.

Colou
urspaceco
onversion
LR/Mo
ogrify2canbeeusedtoconvvertyourexpo
ortedimagettoothercolou
urspaces.You'llneedtobroowsetotheIC
CCprofileconccerned.
Ifyou knowthatth
heimagewill beusedbya noncolourm
managedsystemthenyoumaychoosettoremoveth
heprofileino
orderto
e the image size (the con
nversion can still be applieed before thiis is done). Iff you don't uunderstand enough about colour
reduce
managgementtokno
owifyoushou
uldbedoingthis,thenIreccommendthatyouleaveth
heprofilesintaact.

Colou
urProcesssing
Finallyy, the ability tto adjust the brightness and saturationn of the imagge on export may appeal tto those who
o like to adjusst their
imagessfortypicalw
webviewingonuncalibrated
dmonitors.

F.A.Q.
Q:Doe
esLR/Mogrifyy2workwithLightroom3??
A:Yes..
Q:IsLR/Mogrify2sstillusefulnow
wthatLightro
oom3hasbuuiltinwatermarking?
A:Ofccourse!LR/Mo
ogrify2offerssawholehosttoffeaturestthatyoudon'ttgetwithLigh
htroomalone.
Q:IsLR/Mogrify2ccomptatiblew
withbothPCa
andMac?
A:Yes(althoughyou
uneedanInteelMac).
Q:DoIneedtoinsttallImageMaggicktousethisplugin?
A:OnaPC,yes.OnaMac,no.
Q:WillLR/Mogrify2workonLigghtroom1.3o
or1.4?
A:No,buttheorigin
nalLR/Mogrifywill.
Q:I've
ealreadymad
deadonationforLR/Mogriify,canIupgrradetoLR/Mo
ogrify2?
A:Yes,,theunloccodeisthesame.

Q:OnceI'vedonateddoIhavetodonateagaintogetupdates?
A:No,allfutureupdateswillbefree.
Q:Thepluginreturnsanerrorstatingthathasfailedtostartbecauseitssidebysideconfigurationisincorrect.Why?
A:You'llneedtoinstalltheoneorbothoftheMicrosoftpackagesthat'sdescribedintheinstallationguide.
Q:WhatarethedifferencesbetweentheoriginalLR/MogrifyandthenewLR/Mogrify2?
A:LR/Mogrify2isnowapostprocessplugin,asopposedtoanexportplugin.ThisconceptisnewtoLightroom2.Postprocess
pluginsareintendedtoprocessanyexportedimagesbeforetheyarehandedtotheexportplugin.ThismeansthatLR/Mogrify2can
nowbeusedinconjunctionwithanyotherexportplugin.

Theinterfacehasbeentidiedalittle.Sinceit'snotanexportplugin,theFTPsectionhasbeenremoved.
Q:HowdoIaccesstheplugin?
A:PleasereadtheQuickGuide.
Q:IfIexportaJPEGthendoesn'tthatmeanthatLR/Mogrify2willworkontheJPEGfilebeforesavingasaJPEGyetagain,
therebyreducingtheimagequality?
A:Shortanswer:No.

Longanswer:LR/Mogrify2isdesignedtosecretlyaskLightroomforaTIFFfiletoworkon,andthenconverttoJPEGattheend.
HoweverunderLightoom2.Othere'sabugthatstopsmefromexportingtheTIFFwiththeuser'schosencolourspace,sountilthisis
fixedbyAdobeLR/Mogrify2willsecretlyexportthehighestpossiblequalityJPEG,mogrifythat,andthencreatesanewJPEGwith
thechosenqualitylevel.
Q:WhyareJPEGsexportedwithandwithoutusingLR/Mogrify2acompletelydifferentsize?
A:Theclue'sintheanswerabove.IwouldseemthattheJPEGalgorithmsusedbyLightroomandImageMagickgivedifferent
compressionsforthesamequalityvalue.
Q:Whyisthispluginuseful?
A:It'susefulifyouneedtopostprocessyourimagesusingImageMagick!Mymainmotivationforwritingthispluginwastoallow
metopreparemystockimagesforAlamy.Alamyrequirethatallimagesberesizedtoaminimumof48Mb,andthisisn'tpossible
usingLighroom'sstandardexportdialog.Graphicalwatermarking,textannotationsandsimpleoutlinebordersarealsouseful
featuresthatcan'tbeacheivedusingLightroom'sstandardinterface.
Q:WheneverIselectabordercolour,Lightroomcrashes.Canyoufixthis?
A:No.ThisactuallyhasnothingtodowithLR/Mogrify2,it'sanincomptibilityproblembetweenLightroom(whichtriestoopenthe
systemcolourpicker)andtheColorMonkicalibrationsoftware(whichhassecretlyreplacedthecolourpickerwithitsownone).
You'llneedtoremoveColorMonki.
Q:I'manAlamyuser.HowshouldIconfigureLR/Mogrify2?
A:Resizetoatotalnumberof16.1MPixelsusingtheLR/Mogrify2resizesection.Notethat48Mb=16MPixels,howeverMogrify
onlyallowsyoutoupsizetoamaximumnumberofpixelsasopposedtotheminimum16MPixelsthatarerequired.That'swhyIsay
16.1MPixels.
Q:I'musingtheJPEGcompresstofilesizeoption,andit'sreallyslow.Why?
A:ToachievethismagicLR/Mogrify2firstcreatesaTifffileusingallyourothersettings(watermark,annotations,etc.).Itthenhas
toconverttheTifffiletoaJPEGatvariousqualitysettingstofindtheoptimumquality.Up9JPEGconversionsarerequiredper
exportedfilegomakeacupoftea...
Q:WhatelsecanMogrifydo?
A:UseMogrifytoresizeanimage,blur,crop,despeckle,dither,drawon,flip,join,resample,andmuchmore.Readthe
Mogrifyusageguideformoreinformation.

Q:WhichofMogrify'sfeaturesareavailable?
A:Allofthemareavailablethroughthecommandlineparametersoption.PleaseseetheQuickGuidetoseewhichfeatureshavea
userinterface.
Q:CanyouexposemoreofMogrify'sfeaturethroughtheuserinterface?
A:Probably.Pleasecontactme.
Q:HowdoIselectafont?WheredoIlook?
A:Macusersshouldlookin/Library/Fontsor<Username>/Library/Fonts.Asfromversion2.50Windowsuserscansimplychoosea
fontfromthelist.
Q:I'mtryingtooverlayatextannotation,butI'mnotgettinganytext.What'shappening?
A:Duetoanumberofissues,ImageMagickcan'trenderallfonttypes.ThiswillmostlyaffectMacusers.Tryadifferentfont(ttf
fontsshouldalwayswork).
Q:I'mtryingtooverlayawatermarkbutIreceiveamessagestatingthat"LR/Mogrify2isunabletocorrectlyscale
watermarkmarkimagesofthisfiletypewhilstmaintainingtheaspectratio".What'shappening?
A:InordertomaintaintheaspectratioofthewatermarkLR/Mogrify2needstobeabletoreadthewidthandheightofthe
watermarkimage.TodothisisreliesonLightroom'sabilitytoreturnthisinformation,howeverLightroomislimitedinthefiletypes
thatitcanopen.Youshouldeithertryadifferentfiletypeforyourwatermarkimageorelseenterthewidthandheightdirectlyin
pixels.
Q:I'vefoundabug,howshouldIreportit?
A:Pleasecontactus.
Q:HowdoIuseMogrify?
A:Pleasedon'tcontactme!ContactImageMagick'ssupport.
Q:What'sthissigmathingintheunsharpmask?Whatdoesn'tradiusbehavelikeI'dexpect?
A:See,that'sanImageMagickquestion.Justthisonce,I'lltellyouweretolook.