Scroll to navigation



darktable-generate-cache - 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.




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

* developers: Pascal Obry Aldric Renaudin Roman Lebedev Tobias Ellinghaus Ulrich Pegelow parafin Pascal de Bruijn Stefan Schöfegger Peter Budai johannes hanika Edouard Gomez

* translators: Pascal Obry EdgarLux Ger Siemerink Timur I. Davletshin Michel Leblond Nilvus Jakub Filipowicz Matjaž Jeran Josep V. Moragues mepi0011 Heiko Bauke Maurizio Paglia Milan Knížek Novy Sawai Tomasz Golinski maruncz Báthory Péter Jacques Le Clerc Ragnar Wisloff Thomas Pryds Tobias Ellinghaus shlomi braitbart Denis Dyakov Edgar De la Luz Shlomi Alon-Braitbart Simon Raffeiner Tomasz Goliński archont00 chri johannes hanika lkarcz

* contributors (at least 4 commits): Aurélien PIERRE Andreas Schneider edgardoh rawfiner Philippe Weyland Nilvus EdgarLux Ger Siemerink Heiko Bauke Jakub Filipowicz Jacques Le Clerc Timur I. Davletshin Michel Leblond Timur Davletshin Bill Ferguson Sam Smith Alexis Mousset Matjaž Jeran mepi0011 Matthieu Moy Rikard Öxler junkyardsparkle Hanno Schwalm Denis Dyakov Diederik ter Rahe luzpaz Dan Torop Josep V. Moragues Marcello Mamino Wolfgang Goetz maruncz mondoman712

* Sub-module rawspeed contributors (at least 1 commit): Roman Lebedev Robert Bridge bobobo1618 luz.paz parafin Bastian Bechtold Martijn Courteaux Pascal de Bruijn chrunchyjesus dllu junkyardsparkle

And all those of you that made previous releases possible

This man page was written by Ulrich Pegelow <> as part of the usermanual. It was turned into a man page by Tobias Ellinghaus <>.


Copyright (C) 2009-2017 by Authors.

darktable is free software; you can redistribute it and/or modify it under the terms of the GPL v3 or (at your option) any later version.

2017-01-20 darktable 2.3