darktable page lede image
darktable page lede image

2.3.2. Collect images

The current view in lighttable is called a collection. The collect images panel lets you narrow down the list of visible images to just the ones you want to work with.

Information about all images imported into darktable are kept in a database, with various attributes describing each image. You define a collection by applying certain filtering rules to these attributes, creating a subset of images to display in the lighttable view.

The default collection is based on the film roll attribute – it displays all images of the last imported film roll or any other film roll chosen.

2.3.2.1. Usage

image attributes

The left combobox lets you choose from the available attributes sorted in different categories.

files

film roll

the film roll to which the image belongs

folders

the disk folder where the input image file is located

filename

the filename of the physical input image

metadata

tag

any tag that is attached to the image; if activated a hierarchical list of known tags is displayed for quick selection

title

the title, as listed in the image's metadata title field

description

the description, as listed in the image's metadata description field

creator

the creator, as listed in the image's metadata creator field

publisher

the publisher, as listed in the image's metadata publisher field

rights

the copyrights statement, as written in the image's metadata rights field

notes

the notes statement, as written in the image's metadata notes field

color label

any color label that is attached to the image: red, yellow, green, blue, purple

geotagging

the geo location of the image

times

date taken

the date when the photo was taken, in the format YYYY:MM:DD

date-time taken

the time (date and time of day) when the photo was taken, in the format YYYY:MM:DD hh:mm:ss

import timestamp

the time (date and time of day) when the photo was imported, in the format YYYY:MM:DD hh:mm:ss

change timestamp

the time (date and time of day) when the photo was last modified, in the format YYYY:MM:DD hh:mm:ss

export timestamp

the time (date and time of day) when the photo was last exported, in the format YYYY:MM:DD hh:mm:ss

print timestamp

the time (date and time of day) when the photo was last printed, in the format YYYY:MM:DD hh:mm:ss

capture details

camera

the Exif data entry describing the camera make and model

lens

the Exif data entry describing the lens

aperture

the aperture value, as derived from Exif data

exposure

the exposure time, as derived from Exif data

focal length

the focal length value, as derived from Exif data

ISO

the ISO value, as derived from Exif data

aspect ratio

the image's aspect ratio as it would be exported. this takes into account any cropping done during development.

darktable

grouping

choose group leaders or followers

local copy

choose images with or without local copies

history

choose images whose history stacks have been altered or not altered

module

choose images based on development modules used.

module order

choose images using a specific order of development. either legacy for images developed before 3.0 release, v3.0 for images developed since 3.0 release or none for images not yet developed.

search rules

In the text field to the right of the attribute, you write a pattern. The pattern is compared against all database entries with the selected attribute. This search detects a match if the images' attribute contains the pattern in its full text. You may use % as wildcard character. The collection gets limited to those images where the query matches. Leaving the text field empty matches all images for that attribute.

Attributes with numerical values as well as date and time attributes can be used in combination with comparative and range operators. Write <, <=, >, >=, <>, and = to select images with attributes less, less or equal, greater, greater or equal, not equal, or equal to the a given value, respectively. An expression in the form [from;to] selects a range of values.

The box below the search rule will list all matching database entries of the query you are currently working on. This list gets updated continuously as you type. You may also choose sorting criteria by scrolling through the list and double-clicking (or single-click if you have set the option in preferences. See Section 8.3, “Lighttable”).

If you have set single-click mode, you'll be able to select range of values with mouse. This only works for numerical and date-time attributes.

Clicking on the triangle button to the right of the text field opens a drop-down menu with options to finetune your current collection by adding further rules, or removing them:

clear this rule

Removes this rule – or resets to default if this is the only rule defined.

narrow down search

Adds a new rule which is combined with the previous rule(s) in a logical AND operation. An image is only part of the collection if it additionally fulfills the added rule.

add more images

Adds a new rule which is combined with the previous rule(s) in a logical OR operation. Images that fulfill the new rule are added to the collection.

exclude images

Adds a new rule which is combined with the previous rule(s) in a logical EXCEPT operation. Images which are selected by the new rule are exempted from the collection.

combining rules

The logical operators defining the combination of rules are displayed to the right of the rule: AND by the symbol, OR by the symbol, and EXCEPT by the symbol. Clicking on either symbol gives a choice to change the logical operation.

updating folder path

While it is best to not touch imported files behind darktable's back, this module can help you recover from situations when you move imported folders after import. The collect images module has a feature that allows you to tell darktable about the new location of imported folders which have been moved. You set the combobox to folders to find the original folder name in the tree. The folder name will be displayed striked-out to emphasize that it is no longer there. Then you right-click on the folder name, select search filmroll..., and then select the new location of the folder.