These options define a naming pattern to organize images on disk when importing from a connected camera (see Section 2.3.1, “Import”) and when taking photos in the tethering view (see Chapter 4, Tethering).
The naming pattern consists of three parts: a base part defining the parent folder, a session part defining a sub directory which is specific to the individual import session, and a file name part defining the filename structure for each imported image.
Several pre-defined variables can be used in the pattern as placeholders:
| $(HOME) | the home folder as defined by the system |
| $(PICTURES_FOLDER) | the pictures folder as defined by the system (usually “$HOME/Pictures”) |
| $(DESKTOP) | the desktop folder as defined by the system (usually “$HOME/Desktop”) |
| $(USERNAME) | your user account name on the system |
| $(FILE_NAME) | basename of the imported image |
| $(FILE_EXTENSION) | extension of the imported image |
| $(JOBCODE) | unique identifier of the import job |
| $(SEQUENCE) | a sequence number within the import job |
| $(MAX_WIDTH) | maximum image width to limit within export session |
| $(MAX_HEIGHT) | maximum image height to limit within export session |
| $(ID) | unique identification number of the image in darktable's database |
| $(YEAR) | year at the date of import |
| $(MONTH) | month at the date of import |
| $(DAY) | day at the date of import |
| $(HOUR) | hour at the time of import |
| $(MINUTE) | minute at the time of import |
| $(SECOND) | second at the time of import |
| $(EXIF_YEAR) | year the photo was taken (from Exif data) |
| $(EXIF_MONTH) | month the photo was taken (from Exif data) |
| $(EXIF_DAY) | day the photo was taken (from Exif data) |
| $(EXIF_HOUR) | hour the photo was taken (from Exif data) |
| $(EXIF_MINUTE) | minute the photo was taken (from Exif data) |
| $(EXIF_SECOND) | seconds the photo was taken (from Exif data) |
| $(EXIF_ISO) | ISO value of the photo (from Exif data) |
The base directory part of the naming pattern (default “$(PICTURES_FOLDER)/Darktable”).
The sub directory part of the naming pattern (default “$(YEAR)$(MONTH)$(DAY)_$(JOBCODE)”).
The file name part of the naming pattern (default “$(YEAR)$(MONTH)$(DAY)_$(SEQUENCE).$(FILE_EXTENSION”).
