darktable page lede image
darktable page lede image

3.3.4. History stack

The history stack lists every change of state (activate/de-activated) for all modules. Here you can select a point in the stack to return to a point in the development history. If you then activate a new module or change a module parameter, all modules above the selected point will be discarded.

Caution: activating any module action using key accelerators will discard all modules above the currently selected one. It is easy to lose all development work on an image this way!

In darktable 2.0 it is safe to quit the program, leave the darkroom mode, or switch to another image while having selected some earlier state in the history stack panel. The history stack remains unchanged. When returning to the image you will find the history stack panel in the state where you left it.

Hitting compress history stack generates the shortest history stack that produces the current image, i.e. suppressing all obsolete stack items. This also will discard all modules above the currently selected one.

Hitting compress history stack while holding the Ctrl key truncates the history stack without compressing it i.e. it discards all modules above the currently selected one without suppressing obsolete items in the rest of the stack.

Hovering the mouse over an item in the history stack will show a tooltip with all the detailed changes that were made in that module compared to its previous or the default state. This could help track down adjustments that were made unintentionally and that cause a module to have unintended effects. Especially in complex modules with many tabs, or in parametric blending settings, this can avoid tedious searching.

The button to the right lets you create a new style for applying your history stack to other images. Use the first line of the popup dialog window to name your style and the second to add a searchable description. You are prompted for which of the current history stack modules to include in the style.

Once created styles are then managed and applied to other images through lighttable's styles panel (see Section 2.3.10, “Styles”).