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

{yearNow}

Year 'now' in the form YYYY.

e.g. 2017

{monthNow}

Month 'now' (01 to 12)

e.g. 07 for July

{dayNow}

Day 'now' (01 to 31)

e.g. 23

{dateNow} or {date}

Date 'now' in the form YYYY-MM-DD

e.g. 2020-11-28

{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

{monthLess8h}

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

e.g. 07 for July

{dayLess8h}

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

e.g. 23

{dateLess8h}

Year, month, day less 8 hours in the form YYYY-MM-DD

e.g. 2017-07-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,{filename}} for D:\Photos\image1.jpg will give: image

{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,{filename}} for D:\Photos\image1.jpg will give: mag
{mid,3,,{filename}} for D:\Photos\image1.jpg will give: ge1

{right,n,str}

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

{right,2,{filename}} for D:\Photos\image1.jpg will give: e1

{field,n,str}

Extracts the nth field from str. Fields are separated by space, period, hyphen, slash, backslash or underscore characters

{field,2,{filename}} for D:\Photos\IMG_0001.jpg will give: IMG

{field2,n,ch,str}

Extracts the nth field from str using the character ch as the field separator

{field2,2,-,one-two-three} will give: two

{first,str}

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

{first,%L} for an image taken Monday, January 17, 2015 will give: Monday

{last,str}

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

{last,%L} for an image taken Monday, January 17, 2015 will give: 2015

{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

{default,str1,str2}

Returns str1 unless it is an empty string in which case it returns str2 (str1 and str2 can be strings or tokens

{default,1,2} returns 1
{default,,2} returns 2

{if,test,str1,str2}

Returns str1 if test contains any text except 0 else returns str2 (test, str1 and str2 can be strings or tokens)

{if,1,2,3} returns 2

{if,0,2,3} returns 3
{if,,2,3} returns 3

{compare,str1,str2}

Returns 1 if str1 is the same as str2 else returns an empty string

{compare,photo,photo} returns 1, {compare,photo,image} returns empty string

{contains,str1,str2}

Returns 1 if str1 contains str2 else returns an empty string

{contains,photo,to} returns 1, {contains,photo,camera} returns empty string

{random,n,m}

Returns a random number in the range n to m. A new random number is generated each time the ready screen is displayed in photo booth mode

{random,1,10} returns a random number between 1 and 10

{urlencode,str}

Encodes str so that it can be used as a parameter in a URL e.g. when providing a URL for a microsite

https://yoursite.com/viewer.php?id={urlencode,my name} gives https://yoursite.com/viewer.php?id=my%20name

 

 

Event info tokens

 

Hotfolder Prints, Breeze Viewer, the SmugMug uploader and the 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

{srcPhotoPathname<n>}

The full pathname (drive, folder, filename and file extension) of the the nth source image e.g. {srcPhotoPathname1} gives the full pathname of the first source photo

{srcPhotoFilename<n>}

The filename (filename and file extension) of the the nth source image e.g. {srcPhotoFilename2} gives the filename (including file extension) of the second source photo

{srcPhotoFilenameNoExt<n>}

The filename (without file extension) of the the nth source image e.g. {srcPhotoFilenameNoExt1} gives the filename of the first source photo

{srcPhotoSubfolder<n>}

The subfolder of the nth source image e.g. gives Hashtag if the pathname of the source image is C:\Twitter\Hashtag\Photo.JPG

{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

{uid}

Unique id in the form ABC12345 updated before processing each set of photos. It can be used in captions and to specify the output filename. The id is guaranteed not to repeat within 72 hours and is very unlikely to repeat within 10 years.

{uid2}

Alternative unique id in the form ABCDE123 updated before processing each set of photos. It can be used in captions to specify the output filename. The id is guaranteed not to repeat within 776 days and computers processing photos at exactly the same time have a 1 in 216,000,000 chance of generating the same id.

{summaryDate}

The date in the form YYYY-MM-DD read from the XML summary file. Please note that this token is only used by Breeze Gallery Uploader