Privacy Policy | Follow us on Twitter

Tokens

LR/Transporter makes heavy use of Tokens. These are special pieces of text that are replaced during the export process, typically by real metadata from the photo. They can easily be recognised by the curly brackets around their name. You don't need to remember all the possible tokens, each field that accepts tokens has a Metadata button that allows you to choose a token from the list.

A particular photo may not have the metadata that you've asked for defined. For the reason you may optionally give a value to be used in case of missing metadata. To do this, separate the token name from the value by a comma. For example, {shutterSpeed,Unknown speed} will result in 'Unknown speed' if the shutter speed information isn't available.

The replacement can even contain other tokens, and this can go on without limit:

Date and time: {dateTime,Original date and time: {dateTimeOriginal,Digitised date and time: {dateTimeDigitized}}}

Optional Modifiers

Some tokens accept extra parameters that may be useful to you...

Date and time fields

Metadata for the various dates and times can be formatted according to your own specification. The format should be giving in square brackets following the token name, as this example shows:

{dateTime[%Y/%m/%d %H:%M],No date or time found}

The format can contain the following special character sequences for time and date elements:

  • %B: Full name of month
  • %b: 3-letter name of month
  • %m: 2-digit month number
  • %d: Day number with leading zero
  • %e: Day number without leading zero
  • %j: Julian day of the year with leading zero
  • %y: 2-digit year number
  • %Y: 4-digit year number
  • %H: Hour with leading zero (24-hour clock)
  • %I: Hour with leading zero (12-hour clock)
  • %M: Minute with leading zero
  • %S: Second with leading zero
  • %p: AM/PM designation
  • %%: % symbol

Shutter Speed

Shutter speeds greater than 1 second are either returned as a whole number (e.g. 6) or else rounded to two decimal places (e.g. 1.30). You can force a different precision, such as 3 decimal places in this example:

{shutterSpeed[3]}

Keywords

By default keywords are separated by commas. You may specify your own character(s) used to separate keywords by placing the character(s) in square brackets after the 'keywordTags' token name. For example, to use a semicolon:

{keywordTags[;]}

Sequence numbers

Sequence numbers can have padded zeros and a start value. For example, to pad the sequence number to 5 digits starting with 20:

{seq[00020]}

Ratings

By default the {rating} token returns the rating as a number (e.g. 3). If there's an optional parameter it'll instead return that parameter repeated accordingly. For example:

{rating[3]}

would return *** for a 3 star image.

GPS

The {gpsLongitudeDecimal} and {gpsLatitudeDecimal} tokens take a parameter to force a certain number of decimal places. E.g.:

{gpsLongitudeDecimal[3]}

External file contents

The two tokens that include the contents of another file take the path to that file as a paramter:

{fileContentsAbsolute[/Users/Tim/Desktop/MyFile.txt]}
{fileContentsRelative[../MyFile.txt]}

Metadata from 3rd party plugins

You can access the metadata fields of 3rd party applications by using the 'pluginField' token and passing in the plugin's ID and the field ID. You should contact the plugin's vendor for this information.

{pluginField[info.regex.lightroom.export.smugmug2,url]}

This is a donationware product. To unlock the full functionality the author requests that you make a donation to support future development.

Payments may be made via Credit Card or PayPal, and are securely processed via our payment partner - Paddle.


How many Euros would you like to donate?

€  

Approx:

US $-
UK £-

Please note that VAT will be added for European customers.

Lost your registration?