Announcement: TPE Lightroom Classic Plugin Now Available

We have a shiny, new Lightroom Classic Plugin for TPE now available.

You can download it here.

Purpose

The plug-in is simple: it allows you to generate a link to TPE from the metadata in your photos. There are three things you can do:

  • Open in TPE to view the shot circumstances (time, date, place)
  • Add a TPE URL as metadata to the image in your Lightroom Catalog
  • Include a TPE URL in the metadata of exported images

This can be helpful to view the light conditions at the time and place a shot was taken. Reviewing the circumstances of images that worked well vs those that did not, can be helpful in guiding your future planning.

You can also perform a visual search using the ‘current position’ of the Sun, Moon or Galactic Center derived from an old photo to find out when the circumstances might recur in the future.

Adding the Plug-in

  1. Download the ZIP file and decompress it if necessary. It includes a comprehensive README.txt file that you may wish to read
  2. In Lightroom Classic, choose Plug-in Manager… from the File menu.
  3. Click Add on the left, and locate the plugin file, named tpe.lrplugin
  4. Select this to add it as a new plug-in

If all went well, you should see something like this:

Add TPE Metadata

To try it out, select an image in the Library module - make sure its one that already as GPS Location metadata (or locate the image on the Map in Lightroom’s Map module first):

Then, from the Library or Help menus, choose Plug-in Extras / Add TPE Metadata. You’ll see a dialog as shown:

If all you want to do is to view the shot in TPE, click “Open in Browser” and the web app will open with the displayed URL. It will show the primary red map pin at the given location, and the date/time will be set to that of the capture time of the photo.

You can then either choose Add or Cancel. If you choose cancel, no changes are applied to the photo.

If you choose Add, the plugin will add three metadata fields to the photo in your Lightroom Catalog. You can view them by inspecting the metadata panel, choosing "The Photographer’s Ephemeris” as the category:

The TPE URL is saved with the image in your catalog so you can access the link from metadata at any time. Last Generated shows when the link was last updated. Has GPS Location indicates the link includes a location - you can filter on these fields to find images which have links with or without location included.

If a link does not include a location, then Photo Ephemeris Web will open at an undefined location - it will depend on your settings and last use. However, the correct date/time will be selected.

If you select multiple photos, and then choose Add TPE Metadata, the plug in will not display a dialog, but will determine the URL and update the catalog metadata for each image.

Including TPE URL Metadata in Exported Files

From the Export dialog, you can now include a TPE URL in the exported image metadata:

Choose your export Preset, then click Insert to add the Include TPE URL post-process action. You’ll see options towards the end of the export steps:

To use this tool, you will need to have previously installed ExifTool on your computer. The UI shows whether or not the tool is detected.

When you export your image or images, the TPE URL is included in the dc:relation XMP metadata field. This is a standard field that is used to describe resources related to the photo.

Not all tools (e.g. Preview on macOS) will display the field, but you can easily query it using exiftool, e.g. run exiftool -XMP-dc:Relation myphoto.jpg

Feedback

If you have a chance to try out the plug-in, please let me know what you think or if you run into any issues using it.

I have a few enhancements in mind for the future, but would love to hear whether you find this helpful or not.

1 Like

This looks really cool!

I like the concept of going back to the conditions when a photo was taken in hopes of gleaning some photographic wisdom.

I’ve not updated my Lightroom Classic recently and am running v12.5. I had the metadata panel showing the “The Photographer’s Ephemeris” section as I added TPE metadata to a photo. Often the Metadata panel did not show the added TPE metadata until I selected another photo and then reselected the photo I added the TPE metadata to. Only twice did it update the metadata panel as soon as I clicked on Add, and then OK buttons. The photos were taken with an iPhone 12 Pro. What is the expected behavior?

1 Like

Hi @gapcam - thanks for trying it out. I don’t think I noticed this in my testing, but will check. I’ll see if I can reproduce that and report back. The plugin doesn’t control the Lightroom UI behavior after you click ‘OK’ in the dialog, so that may be something I can’t fix directly. I guess the main thing to be certain of is that the metadata is getting added, even if it doesn’t immediately display.

It makes sense that it’s the responsibility of the Lightroom code to properly update the metadata field once it’s been populated.

I have a request - would it be possible to have the option when generating the TPE URL, to have it point to the 3D model instead of the “MAP” page? I know it’s easy to go to the main map page and then click on “3D” in the menu, but going directly to that 3D page would be nice.

And, I’m just dreaming here - I know most GPS’ don’t include the direction the camera is pointing, but loading the 3D model pointing in the direction the photo was taken would be really cool!

Greg

I ran Lightroom (v12.5) this morning and there was no TPE metadata for photos I’d previously added that metadata to. I went to install the plug-in again and when the Lightroom Plug-in Manger window appeared, the TPE plug-in was not listed. Once I added the plug-in again, the TPE metadata immediately appeared in the Metadata panel again.

I decided to shut down my computer and a while later start it again, in case the plug-in is not persisting between restarts. I then ran Lightroom and this time the TPE metadata was available, so hopefully the plug-in will remain installed. I’ll let you know if this problem resurfaces again.

Greg