Chapter 8. Preferences and settings

darktable comes with a number of settings that can be configured by users. You reach the configuration menu by clicking at the top of the screen.

8.1. GUI options

These options control the look and feel of darktable.

width of the side panels in pixels

This controls the size of side panels in pixels. Side panels are found left and right to the center view (default 350).

don't use embedded preview JPEG but half-size raw

Check this option to not use the embedded JPEG from the raw file but process the raw data. This is slower. (default off).

ask before removing images from database

Always ask the user before any image is removed from the database (default on).

ask before erasing images from disk

Always ask the user before any image file is deleted (default on).

send files to trash when erasing images

Instead of physically deleting images from disk put them into the system's trash bin (default on).

ask before moving images from film roll folder

Always ask the user before any image file is moved (default on).

ask before copying images to new film roll folder

Always ask the user before any image file is copied (default on).

number of folder levels to show in lists

The number of folder levels to show in film roll names, starting from the right (default 1).

ignore JPEG images when importing film rolls

When having RAW+JPEG images together in one directory it makes no sense to import both. With this flag one can ignore all JPEGs found (default off).

recursive directory traversal when importing film rolls

Not only import images from the directory selected but recursively go through all subdirectories as well (default off).

creator to be applied when importing

If provided, automatically add this string as a creator tag when importing images (default none).

publisher to be applied when importing

If provided, automatically add this string as a publisher tag when importing images (default none).

rights to be applied when importing

If provided, automatically add this string as a copyrights tag when importing images (default none).

comma separated tags to be applied when importing

If you want to add further tags when importing images, you can give them as a comma separated list (default none).

initial import rating

Initial star rating (from 0 to 5) for all images when importing a film roll (default 1).

enable filmstrip

Enable the filmstrip in darkroom, tethering and geomapping modes (default on).

high quality thumb processing from size

If the thumbnails size is greater than this value, it will be processed using the full quality rendering path which is better but slower (default 720p).

pen pressure control for brush masks

Controls how the pressure reading of a graphics tablet impacts newly generated brush strokes (see Section 3.2.7, “Drawn mask”). You can control the brush width, its hardness and its opacity. Absolute control means that the pressure reading directly defines the attribute with a value between 0% and 100%. Relative means that the pressure reading adjusts the attribute between zero and the pre-defined default value (default off).

smoothing of brush strokes

Sets the level for smoothing of brush strokes. Stronger smoothing leads to less nodes and easier editing at the expense of lower accuracy.

ask before deleting a tag

Always ask user before deleting a tag from an image (default on).

only draw images on map that are currently collected and filtered

Use the current filter settings to select the geotagged images drawn in the map view. This limits the images drawn to those currently shown in the filmstrip and thus reduces the time needed (default off).

maximum number of images drawn on map

The maximum number of geotagged images drawn on the map. Increasing this number can slow down the drawing of the map. Needs a restart if changed (default 100).

pretty print the image location

Show a more readable representation of the geo location in the image information module (default on).

overlay txt sidecar over zoomed images

When there is a text file next to an image it can be shown as an overlay over zoomed images on the lighttable. The text file has the same base name as the image file with file extension .txt. It either has to be there at import time or the crawler has to be enabled – see option look for updated xmp files on startup in Section 8.2, “Core options” (default off).

expand a single lighttable module at a time

Controls how lighttable panels are expanded. If this option is enabled, expanding a panel by clicking collapses any currently expanded panel. If you want to expand a panel without collapsing the others you do so with shift-click. Disabling this option reverts the meaning of click and shift-click (default off).

expand a single darkroom module at a time

Controls how darkroom modules are expanded. If this option is enabled, expanding a module by clicking collapses any currently expanded module. If you want to expand a module without collapsing the others you do so with shift-click. Disabling this option reverts the meaning of click and shift-click (default on).

scroll to lighttable modules when expanded/collapsed

With this option enabled the lighttable side panels will scroll a module to the top when it is expanded or collapsed (default off).

scroll to darkroom modules when expanded/collapsed

With this option enabled the darkroom side panel will scroll a module to the top when it is expanded or collapsed (default on).

border around image in darkroom mode

Process the image in darkroom mode with a small border of the given number of pixels (default 20).

do high quality processing for slideshow

Controls how images are processed for the slideshow view. It this option is enabled, the image will first be processed in full resolution, and downscaled at the very end. This can result in better quality sometimes, but will always be slower (default on).

method to use for getting the display profile

This option allows to force a specific way of getting the current display profile for color management (see Section 3.2.10.2, “Rendering method”). In the default setting all darktable will either query the X display server's xatom or the colord system service. You can set this option to xatom or colord to enforce a specific method if the alternative gives wrong results.