Tokens

Top  Previous  Next

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. 110617 for June 11, 2017

%D

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, January 17, 2017 19:03:47

%L

Long date representation for locale

e.g. Monday, January 17, 2017

%m

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_14_17 for June 14, 2017

%X

Time representation for locale

e.g. 14_39_29

%y

Year without century

e.g. 17

%Y

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

{timeNow}

Time 'now' in the form HHMMSS

 

{yearNow}

Year 'now' in the form YYYY

e.g. 2017

{monthNow}

Month 'now' (01 to 12)

e.g. 06

{dayNow}

Day 'now' (01 to 31)

e.g. 17

{yearLess8h}

Year with century 8 hours ago - useful when shooting events which continue after midnight

e.g. 2017

{monthLess8h}

Month (01 to 12) 8 hours ago - useful when shooting events which continue after midnight

e.g. 01

{dayLess8h}

Day of the month (01 to 31) 8 hours ago - useful when shooting events which continue after midnight

e.g. 19

{dateLess8h}

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

e.g. 2018-01-21

 

Folders
 

{documents}

The current user's documents folder

e.g. C:\users\chris\Documents

{desktop}

The current user's desktop folder

e.g. C:\users\chris\Desktop

{profile}

The current user's profile folder

e.g. C:\users\chris

 

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

 

{iso}

ISO value read from the shooting data (same as %i)

 

{tv}

Shutter speed with the leading 1/ removed e.g. a shutter speed 1/125 sec gives a value of 125

 

{av}

Aperture setting

 

{orientation}

Image orientation: L for landscape or P for portrait

 

{orientationAngle}

Image orientation angle in degrees: 0, 90 or 270

 

%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. 80D for Canon EOS 80D

%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)

 

 

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

{lessThan,str1,str2}

Returns 1 if str1 less than str2 else returns an empty string. If both str1 and str2 are integers it performs a numerical comparison otherwise it performs an alphabetical string comparison

{lessThan,1984,2023} returns 1, {lessThan,dogs,cats} 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

{tinyUrl,url}

Converts a URL to a shortened version using tinyurl.com

https://www.breezesys.com/solutions/booth/ is shortened to https://tinyurl.com/3ns9dvwc

 

 

Other tokens
 

{comment}

The value of comment entered in the main window

 

{artist}

Artist string stored in the camera (not available on very old camera models)


{author}

Same as {artist}


{copyright}

Copyright string stored in the camera (not available on very old camera models)


{copy}

Same as {copyright}


{photoboothNumImages}

Number of shots defined in photo booth mode

e.g. 4

{photoboothImage}

Shot number in photo booth shooting sequence

e.g. first photo returns 1

{photoboothDateTime}

Date and time at the start of the current photo booth shooting sequence

e.g. 20110126_190509

{photoboothDate}

Date at the start of the current photo booth shooting sequence

e.g. Jan 26, 2011 returns 20110126

{photoboothTime}

Time at the start of the current photo booth shooting sequence

e.g. 7:05:09 pm returns 190509

{photoboothDir}

The value of the full pathname of the photo booth images folder

e.g. C:\Photobooth\Profile1

{photoboothSubdir}

The value of the photo booth images subfolder

e.g. C:\Photobooth\Profile1 gives Profile1

{photo1}, {photo2} etc.

Filename (without file extension or directory path) of each photo in photo booth mode


{imageCounter}

Shutter activation count (the total number of pictures that have been taken with the camera)

e.g. 1234

{imageCounter5}

Same as {imageCounter} but padded with leading zeroes to give a 5 digit number

e.g. 01234

{imageCounter6}

Same as {imageCounter} but padded with leading zeroes to give a 6 digit number

e.g. 001234

{filename}

Filename of the saved print layout in photo booth mode (only available for captions used in photo booth prints and in email text)

e.g. 20161028_193423.JPG

{filenameNoExt}

Same as {filename} but returns the filename without a file extension

e.g. 20161028_193423

{isGif}

