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]}
| 