.
Jeffrey’s “Crop for iPad” Lightroom Plugin

This “export filter” plugin for Lightroom allows you to apply a device-specific crop to an image during output, so that images fully fill the screen when viewed on the device.

I use it to prepare images for my iPad and iPhone, but it can be used with any device in mind such as digital picture frames, tablet computers, TVs, smartphones, etc.

This plugin works in Lightroom 5 (and older versions as far back as Lightroom 3, though some features depend on the version of Lightroom).

The same download works for both Windows and Mac. See the box to the upper right for the download link (in orange) and installation instructions.

How To Use

For explicit details on how to use the plugin, see my companion post:

My Lightroom-to-iPad Workflow: Now a Lot More Refined

Independent JPEG Group Software

This plugin software is based in part on the work of the Independent JPEG Group. The crop, if performed, is lossless (it does not lower the quality of the image) because it uses the Independent JPEG Group's most-excellent jpegtran software to do the crop.

Availability

This plugin is distributed as “donationware”. I have chosen to make it available for free — everyone can use it forever, without cost of any kind — but unless registered, its functionality is somewhat reduced after six weeks.

Registration is done via PayPal, and if you choose to register, it costs the minimum 1-cent PayPal fee; any amount you'd like to add beyond PayPal's sliding fees as a gift to me is completely optional, and completely appreciated.

Note: a Lightroom major upgrade, such as from Lr4 to Lr5, de-registers the plugin in the upgraded version, so if you want to maintain registration, a new ($0.01 if you like) registration code is needed in the upgraded version. It makes for a hassle every couple of years, I know. Sorry. See this note for details.

For details on plugin registration and on how I came into this hobby of Lightroom plugin development, see my Plugin Registration page.

Version History
( Update Log via RSS )

20141019.43 Windows Only: Add a one-time check for the POODLE security vulnerability, and alert the user if it exists.
20140910.42 Added iPhone 6, 6+, and a bunch of other devices
20140902.41 New build system
20140731.40 Registration fix for Lr5.6
20140720.39 More Creative-Cloud support.
20140715.38

Fixed an issue with Creative-Cloud revalidation.

20140712.37

Lr5.5 and later Creative-Cloud installs can now revalidate themselves if needed.

20140710.36 Sigh, had a bug in the Creative-Cloud support.
20140708.35

Now supports Lr5.5+ Creative-Cloud Installs.

20140704.34 Sigh, introduced an error for some folks with the rebuild the other day.
20140630.33 Build-system update
20140422.32

Fixed a bug in the "smoother revalidation" stuff recently added.

20140417.31

Make the revalidation process smoother, especially for folks using Lr5.4 and later.

20131102.29 Update for OS X Mavricks
20131023.28

Added a bunch of stuff to the device database, including new Apple iPads announced today.

20131010.27

Fixed a bug with the aspect-ratio reporting in the keyword-set dialog.

20130622.26

Now works with keywords even if they're not at the root of your keyword tree, so you can freely move the keywords to one subgroup (e.g. "Crops") and things still work smoothly. This creates some ambiguity if you have the same keyword in multiple locations, so don't do that. :-)

20130613.25 Better support for plugin revalidation.
20130611.24 Yet another Lr5 update
20130610.23 Final update for Lr5
20130506.22 Added some Samsung digital picture frames, Microsoft Surface tables, and some Samsung Galaxy models.
20130501.21 Update for Lr5
20130412.20 Build system update.
20130328.19 Fix for the registration system.
20130209.18 More build-system maintenance
20130206.17 Tweak for my registration system
20130201.16

Minor update for iPad mini.

20120913.15 Update for iPhone 5
20120608.14 Fix an "attempt to perform arithmetic on field" error.
20120526.13

Update to handle the Mac App Store version of Lightroom.

Tweak for Lr4.1RC2.

20120414.12

The crop-preview tool (OSX only) color selection stuff had stopped working... fixed it, and gave that whole area some extra UI love.

Some keyword interaction in the crop-preview tool wasn't working in all cases.

Enhanced the send-log dialog to hopefully make reports more meaningful to me, yielding, I hope, the ability to respond more sensibly to more reports.

20120330.11 Update to handle 4.1RC
20120320.10 Fixed an issue with aspect-ratio recognition.
20120308.8

Added data for new iPad and Galaxy Tab 10.1

Update to the debug logging to better track down timing issues that might arise.

Added a new "Standard for Galaxy Tab 10.1" keyword set.

Fixed some bugs related to aspect-ratio matching in the dialog.

20120229.7 More for Lr4.
20120221.6

Removed kludgy date-based random sort. Some updates for Lr4.

20120212.5

Added crop keyword sets, and a set editor.

For OSX only, added a crop-preview keyword-application dialog. It was a stupendous amount of work, but is very cool! See "Preview Crop" in the Plugin-Extras dialog.

More on the march toward Lr4, including upheaval in the code to handle Lightroom APIs being discontinued in Lr4.

20120114.4 More tweaks for Lr4b
20120112.3

