.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DARKTABLE-GENERATE-CACHE 1"
.TH DARKTABLE-GENERATE-CACHE 1 2017-01-20 "darktable 2.3" darktable
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
darktable\-generate\-cache \- update darktable's thumbnail cache
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\&    darktable\-generate\-cache [\-h, \-\-help; \-\-version] [\-m, \-\-max\-mip <0\-7>] [\-\-core <darktable options>]
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBdarktable\fR is a digital photography workflow application for \fBLinux\fR, \fBMac OS X\fR and several other \fBUnices\fR.
It's described further in \fBdarktable\fR\|(1).
.PP
\&\fBdarktable-generate-cache\fR updates darktable's thumbnail cache.
You can start this program to generate all missing thumbnails in the background when your computer is idle.
.SH OPTIONS
.IX Header "OPTIONS"
All parameters are optional.
If started without parameters \fBdarktable-generate-cache\fR uses reasonable defaults.
.IP "\fB\-h, \-\-help\fR" 4
.IX Item "-h, --help"
Gives usage information and terminates.
.IP \fB\-\-version\fR 4
.IX Item "--version"
Gives copyright and version information and terminates.
.IP "\fB\-\-min\-mip <0\-7>\fR" 4
.IX Item "--min-mip <0-7>"
.PD 0
.IP "\fB\-m, \-\-max\-mip <0\-7>\fR" 4
.IX Item "-m, --max-mip <0-7>"
.PD
\&\fBdarktable\fR 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 \fB0\-2\fR.
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.
.IP "\fB\-\-min\-imgid <N>\fR" 4
.IX Item "--min-imgid <N>"
.PD 0
.IP "\fB\-\-max\-imgid <N>\fR" 4
.IX Item "--max-imgid <N>"
.PD
Specifies the range of internal image IDs from the database to work on.
If no range is given, \fBdarktable-generate-cache\fR will process all images from the entire collection.
.IP "\fB\-\-core <darktable options>\fR" 4
.IX Item "--core <darktable options>"
All command line parameters following \fB\-\-core\fR are passed
to the darktable core and handled as standard parameters.
See \fBdarktable\fR\|(1) for a detailed description of the options.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdarktable\fR\|(1)
.SH AUTHORS
.IX Header "AUTHORS"
The principal developer of darktable is Johannes Hanika.
The (hopefully) complete list of contributors to the project is:
.PP
* developers:
Pascal Obry
Aldric Renaudin
Roman Lebedev

* translators:
Victor Forsiuk
Pascal Obry
Jeronimo Pellegrini
Martin Straeten
EdgarLux
Marko Vertainen
Kang-Wei Hsu
Mario Zimmermann
Matteo Mardegan
RIM
Fabio Sirna
Nicolas Auffray
Petr Stasiak
Serkan ÖNDER
Яна Тунгушпаева
Besmir Godolja
Báthory Péter
Kofa
Matjaž Jeran
Nicolas
Ryo Shinozaki
Tianhao Chai
bajdero

* contributors (at least 4 commits):
Victor Forsiuk
Hanno Schwalm
Diederik ter Rahe
Mario Zimmermann
Jeronimo Pellegrini
Miloš Komarčević
Sakari Kapanen
Martin Straeten
Ralf Brown
solarer
EdgarLux
Chris Elston
Paolo DePetrillo
Bill Ferguson
gi-man
Marko Vertainen
rawfiner
Kang-Wei Hsu
Nicolas Auffray

* Sub-module rawspeed contributors (at least 1 commit):
Roman Lebedev
Miloš Komarčević
Georg Lukas
Yattaro
Jan Šmucr
Jorge Nerín
Marco Ristuccia
Massimo Paladin
Michael Allman
Omari Stephens
Victor Forsiuk

* Sub-module integration contributors (at least 1 commit):
Pascal Obry
Sakari Kapanen

And all those of you that made previous releases possible
.PP
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>.
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
\&\fBCopyright (C)\fR 2009\-2017 by Authors.
.PP
\&\fBdarktable\fR 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.