Filename and Directory tokens

Top  Previous  Next

This section lists the tokens that can be used to specify the download directory and filename. Please see the section on "Using filename and directory tokens" for information on how to use tokens.

 

Shooting 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. 040611 for June 11, 2004

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

 

{m}

Month (01 to 12)

e.g. 06 for June

{M}

Minutes (00 to 59)

 

{p}

am/pm indicator (upper case)

e.g. PM

{plc}

am/pm indicator (lower case)

e.g. pm

{P}

Quarter: Jan-Mar=1, Apr-Jun=2, Jul-Sep=3, Oct-Dec=4

e.g. Q{P} gives Q2 for June

{s}

Date/time subsecond timing (only available with some cameras e.g. Nikon DSLRs and recent Canon DSLRs when using a card reader e.g. 40D and 1DMk3)

e.g. 56

{S}

Seconds (00 to 59)

 

{t}

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

 

{epoch}

Time in seconds since January 1, 1970 (10-digit number)

e.g. 1159805283 for 17:08:03 on Oct 2, 2006

{epoch36}

Time in seconds since January 1, 1970 expressed in base 36 using the characters 0-9 and A-Z (6 character string)

e.g. J6INHF for 17:08:03 on Oct 2, 2006

{W}

Week number (00 to 53). Week 01 is the first week of the year containing a Monday

e.g. 00 for Tuesday 1st January 2013

{WI}

ISO week number (00 to 53). Week 01 is the first week of the year containing a Thursday.
Note: This doesn't strictly adhere to the ISO standard because it returns 00 for Sun 2 Jan 2005 when it should return 53. The full ISO week date for Sun 2 Jan 2005 is actually 2004-W53-7.

e.g. 01 for Tuesday 1st January 2013

{IWD}

Full ISO week date in the form year, week number, day number

e.g. 2013-W01-2 for Tuesday 1st January 2013

{x}

Date representation for locale

e.g. 06_11_04 for June 11, 2004

{X}

Time representation for locale

e.g. 14_39_29

{y}

Year without century

e.g. 04 for 2004

{Y}

Year with century

e.g. 2004

{z}

Time zone name

e.g. GMT Standard Time

{Z}

Time zone offset wrt UTC

e.g. +0100 for GMT during DST

