What is Attribute? Attribute is a file property. For example, "dateCreated" is a date when the file is created, "dateModified" is a date when the file is last modified. So they allow you to use file properties as a part of filename.
Basic Usage
Attribute is surrounded by brackets, inside the brackets is a value or a key-value pair separated by a colon. Suppose you have an image file with the following properties:
- Filename: IMAGE_001.jpg
- File size: 7MB
- Date taken: 2019-01-20 11:11 AM
- Date created: 2019-01-23 9:12 AM
- Date last modified: 2021-12-25 6:40 PM
- Date last accessed: 2022-12-30 10:35 PM
- Camera Maker: Canon
- Camera Model: 5D Mark III
For Example:
{imageMake}: will return "Canon".
{dateCreated:yyyy-MM-dd}: will return "2019-01-23".
Available Attributes
Below is a list of all available attributes which can be used as parts of a filename.
Date Accessed
{dateAccessed:format} The last date when a file is accessed.
{dateModified:yyyy-MM-dd-hhssa} Output: 2022-12-30-10:35PM
Date Created
{dateCreated:format} The date when a file is created.
{dateCreated:yyyy-MM-dd-HHss}Output: 2019-01-23-0912
Date Modified
{dateModified:format} The last date when a file is modified.
{dateModified:yyyy-MM-dd-HHss}Output: 2021-12-25-1840
Date Taken
{dateTaken:format} The date when a photo is taken, only available in image files that has it.
{dateModified:yyyy-MM-dd-HHss}Output: 2021-12-25-1840
Date Format Reference
Suppose you have the following date 2021-01-02 12:05:05.678
| Letter | Date or Time Component | Example |
|---|---|---|
| y | Year | yyyy = 2021, yy = 21 |
| M | Month | MMMM = January, MMM = Jan, MM = 01, M = 1 |
| d | Day | dd = 02, d = 2 |
| E | Week name | EEEE = Saturday, EEE = Sat |
| e | Week day | Saturday = 6 or 7 (depending on your computer setting) |
| H | Hour (24) | HH = 03, H = 3 |
| h | Hour (12) | hh = 03, h = 3 |
| m | Minute | mm = 08, m = 8 |
| s | Second | ss = 09, s = 9 |
| S | Millisecond | SSS = 678, SS = 67, S = 6 |
| a | AM/PM marker | PM |
File Name
{fileName:start,end} Extract filename from position "start" to position end. If "start" and/or "end" are not given, full filename will be returned. The "start" position starts from zero.
{fileName}Output: IMAGE_001
{fileName:6}Output: 001
{fileName:0,5}Output: IMAGE
File Size
{fileSize:unit} Retrieve file size in "unit", default in "byte". The unit values are "byte", "kb", 'mb", "gb", and "tb".
{fileSize}Output: 7549747
{fileSize:kb}Output: 7372
{fileSize:mb}Output: 7
Make (Camera Maker Name)
{cameraMake} Retrieve manufacturer name of the camera.
{cameraMake}Output: Canon
Model (Camera Model)
{cameraModel} Retrieve manufacturer name of the camera.
{cameraModel}Output: 5D Mark III
Sequence
{sequence:type,start,interval,perGroup,mask} Generate sequential numbers or letters.
- Type: either sequencing by number or letter, value "number" or "letter".
- Start: if type is "number", Start value must be a number. If type is "letter", Start value must be a letter.
- Interval: how many number or letter to skip between. For example, Interval "2" will be 1, 3, 5 or A, C, E.
- perGroup: how many files to have the same number or letter. For example, perGroup "2" will be 1, 1, 2, 2, 3, 3.
- Mask: can be anything, it is used to fill up the digit you want. For example, mask "00000" will be 00001, 00002, 00003.
{sequence:number,1,1}Output: 1.jpg, 2.jpg, 3.jpg
{sequence:letter,Z,-2,2}Output: Z.jpg, ZZ.jpg, X.jpg, X.jpg
More attributes will be added.