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 17, 2011

%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, 2011 19:03:47

%L

Long date representation for locale

e.g. Monday, January 17, 2011

%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_17_11 for June 17, 2011

%X

Time representation for locale

e.g. 14_39_29

%y

Year without century

e.g. 11

%Y

Year with century

e.g. 2011

%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. 2011

{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. 2012

{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

 

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

%T1

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

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

%T2

Full camera model name

e.g. Canon EOS 60D

%T3

First word of camera model name containing digits

e.g. 60D for Canon EOS 60D

%T4

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

 

%T5

Last word of camera model name containing digits

e.g. 60D for Canon EOS 60D

%T6

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

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

%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

{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

{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

 

 

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

{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.


{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 or uploading to Facebook


{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

John & Jane

{eventString1} to {eventString5}

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