{#c}

Long date/time representation for locale (IPTC data only)

e.g. 29 December 2005 15:34:26

{#x}

Long date representation for locale (IPTC data only)

e.g. 29 December 2005

{1}

Year 'now' in the form YYYY i.e. the download date

e.g. 2004

{2}

Month 'now' (01 to 12) i.e. the download date

 

{3}

Day 'now' (01 to 31) i.e. the download date

 

{4}

Year 'now' in the form YY i.e. the download date

e.g. 04 for 2004

{5}

Year less 3 hours in the form YYYY. This is useful when shooting events which start in the evening and continue into early the next morning and you want to use the same date for the whole event. The tokens {5}, {6}, {7} and {8} return the date the image was shot less 3 hours. Using these tokens will ensure that images shot before 3am will use the previous day's date.

e.g. shots for a new Year's eve party on 31 December 2004 will return 2004 up to 3am on 1 January 2005.

{6}

Month less 3 hours (01 to 12). Please see {5} for full description

 

{7}

Day less 3 hours (01 to 31). Please see {5} for full description

 

       

 

Shooting data tokens

 

{c}

Camera serial number (Canon EOS cameras and recent Nikon digital SLRs only)

 

{C}

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

 

{e}

File extension (without the '.')

e.g. JPG for IMG_4567.JPG

{E}

File type based on the file extension. Evaluates to "JPG" for .JPG, .JPE and .JPEG extensions and to "RAW" for all other extensions. Suggested use: To separate JPEGs and raw files when shooting in raw+JPEG mode.

e.g. Set download directory to D:\Photos\{E} and JPEGs will downloaded to: D:\Photos\JPG and all other files will be downloaded to: D:\Photos\RAW

{E1}

Same as {E} except it evaluates to an empty string for JPEG files and "RAW" for other file types.


{E2}

Same as {E} except it evaluates to "JPG" for JPEG files and an empty string for other file types.


{E3}

Same as {E} except it evaluates to an "JPG" for JPEG files and "MOV" for other file types.


{E4}

Same as {E} except it evaluates to an empty string for JPEG files and "MOV" for other file types.


{E5}

Same as {E} except it evaluates to "MOV" for movie files and THM thumbnails and an empty string for other file types.

 

{E6}

Same as {E} except it evaluates to "RAW" for raw files and an empty string for other file types.

 

{E7}

Same as {E} except it evaluates to "movies" for movie files and THM thumbnails and an empty string for other file types.

 

{E8}

Same as {E} except it evaluates to an empty string for movie files and THM thumbnails and "pictures" for other file types.

 

{E9}

Same as {E} except it evaluates to "videos" for movie files and THM thumbnails and an empty string for other file types.

 

{f}

First 3 characters of image name

e.g. IMG for IMG_4567.JPG

{file[n-m]}

Extract characters from the filename:
{file[n-m]} returns characters n to m of the original filename {file[n]} extracts character n from the original filename

{file[n-]} returns the filename starting from character n

{file[-n]} returns n characters starting from the end of the filename

e.g. Using filename IMG_4567.JPG
{file[2-4]} gives MG_
{file[3]} gives G

{file[3-]} gives G_4567

{file[-6]} gives G_4567

{i}

ISO value read from the shooting data

 

{k}

ISO value read from the shooting data (same as {i} except ISO 0 is returned as "Auto")

 

{K1}

Lens focal length in mm

e.g. 28

{K2}

Aperture

e.g. 5.6

{K3}

Shutter speed

e.g. 125 for 1/125 sec

{o}

Image folder name when used in download directory, original image name when used for filename

e.g. \DCIM\123CANON\IMG_4567.JPG evaluates to: 123CANON when used in the download directory IMG_4567 when used in the filename

{O}

Owner string (Canon cameras only)

 

{q}

The number of the image folder

e.g. 123 for images in \DCIM\123CANON

{Q}

Image folder name

e.g. 123CANON for images in \DCIM\123CANON

{Q1}

Source folder pathname without drive name ({Q} prefixed with \DCIM\ when downloading directly from a Canon camera)

e.g. \DCIM\456NIKON

{Q2}

Source folder pathname relative to source folder (same as {Q1} when downloading directly from a Canon camera)


{Q3}

First character of source folder when downloading from a card reader (i.e. the drive letter)


{readOnly}

Returns 'read_only' if file is read only or empty string otherwise

e.g. read_only for a file that is read only

{readOnly1}

Returns 'high' if file is read only or empty string otherwise

e.g. high for a file that is read only

{readOnly2}

Returns 'high' if file is read only or 'low' otherwise. Useful when important images are marked as protected in the camera before downloading as it can be used to sort them into high and low priority folders.

e.g. low for a file which is not read only

{r}

Image number

e.g. 4567 for IMG_4567.JPG

{r1}

Last digit of the image number. Useful when renaming using the date and time and shooting at more than 1fps e.g. {d}_{t}_{r1}

e.g. 7 for IMG_4567.JPG

{r2}

Last two digits of the image number. Useful when renaming using the date and time e.g. {d}_{H}{M}_{r2}

e.g. 67 for IMG_4567.JPG

{r3}

Last three digits of the image number

e.g. 567 for IMG_4567.JPG

{r4}

Last four digits of the image number

e.g. 4567 for IMG_4567.JPG

{r5}

Last digit of the folder number followed by the last four digits of the image number

e.g. 34567 for IMG_4567 in folder 123CANON

{r6}

First digit of the folder number followed by the last four digits of the image number. This is useful for cameras where only the first digit of the folder number is unique and the last two digits are the same as the first two digits of the image number.

e.g. 14567 for IMG_4567 in folder 145CANON

{r7}

Same as {r6} but subtracts 1 from the first digit of the folder number. This is to allow numbering from 00001 for cameras which start numbering folders from 100.

e.g. 04567 for IMG_4567 in folder 145CANON

 

{r8}

Image or shutter activation counter. Only available when downloading images using a card reader from the following cameras: Canon EOS-1D/1Ds/1DMk2/1DsMk2 and Nikon DSLRs from the D70 onwards

e.g. 123

{r85}

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

e.g. 00123

{r86}

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

e.g. 000123

{n1}

Download sequence number for this session only with no leading zeroes

Please see the notes below

{n2}

As {n1} but padded with leading zeroes to give a 2-digit number

Please see the notes below

{n3}

As {n1} but padded with leading zeroes to give a 3-digit number

Please see the notes below

{n4}

As {n1} but padded with leading zeroes to give a 4-digit number

Please see the notes below

{N1}

Date-based download sequence number with no leading zeroes

Please see the notes below

{N2}

As {N1} but padded with leading zeroes to give a 2-digit number

Please see the notes below

{N3}

As {N1} but padded with leading zeroes to give a 3-digit number

Please see the notes below

{N4}

As {N1} but padded with leading zeroes to give a 4-digit number

Please see the notes below

{l}

"Uniqueness" number evaluates to the lowest number required to give a unique download filename or empty string if not required

Please see the notes below

{la}

Same as {l} but with the number expressed using the letters 'a' to 'z' e.g. 1='a', 2='b', 26='z', 27='aa', 28='ab'

Please see the notes below

{l2}

2-digit "uniqueness" number padded with leading zeroes

Please see the notes below

{l3}

4-digit "uniqueness" number padded with leading zeroes

Please see the notes below

{l4}

4-digit "uniqueness" number padded with leading zeroes

Please see the notes below

{L}

Same as {l} but starts numbering from 1

Please see the notes below

{La}

Same as {L} but with the number expressed using the letters 'a' to 'z' e.g. 1='a', 2='b', 26='z', 27='aa', 28='ab'

Please see the notes below

{L2}

Same as {l2} but starts numbering from 1

Please see the notes below

{L3}

Same as {l3} but starts numbering from 1

Please see the notes below

{L4}

Same as {l4} but starts numbering from 1

Please see the notes below

{seq#}

Download sequence number

Please see the notes below

{seq#2}

As {seq#} but padded with leading zeroes to give a 2-digit number

Please see the notes below

{seq#3}

As {seq#} but padded with leading zeroes to give a 3-digit number

Please see the notes below

{seq#4}

As {seq#} but padded with leading zeroes to give a 4-digit number

Please see the notes below

{seq#5}

As {seq#} but padded with leading zeroes to give a 5-digit number

Please see the notes below

{seq#6}

As {seq#} but padded with leading zeroes to give a 6-digit number

Please see the notes below

{R}

"Downloads today". This token keeps a count of the number of downloads performed today and can be used to number each download to avoid duplicate filenames.

 

{T}

Camera model name starting from the first word containing digits

e.g. 30D for Canon EOS 30D

{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 5D

{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

 

e.g. 1D for Canon EOS-1D Mark II

 

{T5}

Last word of camera model name containing digits

 

e.g. 30D for Canon EOS 30D

 

{T6}

Same as {T5}, but '-' are treated as spaces

 

e.g. 1Ds for Canon EOS-1Ds Mark II

{T8}

Uses the value defined in Camera name mapping preferences

(defaults to {T1} if no mapping is defined)

 

 

{T9}

Uses the value defined in Camera name mapping preferences

(defaults to {T1} if no mapping is defined)

 

{v}

Camera model name starting from the first word containing digits

(same as {T1} for compatibility with BreezeBrowser)

 

{V}

Full camera name

(same as {T2} for compatibility with BreezeBrowser)

 

       

 

Other tokens

 

{J}

Job code

 

{u}

"My Pictures" folder (not all versions of Windows support this)

e.g. C:\Documents and Settings\chris\My Documents\My Pictures

{U}

"My Documents" folder

e.g. C:\Documents and Settings\chris\My Documents

{vol}

Disk volume name (card readers and disk drives only)

e.g. EOS_DIGITAL

       

 

Download Sequence Numbers

 

Downloader Pro can allocate a download sequence number to images which can be used to number images as they are downloaded. For the {n} and {N} tokens the sequence is allocated in time/date order with the oldest image starting at 1 each time Downloader Pro is run. The {seq#} tokens continue numbering from the last image downloaded and can be used for the continuous numbering of images even if Downloader Pro is closed and run again.

 

The sequence number can accessed using the tokens {n1}, {n2}, {n3} and {n4} to give 1-digit, 2-digit, 3-digit or 4-digit numbers respectively e.g. {n3} will give numbers like 001, 002, 003 etc.

 

The tokens {N1}, {N2}, {N3} and {N4} work in a similar way but the numbering is reset to 1 for each new date e.g. images from Jan 1 will start from 1 and {N2} would give values like 01, 02, 03 and images from Jan 2 would also start from 01.

These tokens should be used in conjunction with the date tokens to avoid duplicate filenames e.g. set the filename to "{d}_{N3}".

 

Warning: Please use the {n} and {N} tokens carefully. They are fine if you only ever download one set of images at a time but may result in duplicate filenames if you download several memory cards on the same day.

 

The tokens {seq#}, {seq#2}, {seq#3}, {seq#4}, {seq#5} and {seq#6} give 1-digit, 2-digit, 3-digit, 4-digit, 5-digit or 6-digit numbers respectively. Downloader Pro keeps a record of the sequence number between sessions and will continue numbering where it left off the next time it is run. The initial value for the sequence number can be set in Preferences
Please note that if the same memory card is downloaded twice the second set of images will be given new sequence numbers resulting in two copies of each image.

 

 

 

Uniqueness Numbers

 

Downloader Pro can add a "uniqueness number" to the download filenames to avoid duplicate filenames. The {l} tokens evaluate to an empty string if the filename is already unique otherwise they are set to the lowest number that will give a unique filename. The {L} tokens are similar to the {l} tokens except that they always evaluate to a number.

 

Tip: Prefix {l} with a space, dash or underscore if you wish to visually separate the uniqueness number from the rest of the filename. If {l} evaluates to an empty string the trailing space, dash or underscore will be removed (see the {d} {l3} example below)

 

For example suppose files are named using the date they were taken (e.g. {d}) and three images were taken on the same day. This would result in three different source files all having the same download filename e.g. 20051228.jpg. This would produce duplicate filenames if more than one image was taken on the same day. The duplicate filenames can be avoided by using one of the uniqueness number tokens:

 

Source filename

{d} value

{d}{l} value

{d}{la} value

{d}_{l3} value

{d}_{L} value

IMG_1234.JPG

20051228.JPG

20051228.JPG

20051228.JPG

20051228.JPG

20051228_1.JPG

IMG_1235.JPG

20051228.JPG

200512281.JPG

20051228a.JPG

20051228_001.JPG

20051228_2.JPG

IMG_1236.JPG

20051228.JPG

200512282.JPG

20051228b.JPG

20051228_002.JPG

20051228_3.JPG

 

Please Note: Downloader Pro only compares the download filenames with the other files on the source drive. It does not check the names of files already in the download directory because this would make it impossible for Downloader Pro to keep track of which files have already been downloaded.

The images are sorted into timestamp order (followed by alphabetical if two images have the same timestamp) before allocating the uniqueness numbers. This additional sorting may cause Downloader Pro to run slowly when downloading large numbers of images.

The uniqueness tokens can only be used to define the download filename and shouldn't be used to specify the download directory.

 

 

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 Z7 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,4,{T2}} for an image taken with a Nikon Z7 will give: ikon

{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 Z7 will give: 300

{field,n,str}

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

{field,1,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,{T2}} for an image taken with a Nikon Z7 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 Z7 will give: Z7

{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,{J},none} returns the job code if defined and  defaults to "none" if it is not defined.

{if,test,str1,str2}

Returns str1 if test is not an empty string else returns str2 (test, str1 and str2 can be strings or tokens)

{if,{E1},JPEG file,not a JPEG} returns "JPEG file" if the file has a JPEG file extension else returns "not a JPEG"

{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

{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,{o}} for filename IMG_1234.jpg would give 1234

 

 

Tokens for country code/name lookup

 

The tokens below can be used to convert between ISO-3166 alpha2 and alpha3 country codes and names:

 

Token

Description

Example

{cc1,code}

Looks up the country name given the ISO-3166 alpha2 or alpha3 country code (code can be a string or token).

{cc1,USA} gives United States

{cc2,alpha3}

Looks up the ISO-3166 alpha2 country code given the alpha3 code (alpha3 can be a string or token).

{cc2,DEU} gives DE

{cc3,alpha2}

Looks up the ISO-3166 alpha2 country code given the alpha3 code (alpha2 can be a string or token).

{cc3,GB} gives GBR

 

Tokens can be combined as in the example below:
 

Suppose the job code consists of a four digit job number followed by a 2 character country code and the client's name

e.g. "1234GB Jones" and "1235US John Doe Inc."

 
{J} gives the full job code - "1234GB Jones" or "1235US John Doe Inc."

{left,4,{J}} gives the job number - "1234" or "1235"

{mid,4,2,{J}} gives the 2 character country code - "GB" or "US"

{cc1,{mid,4,2,{J}}} gives the country name - "United Kingdom" or "United States"

{cc3,{mid,4,2,{J}}} gives the 3 character country code - "GBR" or "USA"

{mid,7,100,{J}} gives the client name - "Jones" or "John Doe Inc."

 

Or used with the geonames place name tokens e.g. Geonames returns a two character country code and this can be converted to a three character country code for use in IPTC/XMP data using {cc3,{geonames_countryCode}}

 

Defaulting to the GB country code when GPS data or geonames data is not available:

{default,{geonames_countryCode},GB}