Tokens

Top  Previous  Next

The following tokens are available for using in the caption text. The values are read from the EXIF shooting data in the first image used in the print layout.

 

Date and time tokens

%a

Abbreviated weekday name

e.g. Fri

%A

Full weekday name

e.g. Friday

%b

Abbreviated month name

e.g. Jun

%B

Full month name

e.g. June

%d

Date in the form YYMMDD (equivalent to %y%m%D)

e.g. 170611 for June 11, 2017

%D or {day}

Day of the month (01 to 31)

 

%H

Hour (00 to 23)

 

%I

Hour (01 to 12)

 

%j

Day of the year (001 to 366)

 

%l

Long date/time representation of locale

e.g. Monday, July 25, 2017 19:03:47

%L

Long date representation for locale

e.g. Monday, June 25, 2017

%m or {month}

Month (01 to 12)

e.g. 06 for June

%M

Minutes (00 to 59)

 

%p

am/pm indicator

e.g. PM

%S

Seconds (00 to 59)

 

%t

Time in the form HHMMSS (equivalent to %H%M%S)

 

%W

Week number (00 to 53)

 

%x

Date representation for locale

e.g. 06/10/17 for June 10, 2017

%X

Time representation for locale

e.g. 14:39:29

%y

Year without century

e.g. 16

%Y or {year}

Year with century

e.g. 2017

%z

Time zone name

e.g. GMT Standard Time

%Z

Time zone offset wrt UTC

e.g. +0100 for GMT during DST

%1 or {yearNow}

Year 'now' in the form YYYY.

e.g. 2017

%2 or {monthNow}

Month 'now' (01 to 12)

e.g. 07 for July

%3 or {dayNow}

Day 'now' (01 to 31)

e.g. 23

%4 or {yearLess8h}

Year 'now - 8 hours' in the form YYYY.
The 8 hour offset is to allow date tokens to remain the same for events which continue after midnight

e.g. 2017

%5 or {monthLess8h}

Month 'now - 8 hours' (01 to 12)

e.g. 07 for July

%6 or {dayLess8h}

Day 'now - 8 hours' (01 to 31)

e.g. 23

 

Shooting data tokens

%c

Camera serial number (Canon EOS cameras only)

 

%C

Canon EOS-1D/1DS style camera serial number

 

%e

File extension (without the '.')

e.g. JPG for IMG_4567.JPG

%i

ISO value read from the shooting data

 

%o

Image filename without extension

e.g. IMG_4567

%O

Owner string (Canon cameras only)

 

%T

Camera model name starting from the first word containing digits

e.g. 80D for Canon EOS 80D

%T1

Same as %T, but '-' are treated as spaces

e.g. 1DX for Canon EOS-1DX

%T2

Full camera model name

e.g. Canon EOS 80D

%T3

First word of camera model name containing digits

e.g. DC4800 for KODAK DC4800 ZOOM DIGITAL CAMERA

%T4

Same as %T3, but '-' are treated as spaces

 

%T5

Last word of camera model name containing digits

e.g. 80D for Canon EOS 80D

%T6

Same as %T5, but '-' are treated as spaces

e.g. 1DX for Canon EOS-1DX

%v

Camera model name starting from the first word containing digits (same as %T)

 

%V

Full camera model name (same as %T2)

 

{comment}

The contents of the EXIF UserComment field

 

 

Tokens for modifying strings

 

The tokens below can be used to modify tokens or strings:

 

Token

Description

Example

{left,n,str}

Extracts the first n characters from str (which can be a string or token).

{left,4,%T2} for an image taken with a Nikon D800 will give: Niko

{mid,n,m,str}

Extracts m characters starting from the n'th character from str (which can be a string or token).

{mid,1,3,%T2} for an image taken with a Nikon D800 will give: iko
{mid,3,,%T2} for an image taken with a Nikon D800 will give: on D800

{right,n,str}

Extracts the last n characters from str (which can be a string or token).

{right,3,%T2} for an image taken with a Nikon D800 will give: 800

{first,str}

Extracts the first word from str (which can be a string or token).

{first,%T2} for an image taken with a Nikon D800 will give: Nikon

{last,str}

Extracts the last word from str (which can be a string or token).

{last,%T2} for an image taken with a Nikon D800 will give: D800

{upper,str}

Converts str to upper case

{upper,%B} for a photo taken in June gives: JUNE

{lower,str}

Converts str to lower case

{lower,%B} for a photo taken in June gives: june

{capitalize,str}

Converts str to lower case and capitalizes the first letter

{capitalize,john} gives John

{field,n,str}

Extracts the nth field from str. Fields are separated by space, \, /, ., - or _

{field,2,{filename}} for filename IMG_1234.jpg would give 1234

{if,test,truevalue,falsevalue}

Conditional test which returns truevalue if "test" is not an empty string else it returns falsevalue

{if,,v1,v2} returns v2, {if,1,v1,v2} returns v1

 

Event info tokens

 

Hotfolder Prints, Breeze Viewer, the SmugMug uploader and the Instagram and Twitter hashtag monitors can all use the event info shared by other Breeze Systems' apps (e.g. DSLR Remote Pro v3.7.2 onwards) that save the information in the Windows registry under the registry key HKEY_CURRENT_USER\Software\BreezeSystems\Event Info

 

{eventName}

The event name read from HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventName

{eventString1}

Event string 1 read from HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString1

{eventString2}

Event string 2 read from HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString2

{eventString3}

Event string 3 read from HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString3

{eventString4}

Event string 4 read from HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString4

{eventString5}

Event string 5 read from HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString5

 

Other tokens
 

{filename}

Filename (including folder) of the saved print layout JPEG image. If the pathname contains spaces this will be automatically converted into a Windows short pathname when used in the command run after saving the JPEG copy of the output.

{filenameDir}

Directory path of the saved print layout JPEG image e.g. If the JPEG image of the saved print layout is C:\Photobooth\2013-10-16\IMG_0001.JPG {filenameDir} evaluates to C:\Photobooth\2013-10-16\

{filenameNoExt}

Filename (without folder or file extension) of the saved print layout JPEG image e.g. If the JPEG image of the saved print layout is C:\Photobooth\2013-10-16\IMG_0001.JPG {filenameNoExt} evaluates to IMG_0001

{user_data}

Information (e.g. email address) entered by users using the touchscreen keyboard option in Breeze Systems' photobooth software

{user2_data} to {user9_data}

Additional information (e.g. name, phone number) entered by users using the touchscreen keyboard option in Breeze Systems' photobooth software

{user_data_emails}

Special token for use with the command run after saving the JPEG copy of the output. The {user_data} tokens are scanned for correctly formed email addresses (e.g. name@domain.com) and the command is called for each email address

{text1} to {text5}

Text read from the Windows registry when printing. This is useful if another app needs to modify caption text used by Hotfolder Prints while it is running.
Example registry key: e.g. HKEY_CURRENT_USER\Software\BreezeSystems\HotfolderPrints\100\{text1}

{output}

The value of the <output> tag read from the photobooth summary XML file written by Breeze Systems' photobooth software