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