darktable-generate-cache - Man Page

update darktable's thumbnail cache


    darktable-generate-cache [-h, --help; --version] [-m, --max-mip <0-7>] [--core <darktable options>]


darktable is a digital photography workflow application for Linux, Mac OS X and several other Unices. It's described further in darktable(1).

darktable-generate-cache updates darktable's thumbnail cache. You can start this program to generate all missing thumbnails in the background when your computer is idle.


All parameters are optional. If started without parameters darktable-generate-cache uses reasonable defaults.

-h,  --help

Gives usage information and terminates.


Gives copyright and version information and terminates.

--min-mip <0-7>
-m,  --max-mip <0-7>

darktable can handle and store thumbnails with up to eight different resolution steps for each image. These parameters define which maximum resolution should be generated and default to a range of 0-2. There is normally no need to generate all possible resolutions here; missing ones will be automatically generated by darktable the moment they are needed. When asked to generate multiple resolutions at once, the lower-resolution images are quickly downsampled from the highest-resolution image.

--min-imgid <N>
--max-imgid <N>

Specifies the range of internal image IDs from the database to work on. If no range is given, darktable-generate-cache will process all images from the entire collection.

--core <darktable options>

All command line parameters following --core are passed to the darktable core and handled as standard parameters. See darktable(1) for a detailed description of the options.

See Also



The principal developer of darktable is Johannes Hanika. The (hopefully) complete list of contributors to the project is:

* developers: Pascal Obry Aldric Renaudin Aurélien PIERRE Roman Lebedev parafin Peter Budai

* translators: Pascal Obry Jeronimo Pellegrini Martin Straeten EdgarLux Matt Maguire Kevin Vermassen Victor Forsiuk Nicolas Auffray Matteo Mardegan Nameless-J Timur Davletshin chrisaga Báthory Péter Matjaž Jeran thisnamewasnottaken Arch Ont Aurélien PIERRE Bernhard Danilo Bargen Mik- Miloš Komarčević Miroslav Fikar Shlomi Alon-Braitbart jpellegrini quovadit

* contributors (at least 4 commits): ralfbrown Philippe Weyland hanno@schwalm-bremen.de Hubert Kowalski Dan Torop Chris.Elston Jeronimo Pellegrini rawfiner Martin Straeten Miloš Komarčević Diederik ter Rahe Nicolas Auffray Sakari Kapanen Victor Forsiuk lhietal EdgarLux Matt Maguire wpferguson Ralf Brown Kevin Vermassen Vincent THOMAS Daniel Vogelbacher Bill Ferguson Harold le Clément de Saint-Marcq quovadit Andreas Schneider Fabio Heer Hanno Schwalm HansBull Heiko Bauke Marco Marco Carrarini Mark-64 vrnhgd Roman Khatko Philipp Lutz Harald Wolfgang Goetz Jim Robinson dterrahe

* Sub-module rawspeed contributors (at least 1 commit): Roman Lebedev Miloš Komarčević Hubert Kowalski Dan Torop Daniel Vogelbacher Elizeu Santos Frank Loemker Matt Maguire hanno@schwalm-bremen.de jas01

* Sub-module OpenCL contributors (at least 1 commit):

* Sub-module libxcf contributors (at least 1 commit):

* Sub-module whereami contributors (at least 1 commit):

* Sub-module integration contributors (at least 1 commit): Pascal Obry Miloš Komarčević hanno@schwalm-bremen.de Aurélien PIERRE

And all those of you that made previous releases possible

This man page was written by Ulrich Pegelow <ulrich.pegelow@tongareva.de> as part of the usermanual. It was turned into a man page by Tobias Ellinghaus <me@houz.org>.


2017-01-20 darktable 2.3