documentation of darktablerc

darktablerc

this files gives an overview over the default settings of the darktable configuration found in ~/.config/darktable/darktablerc. you might find some extra values in that configuration file that get generated by the code at runtime, this overview only has the default values that are specified during compile time. some details (like allowed range and factors when shown in the preferences dialog) are not shown here to not clutter the list too much. please have a look at the corresponding source file for up-to-date information.

key | type | default | description
ask_before_copy | bool | true | ask before copying images to new film roll folder
always ask the user before any image file is copied.
ask_before_delete | bool | true | ask before erasing images from disk
always ask the user before any image file is deleted.
ask_before_move | bool | true | ask before moving images from film roll folder
always ask the user before any image file is moved.
ask_before_remove | bool | true | ask before removing images from database
always ask the user before any image is removed from DB.
bauhaus/scale | float | 1.4 | widget scale
scaling factor for bauhaus widgets, will affect font size
brush_smoothing | enum low medium high | medium | smoothing of brush strokes
sets level for smoothing of brush strokes. stronger smoothing leads to less nodes and easier editing but with lower control of accuracy.
cache_compression | enum off low quality (fast) high quality (slow) | off | compression of thumbnail images
off - no compression in memory, JPG on disk. low quality - DXT1 (fast). high quality - DXT1, same memory as low quality variant but slower.
cache_memory | int64 | (1024 * 1024 * 512) | memory in megabytes to use for mipmap cache
this controls how much memory is going to be used for thumbnails and other buffers (needs a restart).
compress_xmp_tags | enum never always only large entries | only large entries | store xmp tags in compressed format
entries in xmp tags can get rather large and may exceed the available space to store the history stack in output files. this option allows xmp tags to be compressed and save space.
darkroom/ui/overexposed/colorscheme | int | 1 |
darkroom/ui/overexposed/lower | float | 2.0 |
darkroom/ui/overexposed/upper | float | 98.0 |
darkroom/ui/single_module | bool | true | expand a single darkroom module at a time
this option toggles the behavior of shift clicking in darkroom mode
database | string | library.db | database location
filename relative to ~/.config/darktable or starting with a slash (needs a restart).
database_cache_quality | int | 89 | JPEG quality of on-disk thumbnails
affects only the thumbnail cache used for quick startup.
host_memory_limit | int | 1500 | host memory limit (in MB) for tiling
this variable controls the maximum amount of memory (in MB) a module may use during image processing. lower values will force memory hungry modules to process image with increasing number of tiles. setting this to 0 will omit any limit. values below 500 will be treated as 500 (needs a restart).
lighttable/ui/expose_statuses | bool | false | always show thumbnail overlays
show overlays (rating stars, "edited" mark, etc) for all thumbnails in file manager, not only hovered one
lighttable/ui/single_module | bool | false | expand a single lighttable module at a time
this option toggles the behavior of shift clicking in lighttable mode
maximum_number_tiles | int | 10000 | assumed maximum sane number of tiles
if during tiling this number is exceeded darktable assumes that tiling is not possible and falls back to untiled processing - with all system memory limits taking full effect. in case you want to process huge images you may want to increase this number.
metadata/resolution | int | 300 |
never_use_embedded_thumb | bool | false | 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 but gives you color managed thumbnails.
opencl | bool | true | activate OpenCL support
if found, use OpenCL runtime on your system for improved processing speed. can be switched on and off at any time.
opencl_async_pixelpipe | bool | false | run OpenCL pixelpipe asynchronously
if set to TRUE OpenCL pixelpipe will not be synchronized on a per-module basis. this can improve pixelpipe latency. however, potential OpenCL errors would be detected late; in such a case the complete pixelpipe needs to be reprocessed instead of only a single module. export pixelpipe will always be run synchronously.
opencl_avoid_atomics | bool | false | do not run OpenCL kernels which require atomic operations
if set to TRUE darktable will not use OpenCL kernels which contain atomic operations (example bilateral). pixelpipe processing will be done on CPU for the affected modules. useful if your OpenCL implementation freezes/crashes on atomics or if they are processed with a bad performance.
opencl_checksum | string |  | checksum representing the setup of opencl devices on this computer
darktable re-checks the performance benchmarks of your system in case your setup has changed, which is indicated by a change versus the stored checksum in this config variable; darktable de-activates opencl if the GPU benchmark lies below the one of the CPU.
opencl_device_priority | string | */!0,*/*/* | priority of OpenCL devices for each pixelpipe type
defines priorities on how (multiple) OpenCL devices are allocated to the different types of pixelpipe (full, preview, export, thumbnail). for more details visit our usermanual (needs a restart).
opencl_library | string |  | system library with OpenCL runtime
OpenCL runtime library is normally detected automatically by darktable. if your OpenCL runtime is at an unusual place and cannot be detected, enter the full pathname here. leave empty for default behavior.
opencl_memory_headroom | int | 300 | amount of OpenCL memory (in MB) which we assume as being reserved for the driver
this amount of memory (in MB) will be substracted from total GPU memory in order to calculate the available OpenCL memory. too low values will lead to out-of-memory situations in OpenCL processing. too high values will lead to unnecessary tiling (needs a restart).
opencl_memory_requirement | int | 768 | minmum amount of GPU memory (MB) required to activate OpenCL
OpenCL will only be activated if your graphics card has at least this amount of memory. reducing the value will allow cards with less GPU memory to be used - but at the risk of lower system stability and occasional crashes. values below 200 will be treated as 200.
opencl_micro_nap | int | 1000 | pause OpenCL processing for this number of microseconds from time to time
for slow GPUs this gives your graphics driver some time to breathe to do needed screen updates. can be left at zero for fast devices.
opencl_number_event_handles | int | 25 | the number of OpenCL event handles darktable can use
a positive non-zero integer defines the number of event handles that darktable may have opened on a device. a value of -1 does not pose any restrictions, bearing the risk of hitting the device's resource limits. a value of zero completely prevents the use of event handles.
opencl_size_roundup | int | 16 | round OpenCL work group sizes to a multiple of
in OpenCL processing round width/height of global work groups to a multiple of this value. reasonable values are powers of 2. this parameter can have high impact on OpenCL performance.
opencl_synch_cache | bool | false | copy back OpenCL buffers into pixelpipe cache after each module
this brings pixelpipe cache and OpenCL buffers in synch after each module. on slow GPUs this might improve speed as it avoids reprocessing the whole pixelpipe on every parameter change. on fast GPUs the additional memory transfer overhead will slow down OpenCL considerably.
opencl_use_cpu_devices | bool | false | whether to make use of CPU OpenCL devices
typically darktable's hand-optimized CPU code is much faster than any OpenCL-on-CPU code; therefore CPUs are excluded from being used as OpenCL devices by default. can be changed by setting this configuration option to TRUE (needs a restart).
opencl_use_pinned_memory | bool | false | whether to use pinned memory transfer during tiling
during tiling huge amounts of memory need to be transfered between host and device. for some OpenCL implementations direct memory transfers give a drastic performance penalty. this can often be avoided by using indirect transfers via pinned memory. other devices have more efficient direct memory transfer implementations. AMD seems to belong to the first group, nvidia to the second.
panel_width | int | 300 | width of the side panels in pixels
(needs a restart)
parallel_export | int | 1 | export multiple images in parallel
set this variable to num_threads if you want multithreaded export to process multiple images at a time. be warned: every thread will need at the very least 1GB of memory. setting this to 1 switches on per-image parallelization.
plugins/capture/camera/import/jobcode | string | noname | jobcode of import job
plugins/capture/jobcode | string | capture job | name of capture job
plugins/capture/mode | int | 0 | capture view mode
plugins/capture/storage/basedirectory | string | $(PICTURES_FOLDER)/darktable | path of storage for captured images
plugins/capture/storage/namepattern | string | $(YEAR)$(MONTH)$(DAY)_$(SEQUENCE).$(FILE_EXTENSION) | rename pattern for captured images
plugins/capture/storage/subpath | string | $(YEAR)$(MONTH)$(DAY)_$(JOBCODE) | subpath pattern in storage for captured images
plugins/collection/descending | bool | false |
plugins/collection/film_id | int | 1 |
plugins/collection/filter_flags | int | 3 |
plugins/collection/query_flags | int | 3 |
plugins/collection/rating | int | 1 |
plugins/collection/rating_comparator | int | 3 |
plugins/collection/sort | int | 0 |
plugins/darkroom/active | string |  |
plugins/darkroom/atrous/expanded | bool | false |
plugins/darkroom/atrous/visible | bool | false |
plugins/darkroom/basecurve/expanded | bool | false |
plugins/darkroom/basecurve/visible | bool | true |
plugins/darkroom/bilat/expanded | bool | false |
plugins/darkroom/bilat/visible | bool | true |
plugins/darkroom/bilateral/expanded | bool | false |
plugins/darkroom/bilateral/visible | bool | false |
plugins/darkroom/bloom/expanded | bool | false |
plugins/darkroom/bloom/visible | bool | false |
plugins/darkroom/borders/expanded | bool | false |
plugins/darkroom/borders/visible | bool | false |
plugins/darkroom/cacorrect/expanded | bool | false |
plugins/darkroom/cacorrect/visible | bool | false |
plugins/darkroom/channelmixer/expanded | bool | false |
plugins/darkroom/channelmixer/visible | bool | false |
plugins/darkroom/clahe/expanded | bool | false |
plugins/darkroom/clahe/visible | bool | false |
plugins/darkroom/clipping/expanded | bool | false |
plugins/darkroom/clipping/guide | int | 0 | last chosen guide style
plugins/darkroom/clipping/ratio_d | int | 0 | last chosen aspect ratio denominator
plugins/darkroom/clipping/ratio_n | int | 0 | last chosen aspect ratio numerator
plugins/darkroom/clipping/visible | bool | true |
plugins/darkroom/colisa/expanded | bool | true |
plugins/darkroom/colisa/visible | bool | true |
plugins/darkroom/colorcontrast/expanded | bool | false |
plugins/darkroom/colorcontrast/visible | bool | false |
plugins/darkroom/colorcorrection/expanded | bool | false |
plugins/darkroom/colorcorrection/visible | bool | true |
plugins/darkroom/colorin/expanded | bool | false |
plugins/darkroom/colorin/visible | bool | true |
plugins/darkroom/colorize/expanded | bool | false |
plugins/darkroom/colorize/visible | bool | false |
plugins/darkroom/colorout/expanded | bool | false |
plugins/darkroom/colorout/visible | bool | true |
plugins/darkroom/colortransfer/expanded | bool | false |
plugins/darkroom/colortransfer/visible | bool | false |
plugins/darkroom/colorzones/expanded | bool | false |
plugins/darkroom/colorzones/visible | bool | false |
plugins/darkroom/demosaic/expanded | bool | false |
plugins/darkroom/demosaic/quality | enum always bilinear (fast) at most PPG (reasonable) full (possibly slow) | at most PPG (reasonable) | demosaicing for zoomed out darkroom mode
interpolation when not viewing 1:1 in darkroom mode: bilinear is fastest, but not as sharp. middle ground is using PPG + interpolation modes specified below, full will use exactly the settings for full-size export. X-Trans sensors use VNG rather than PPG as middle ground.
plugins/darkroom/demosaic/visible | bool | true |
plugins/darkroom/equalizer/expanded | bool | false |
plugins/darkroom/equalizer/visible | bool | false |
plugins/darkroom/exposure/expanded | bool | false |
plugins/darkroom/exposure/visible | bool | true |
plugins/darkroom/flip/expanded | bool | false |
plugins/darkroom/flip/visible | bool | true |
plugins/darkroom/gamma/expanded | bool | false |
plugins/darkroom/gamma/visible | bool | false |
plugins/darkroom/globaltonemap/expanded | bool | false |
plugins/darkroom/globaltonemap/visible | bool | false |
plugins/darkroom/graduatednd/expanded | bool | false |
plugins/darkroom/graduatednd/visible | bool | true |
plugins/darkroom/grain/expanded | bool | false |
plugins/darkroom/grain/visible | bool | true |
plugins/darkroom/groups | int | 2 |
plugins/darkroom/highlights/expanded | bool | false |
plugins/darkroom/highlights/visible | bool | false |
plugins/darkroom/highpass/expanded | bool | false |
plugins/darkroom/highpass/visible | bool | false |
plugins/darkroom/histogram/mode | enum linear logarithmic waveform | logarithmic |
plugins/darkroom/histogram/show_blue | bool | true |
plugins/darkroom/histogram/show_green | bool | true |
plugins/darkroom/histogram/show_red | bool | true |
plugins/darkroom/hotpixels/expanded | bool | false |
plugins/darkroom/hotpixels/visible | bool | false |
plugins/darkroom/invert/expanded | bool | false |
plugins/darkroom/invert/visible | bool | false |
plugins/darkroom/lens/expanded | bool | false |
plugins/darkroom/lens/visible | bool | true |
plugins/darkroom/levels/expanded | bool | false |
plugins/darkroom/levels/visible | bool | true |
plugins/darkroom/lowlight/expanded | bool | false |
plugins/darkroom/lowlight/visible | bool | false |
plugins/darkroom/lowpass/expanded | bool | false |
plugins/darkroom/lowpass/visible | bool | false |
plugins/darkroom/masks/brush/border | float | 0.05 |
plugins/darkroom/masks/brush/density | float | 1.0 |
plugins/darkroom/masks/brush/hardness | float | 0.66 |
plugins/darkroom/masks/circle/border | float | 0.05 |
plugins/darkroom/masks/circle/size | float | 0.05 |
plugins/darkroom/masks/ellipse/border | float | 0.05 |
plugins/darkroom/masks/ellipse/radius_a | float | 0.05 |
plugins/darkroom/masks/ellipse/radius_b | float | 0.03535 |
plugins/darkroom/masks/ellipse/rotation | float | 90.0 |
plugins/darkroom/masks/gradient/compression | float | 0.5 |
plugins/darkroom/masks/gradient/rotation | float | 0.0 |
plugins/darkroom/masks/gradient/steepness | float | 0.0 |
plugins/darkroom/masks/path/border | float | 0.05 |
plugins/darkroom/monochrome/expanded | bool | false |
plugins/darkroom/monochrome/visible | bool | true |
plugins/darkroom/nlmeans/expanded | bool | false |
plugins/darkroom/nlmeans/visible | bool | false |
plugins/darkroom/overexposed/expanded | bool | false |
plugins/darkroom/overexposed/visible | bool | true |
plugins/darkroom/profile_gamma/expanded | bool | false |
plugins/darkroom/profile_gamma/visible | bool | false |
plugins/darkroom/rawdenoise/expanded | bool | false |
plugins/darkroom/rawdenoise/visible | bool | false |
plugins/darkroom/relight/expanded | bool | false |
plugins/darkroom/relight/visible | bool | false |
plugins/darkroom/shadhi/expanded | bool | false |
plugins/darkroom/shadhi/visible | bool | true |
plugins/darkroom/sharpen/expanded | bool | false |
plugins/darkroom/sharpen/visible | bool | true |
plugins/darkroom/soften/expanded | bool | false |
plugins/darkroom/soften/visible | bool | false |
plugins/darkroom/splittoning/expanded | bool | false |
plugins/darkroom/splittoning/visible | bool | false |
plugins/darkroom/spots/brush_border | float | 0.05 |
plugins/darkroom/spots/brush_density | float | 1.0 |
plugins/darkroom/spots/brush_hardness | float | 0.66 |
plugins/darkroom/spots/circle_border | float | 0.02 |
plugins/darkroom/spots/circle_size | float | 0.02 |
plugins/darkroom/spots/ellipse_border | float | 0.02 |
plugins/darkroom/spots/ellipse_radius_a | float | 0.02 |
plugins/darkroom/spots/ellipse_radius_b | float | 0.01414 |
plugins/darkroom/spots/ellipse_rotation | float | 90.0 |
plugins/darkroom/spots/expanded | bool | false |
plugins/darkroom/spots/path_border | float | 0.05 |
plugins/darkroom/spots/visible | bool | false |
plugins/darkroom/tagging/visible | bool | true |
plugins/darkroom/temperature/expanded | bool | false |
plugins/darkroom/temperature/visible | bool | true |
plugins/darkroom/tonecurve/expanded | bool | false |
plugins/darkroom/tonecurve/visible | bool | true |
plugins/darkroom/tonemap/expanded | bool | false |
plugins/darkroom/tonemap/visible | bool | false |
plugins/darkroom/velvia/expanded | bool | false |
plugins/darkroom/velvia/visible | bool | false |
plugins/darkroom/vibrance/expanded | bool | false |
plugins/darkroom/vibrance/visible | bool | false |
plugins/darkroom/vignette/expanded | bool | false |
plugins/darkroom/vignette/visible | bool | true |
plugins/darkroom/watermark/expanded | bool | false |
plugins/darkroom/watermark/visible | bool | false |
plugins/darkroom/zonesystem/expanded | bool | false |
plugins/darkroom/zonesystem/visible | bool | false |
plugins/imageio/format/jpeg/quality | int | 95 |
plugins/imageio/format/png/bpp | int | 8 |
plugins/imageio/format/tiff/bpp | int | 8 |
plugins/imageio/format/tiff/compress | int | 2 |
plugins/imageio/storage/disk/file_directory | string | $(FILE_FOLDER)/darktable_exported/$(FILE_NAME) |
plugins/imageio/storage/email/client | string |  | client to use, this overrides detection of default client.
plugins/imageio/storage/gallery/file_directory | string | $(HOME)/darktable_gallery/img_$(SEQUENCE) |
plugins/imageio/storage/gallery/title | string | darktable gallery |
plugins/lighttable/audio_player | string | aplay | executable for playing audio files
this external program is used to play audio files some cameras record to keep notes for images
plugins/lighttable/camera/expanded | bool | false |
plugins/lighttable/collect/expanded | bool | false |
plugins/lighttable/collect/item0 | int | 0 |
plugins/lighttable/collect/item1 | int | 0 |
plugins/lighttable/collect/item2 | int | 0 |
plugins/lighttable/collect/item3 | int | 0 |
plugins/lighttable/collect/item4 | int | 0 |
plugins/lighttable/collect/item5 | int | 0 |
plugins/lighttable/collect/item6 | int | 0 |
plugins/lighttable/collect/item7 | int | 0 |
plugins/lighttable/collect/item8 | int | 0 |
plugins/lighttable/collect/item9 | int | 0 |
plugins/lighttable/collect/mode0 | int | 0 |
plugins/lighttable/collect/mode1 | int | 0 |
plugins/lighttable/collect/mode2 | int | 0 |
plugins/lighttable/collect/mode3 | int | 0 |
plugins/lighttable/collect/mode4 | int | 0 |
plugins/lighttable/collect/mode5 | int | 0 |
plugins/lighttable/collect/mode6 | int | 0 |
plugins/lighttable/collect/mode7 | int | 0 |
plugins/lighttable/collect/mode8 | int | 0 |
plugins/lighttable/collect/mode9 | int | 0 |
plugins/lighttable/collect/num_rules | int | 0 |
plugins/lighttable/collect/string0 | string |  |
plugins/lighttable/collect/string1 | string |  |
plugins/lighttable/collect/string2 | string |  |
plugins/lighttable/collect/string3 | string |  |
plugins/lighttable/collect/string4 | string |  |
plugins/lighttable/collect/string5 | string |  |
plugins/lighttable/collect/string6 | string |  |
plugins/lighttable/collect/string7 | string |  |
plugins/lighttable/collect/string8 | string |  |
plugins/lighttable/collect/string9 | string |  |
plugins/lighttable/copy_history/expanded | bool | false |
plugins/lighttable/copy_history/pastemode | int | 0 | append or replace history stack if pasted
0 -- append on top of stack, 1 -- replace it.
plugins/lighttable/draw_custom_metadata | bool | false | overlay txt sidecar over zoomed images
when there is a txt file next to an image it can be shown as an overlay over zoomed images on the lighttable. the txt file either has to be there at import time or the crawler has to be enabled
plugins/lighttable/draw_group_borders | bool | true | draw borders around grouped images
draw borders around grouped images when grouping is turned off and the mouse hovers over one of the images of the group
plugins/lighttable/export/expanded | bool | false |
plugins/lighttable/export/force_lcms2 | bool | false | always try to use LittleCMS 2
this is significantly slower than the default.
plugins/lighttable/export/format_name | string | jpeg |
plugins/lighttable/export/height | int | 0 | height of the exported image
height of the exported image, or 0 if no scaling should be done.
plugins/lighttable/export/high_quality_processing | bool | false | do high quality resampling during export
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.
plugins/lighttable/export/iccintent | int | -1 | ICC rendering intent
if non-negative, this overrides the per-image output color profile rendering intent on export.
plugins/lighttable/export/iccprofile | string | image | ICC profile to use for export
this overrides the per-image settings, if not set to `image'.
plugins/lighttable/export/pixel_interpolator | enum bilinear bicubic lanczos2 lanczos3 | lanczos3 | pixel interpolator
pixel interpolator used in rotation and lens correction (bilinear, bicubic, lanczos2, lanczos3).
plugins/lighttable/export/storage_name | string | disk |
plugins/lighttable/export/style | string |  |
plugins/lighttable/export/width | int | 0 | width of the exported image
width of the exported image, or 0 if no scaling should be done.
plugins/lighttable/filmstrip/height | int | 120 | height of filmstrip
height of the filmstrip in pixels
plugins/lighttable/filmstrip/visible | bool | true | enable filmstrip
enable the filmstrip in darkroom, tethering and map modes.
plugins/lighttable/image/expanded | bool | false |
plugins/lighttable/images_in_row | int | 5 | images per row
plugins/lighttable/layout | int | 1 | lighttable layout mode
select a layout for the lighttable: 0 - zoomable lighttable or 1 - file manager.
plugins/lighttable/low_quality_thumbnails | bool | false | low quality thumbnails
if set to true, thumbnails will be processed by first downscaling rather than demosaicing the full image. this can result in much faster processing times and blurrier images, especially when you cropped a lot.
plugins/lighttable/metadata/expanded | bool | false |
plugins/lighttable/metadata_view/pretty_location | bool | true | pretty print the image location
show a more readable representation of the location in the image information module
plugins/lighttable/recentcollect/expanded | bool | false |
plugins/lighttable/recentcollect/line0 | string |  |
plugins/lighttable/recentcollect/line1 | string |  |
plugins/lighttable/recentcollect/line2 | string |  |
plugins/lighttable/recentcollect/line3 | string |  |
plugins/lighttable/recentcollect/line4 | string |  |
plugins/lighttable/recentcollect/line5 | string |  |
plugins/lighttable/recentcollect/line6 | string |  |
plugins/lighttable/recentcollect/line7 | string |  |
plugins/lighttable/recentcollect/line8 | string |  |
plugins/lighttable/recentcollect/line9 | string |  |
plugins/lighttable/recentcollect/num_items | int | 0 |
plugins/lighttable/select/expanded | bool | false |
plugins/lighttable/styles/expanded | bool | false |
plugins/lighttable/tagging/ask_before_delete_tag | bool | true | ask before deleting a tag
plugins/lighttable/tagging/expanded | bool | false |
plugins/lighttable/thumbnail_height | int | 1000 | maximum height of image drawing area
maximum height of the image drawing area in darkroom mode. adjust to your screen\n(needs a restart and will invalidate current thumbnail caches).
plugins/lighttable/thumbnail_width | int | 1300 | maximum width of image drawing area
maximum width of the image drawing area in darkroom mode. adjust to your screen\n(needs a restart and will invalidate current thumbnail caches).
plugins/map/filter_images_drawn | bool | FALSE | only draw images on map that are currently collected and filtered
use the current filter settings to select the geotagged images drawn on the map, i.e. limit the images drawn to the current filmstrip. this limits the number of images drawn and thus reduces the time needed to draw the images.
plugins/map/max_images_drawn | int | 100 | maximum number of images drawn on map
the maximum number of geotagged images drawn on the map. increasing this number can slow drawing of the map down.
plugins/map/show_map_osd | bool | true |
plugins/pwstorage/pwstorage_backend | enum auto none libsecret kwallet gnome keyring | auto | password storage backend to use
the storage backend for password storage: auto, none, libsecret, kwallet, gnome keyring
plugins/slideshow/high_quality | bool | true | do high quality processing for slideshow
same option as for export, but applies to slideshow.
pressure_sensitivity | enum off hardness (relative) hardness (absolute) opacity (relative) opacity (absolute) brush size (relative) | off | pen pressure control for brush masks
off - pressure reading ignored, hardness/opacity/brush size - pressure reading controls specified attribute, absolute/relative - pressure reading is taken directly as attribute value or multiplied with pre-defined setting.
run_crawler_on_start | bool | false | look for updated xmp files on startup
check file modification times of all xmp files on startup to check if any got updated in the meantime
screen_dpi_overwrite | float | -1.0 | overwrite the screen's dpi setting
if this value is > 0.0 then it is used as the screen's dpi setting which is used to scale the gui
screen_ppd_overwrite | float | -1.0 | overwrite the screen's ppd setting
if this value is > 0.0 then it is used as the screen's ppd setting which is used for HiDPI support
session/base_directory_pattern | string | $(PICTURES_FOLDER)/Darktable | base directory naming pattern
part of full import path for an import session
session/filename_pattern | string | $(YEAR)$(MONTH)$(DAY)_$(SEQUENCE).$(FILE_EXTENSION) | file naming pattern
file naming pattern used for a import session
session/sub_directory_pattern | string | $(YEAR)$(MONTH)$(DAY)_$(JOBCODE) | sub directory naming pattern
part of full import path for an import session
show_folder_levels | int | 1 | number of folder levels to show in lists
the number of folder levels to show in film roll names, starting from the right
singlebuffer_limit | int | 16 | minimum amount of memory (in MB) for a single buffer in tiling
if set to a positive, non-zero value this variable defines the minimum amount of memory (in MB) that tiling should take for a single image buffer. has precedence over heuristics based on host_memory_limit (needs a restart).
ui_last/colorpicker_mean | int | 0 | 0: mean, 1: min, 2: max
ui_last/display_profile_source | enum all xatom colord | all | method to use for getting the display profile
this option allows to force a specific means of getting the current display profile. this is useful when one alternative gives wrong results
ui_last/expander_histogram | int | -1 |
ui_last/expander_history | int | -1 |
ui_last/expander_import | int | 2 |
ui_last/expander_metadata | int | 0 |
ui_last/expander_navigation | int | -1 |
ui_last/expander_snapshots | int | -1 |
ui_last/fullscreen | bool | false |
ui_last/grouping | bool | false | grouping of images
only show a single image for each set of grouped images in lighttable and filmstrip
ui_last/import_ignore_jpegs | bool | false | 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.
ui_last/import_initial_rating | int | 1 | initial import rating
initial star rating for all images when importing a filmroll
ui_last/import_last_creator | string |  | creator to be applied when importing
ui_last/import_last_directory | string |  | last opened directory.
ui_last/import_last_publisher | string |  | publisher to be applied when importing
ui_last/import_last_rights | string |  | rights to be applied when importing
ui_last/import_last_tags | string |  | comma separated tags to be applied when importing
ui_last/import_recursive | bool | false | recursive directory traversal when importing filmrolls
ui_last/maximized | bool | false |
ui_last/panel_bottom | int | 0 |
ui_last/panel_left | int | -1 |
ui_last/panel_right | int | -1 |
ui_last/panel_top | int | 0 |
ui_last/view | int | 0 |
ui_last/window_h | int | 500 |
ui_last/window_w | int | 900 |
ui_last/window_x | int | 0 |
ui_last/window_y | int | 0 |
worker_threads | int | 2 | number of background threads
this controls for example how many threads are used to create thumbnails during import. the cache will grow to a maximum of twice this number of full resolution image buffers (needs a restart).
write_sidecar_files | bool | true | write sidecar file for each image
these redundant files can later be re-imported into a different database, preserving your changes to the image.