8.3. Session options

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
$(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)
base directory naming pattern

The base directory part of the naming pattern (default $(PICTURES_FOLDER)/Darktable).

sub directory naming pattern

The sub directory part of the naming pattern (default $(YEAR)$(MONTH)$(DAY)_$(JOBCODE)).

file naming pattern

The file name part of the naming pattern (default $(YEAR)$(MONTH)$(DAY)_$(SEQUENCE).$(FILE_EXTENSION).