=head1 NAME

darktable-generate-cache - update darktable's thumbnail cache

=head1 SYNOPSIS

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

=head1 DESCRIPTION

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

B<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.

=head1 OPTIONS

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

=over

=item B<-h, --help>

Gives usage information and terminates.

=item B<--version>

Gives copyright and version information and terminates.

=item B<< --min-mip <0-7> >>

=item B<< -m, --max-mip <0-7> >>

B<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 B<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.

=item B<< --min-imgid <N> >>

=item B<< --max-imgid <N> >>

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

=item B<< --core <darktable options>  >>

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

=back

=head1 SEE ALSO

L<darktable(1)|darktable(1)>

=head1 AUTHORS

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

DREGGNAUTHORS -- don't translate this line!

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


=head1 COPYRIGHT AND LICENSE

B<Copyright (C)> 2009-2017 by Authors.

B<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.

=for comment
$Date: 2017-01-20$
$Release: 2.3$