Presets allow you to store commonly-used module settings for future use. Some modules already come with pre-defined (internal) presets and you may also define your own (user-defined). Both internal and user-defined presets can be shown by clicking the presets menu in the module header.
Most of the functionality described here applies to processing modules only. However, presets can also be used with some utility modules. When used with utility modules, the functionality to auto-apply or auto-show presets based on image Exif data is not available.
Please note that, for processing modules, the saved preset also includes the active state of the module. You can use this to create your own default settings, which you can activate on-demand. Simply set your desired defaults, disable the module, and save the preset.
🔗the presets menu
The presets menu will contain one or more of the following entries depending on the presets that are defined or selected for the current module:
- preset list
- A list of the presets available for the current module. The currently selected preset (if any) is shown in bold and with a small check mark beside it.
- edit this preset
- If a preset has been selected, edit the selected preset (see below).
- delete this preset
- If a preset has been selected, delete the selected preset.
- update preset [name]
- Update the named preset to match the module’s current parameters.
- store new preset
- Create a new preset using the module’s current parameters.
Click on a preset name to apply the preset to the current instance of the module. Long-left-click on a preset name to apply the preset but keep the preset list open (so that you can experiment with multiple presets without needing to re-open the menu). Right-click on a preset name to create a new instance of the module and apply the selected preset to it. You can also apply a preset at any time while you are in the darkroom using a keyboard shortcut – if you have assigned one (see preferences > shortcuts).
🔗creating and editing presets
When creating or editing presets, the following dialog is shown:
- The name of the preset
- A searchable description for the preset (optional)
- reset all module parameters to their default values
- Selecting this option will cause all module parameters to be reset to their default values (as if you had simply enabled the module on a new image or clicked the module reset button). This can be used to automatically set certain modules (color calibration, exposure, filmic) based on the Exif properties of the current image rather than setting to hard-coded parameters. Note that this option is not available when editing presets from the preferences > presets tab.
- auto apply this preset to matching images (processing modules only)
- Check this box to automatically apply this preset to matching images when they are opened in the darkroom for the first time (you can reapply such automatic presets by Ctrl+clicking on the reset button in the module header). Additional controls will appear to allow you to define which images the preset will be applied to based on image Exif data (see below).
For example, if you want a preset to be applied to all images from a specific camera leave all fields at default values except for “model”. Leave all fields unchanged to auto-apply a preset to all images.
The example dialog above sets up following rules: if the lens name matches, the aperture is greater than or equal to f/8 and the focal length is between 24 and 35mm the preset will be automatically applied.
The image information module displays the camera model and lens name for each image. Use this to ensure you have the correct spelling.
- only show this preset for matching images (processing modules only)
- Check this box to automatically show the preset in the preset menu, using the same set of filters.
The following criteria can be used to auto-apply or auto-show presets for processing modules:
- A pattern to be matched against the Exif field that describes your camera model; use % as wildcard.
- A pattern to be matched against the Exif field that describes the maker of your camera; use % as wildcard.
- A pattern to be matched against the Exif field that describes your lens; use % as wildcard.
- Only apply the preset if the ISO value of your image lies within the given range (shows ∞ if the upper range is unlimited).
- Only apply the preset if the exposure time of your image lies within the given range; set + as the upper value to match arbitrarily long exposures.
- Only apply the preset if the aperture of your image lies within the given range; set f/0 as the lower value to match arbitrarily open apertures; set f/+ as the upper value to match arbitrarily closed apertures.
- focal length
- Only apply the preset if the focal length of your image lies within the given range (from 0 to 1000).
- Only apply the preset to certain types of image. Check boxes to include files matching these criteria; uncheck boxes to exclude those files. Choose from “raw”, “non-raw”, “HDR”, “monochrome” and “color”.
Both user-defined and internal presets can be viewed and managed from within preferences > presets.
Note: If you create a user-defined preset with the same name as a built-in preset, your preset will override the built-in version, which will no longer be accessible.
If you delete a preset that has the same name as one of the built-in presets, then your user preset will be deleted, and that preset name will no longer appear in the preset menu at all. The next time you start darktable, the corresponding built-in preset will once again become visible.
🔗module naming in the darkroom view
By default, if the current parameters of a processing module match those of a saved preset, darktable will attempt to automatically set the name (label) of the module in question, as follows:
- If the user has manually amended the name of the module in the current image, the module name will be left unchanged,
- If the module instance from which the preset was created had a manually-set name, any subsequent module that matches this preset will automatically be given the same name. Note that if this was unintentional, the only way to revert will be to drop and recreate the preset, since the automatic name is a hidden field in the database,
- If the module instance from which the preset was created did not have a manually-set name, the name of any subsequent module that matches this preset will be set to the same as the preset name.
As soon as the module parameters are changed such that it no longer matches a preset, the module’s name will be reset.
This functionality can be disabled in preferences > darkroom > automatically update module name.