Returns 1 if the file is an animated GIF else returns 0 (only available when sharing)


{isJpeg}

Returns 1 if the file is a JPEG image else returns 0 (only available when sharing)


{isMovie}

Returns 1 if the file is a movie file else returns 0 (only available when sharing)


{uid}

Unique id in the form ABC12345 updated at the start of each photo booth shooting sequence. Can be used in captions and the filename prefix. 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 at the start of each photo booth shooting sequence. Can be used in captions and the filename prefix. The id is guaranteed not to repeat within 776 days and two photo booths running at exactly the same time have a 1 in 216,000,000 chance of generating the same id.


{uid3}

Alternative unique id in the form ABC123DEF updated at the start of each photo booth shooting sequence. Can be used in captions and the filename prefix.


{guid}

128-bit integer which is globally unique to a high degree of certainty. It is updated at the start of each photo booth shooting sequence.

e.g. d8de5c08-a9b0-4043-9bd9-07fe1fa33b6a

{message}

Message entered by the user when using the "Message input at end of sequence" touchscreen keyboard option


{sharingMessage}

Optional message entered by the user when sending emails


{user1_data}

The text entered by the user in prompt 1 of the touchscreen keyboard. This token can be used in caption text in print layouts when the "Email input at start of sequence" or "Email input after taking photos" touchscreen keyboard options are selected. Use {user2_data} for the text in prompt 2 etc.


{survey1_text1}

Text entered by the user in prompt 1 of survey screen 1. Use {survey1_text2} for the text in prompt 2 etc. Use {survey2_text1} for the text in survey screen 2 etc.


{survey1_chkbox1}

Value of checkbox 1 set in survey screen 1. Use {survey1_chkbox2} for the checkbox 2 2 etc. Use {survey2_chkbox1} for checkbox 1 in survey screen 2 etc

1 if the checkbox was selected
0 if the checkbox was not selected

{printTemplateName}

Filename part of the last print template to be loaded (can also be shared with other applications via the Windows registry)

e.g. John & Jane for C:\PrintTemplates\John & Jane.pblt

{eventName}

Event name that can be shared with other applications via the Windows registry

e.g. John & Jane

{eventDate}

Event date in the form YYYY-MM-DD that can be shared with other applications via the Windows registry

e.g. 2022-11-02

{eventId}

Event id that is calculated using the MD5 checksum of the event name + event date

e.g. 1e73da35a8362d03b496fa30d901d0d0

{eventKiteGalleryId}

Id identifying a gallery when using Event Kite for online galleries and micro-sites


{eventKiteSessionId}

A unique id when using Event Kite in the form ABC123DEF. This is updated at the start of each photo booth shooting sequence and be used in captions, QR codes and the filename prefix.


{eventString1} to {eventString5}

Additional event information that can be shared with other applications via the Windows registry


{printQuotaUsed}

Returns 0 if the remaining prints counter is more than 0 else returns 1.
Please note:the print counter to use depends on the event settings


{eventPrintCounter}

The current value of the event print counter i.e. the prints remaining


{localPrintCounter}

The current value of the DSLR Remote Pro print counter i.e. the prints remaining


{qr1} to {qr10}

Strings scanned in using the QR code reader options


{to}

The 'to' email address when sending emails or the 'to' phone number when sending texts. This token is only available in the message body when sending emails or texts


{print_layout}

 

The JPEG copy of the print layout used when embedding images in emails

e.g. <img src="{print_layout}">

{photo<n>}

Individual photos used when embedding images in emails

e.g. <img src="{photo1}"><br>
<img src="{photo2}">

{thumbnail<n>}

Individual thumbnails used when embedding images in emails

e.g. <img src="{thumbnail1}"><br>
<img src="{thumbnail2}">

{gif}

Slideshow GIF or boomerang GIF when embedding images in emails

e.g. <img src="{gif}">

{video_preview}

JPEG preview of the video when embedding images in emails

e.g. <img src="{video_preview}">