Update for Lr4 beta: explain in the plugin manager that the plugin can't be registered in the beta.

20111210.2 Had issues with the registration button sometimes not showing.
20111104.1 initial release

Comments so far....

Hi Jeffrey,

I’ve been using (and contributed to the cause) several of your Lightroom Plugins for a while now. If you haven’t started on it already, I strongly suggest you develop an iCloud import/export plugin. I think there is going to be a large demand for it. There is an iCloud API so I think it is possible but I don’t know how hard it would be (certainly not as hard a Flickr).

Thanks and Seasons Greetings,
Jim Starr

I couldn’t find any info on the iCloud API. It may be there behind some paywall, but they have multiple paywalls (iOS, Mac, etc.) and no apparent way to tell what’s behind them. If you can find documentation on an HTTP/HTTPS API, I’d appreciate a link. —Jeffrey

— comment by Jim Starr on December 25th, 2011 at 8:02am JST (3 years ago) comment permalink

I followed your directions for publishing to an iPad, but I don’t understand one thing. If I publish via jF Tree, how does the crop for iPad fit into the cycle? I assume publishing does its own kind of export. Or does this particular export automatically utilize the crop for iPad?
Puzzled.

You need to add “Crop for iPad” as a Post-Process filter in the export (whatever export you use…. Tree Publisher, normal disk, etc.). It takes the result of the export, and applies a crop as per its own settings. —Jeffrey

— comment by Daniel Neuman on January 25th, 2012 at 2:26am JST (2 years, 11 months ago) comment permalink

Jeffrey, I think you can start with http://developer.apple.com/icloud/index.php

— comment by Boris on January 31st, 2012 at 6:15pm JST (2 years, 11 months ago) comment permalink

I have a new iPad 3 and I’m trying to set up “Crop for iPad” – but I’m running into trouble in the Keyword Set section. If I select Apple iPad 3rd gen as the “Target Device” and Standard for iPad as the “Crop Control Keyword Set” I get a red error message that reads “WARNING: aspect ratio does not match the intended aspect ratio of the crop-control keyword set.”

Also, there are no instructions for the FTP Transfer section which I’d love to use since I plan to use Photo Manager Pro as well.

Please help?

Thanks
Mark

If I only had a new iPad for testing… :-) I’ve pushed a fix, sorry about that. As for the FTP stuff, it should be pretty easy to figure out…. turn on the FTP server in FMP, then copy its settings to the FTP dialog in the plugin… —Jeffrey

— comment by Mark on March 20th, 2012 at 1:28pm JST (2 years, 9 months ago) comment permalink

I bumped into this plugin after posting a question here: http://forums.adobe.com/thread/997258?tstart=0

This plugin seems to do half of what I need. Question for Jeffrey, is it possible to enhance the plugin so that rather than giving a handful of hard-coded crop options maybe you can allow an arbitrary crop for each image to be saved using a naming convention? Is it possible to save the current crop setting into a piece of metadata?

Lightroom currently makes that very difficult… there’s no way to apply the crop at export time, and I’m not even sure whether we have access to the crop in the first place. It was a miracle that I was able to get as much working as I did. —Jeffrey

— comment by Bob on May 1st, 2012 at 2:54pm JST (2 years, 8 months ago) comment permalink

I did a bit reading on the SDK, it seems that the crop is available in LrPhoto class’ photo:getDevelopSettings(), in those members with names like CropXXX. However, this must the current crop set in develop module.

I was thinking about adding custom metadata fields via photo:setPropertyForPlugin() to hold multiple crop settings. For example, add a button or menu item to record the current crop dimensions into a selected custom metadata field called “iPadCrop”. The part that I’m unsure about is how to use such metadata during export. I don’t see any photo:setDevelopSettings() function avaiable so I can’t apply the crop setting using the metadata on the fly. Do you think this is a worthwhile option for me to pursue?

You can apply develop settings via a preset (LrPhoto:applyDevelopPreset), but the crop is not included in develop presets. I don’t know of any way to apply an arbitrary crop on export, which is why I have the plugin do it outside of Lightroom. —Jeffrey

— comment by Bob on May 3rd, 2012 at 11:43am JST (2 years, 8 months ago) comment permalink

Hi the Workflow for iPad is the best ever i found so far ;-) ty so much for that ;-)
I have one small addition or questions… as you i use Photo Manager Pro, but i am still missing the feature to enable an AirPlay slideshow…

So any idea or hint how it could be possible to enable a slideshow via AirPlay to AppleTV or another Workflow for that…

I mean to show a big group photos on a small iPad is not nice ;-)

Cheers alex

I don’t know anything about AirPlay or AppleTV, sorry. —Jeffrey

— comment by OrinocoDelta on October 9th, 2013 at 5:58pm JST (1 year, 2 months ago) comment permalink
Leave a comment...


All comments are invisible to others until Jeffrey approves them.

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

More or less plain text — see below for allowed markup

You can use the following tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

Subscribe without commenting