DARKTABLE-GENERATE-CACHE(1)

💖 darktable-generate-cache(1) — the manual, but make it a group chat 💖

okay bestie, so this is the manual page for darktable-generate-cache, living in section 1 of the manual (that's the "user commands" section, iykyk). It's part of the darktable family of docs, so if you ever need the main character herself, that's darktable(1). ✨

---

🌸 NAME 🌸

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

---

🎀 SYNOPSIS 🎀

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

---

🦋 DESCRIPTION 🦋

So darktable is this digital photography workflow application for Linux, Mac OS X and several other Unices, and it gets described way more in darktable(1). Go read that if you want the whole lore. 📖

And darktable-generate-cache? It updates darktable's thumbnail cache. That's literally it, and it's lowkey iconic for it. You can just start this program and let it generate all the missing thumbnails in the background while your computer is sitting there idle, doing nothing, being useless. Perfect little background task behavior, no notes. 💅

---

✨ OPTIONS ✨

okay so every single parameter here is optional. Start it with zero parameters and darktable-generate-cache will just use reasonable defaults like the well-adjusted program it is. 🫶

• -h, --help — gives you usage information and then terminates. classic.
• --version — gives you copyright and version information and then terminates. also classic.
• --min-mip <0-7>
• -m, --max-mip <0-7> — so 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 they default to a range of 0-2. There is normally no need to generate all possible resolutions here, because the missing ones will be automatically generated by darktable the moment they're needed. And when you ask it to generate multiple resolutions at once, the lower-resolution images are quickly downsampled from the highest-resolution image. efficiency queen 👑
• --min-imgid <N>
• --max-imgid <N> — specifies the range of internal image IDs from the database to work on. If you don't give a range, darktable-generate-cache will process all images from the entire collection. all of them. every single one. 😭
• --core <darktable options> — all command line parameters following --core get passed to the darktable core and handled as standard parameters. See darktable(1) for a detailed description of the options. 🧚

---

🌈 SEE ALSO 🌈

• darktable(1)

---

💜 AUTHORS 💜

The principal developer of darktable is Johannes Hanika. And the (hopefully) complete list of contributors to the project is, in all its glory:

• Developers: Pascal Obry Hanno Schwalm Victor Forsiuk Mario Zimmermann Ralf Brown Andrii Ryzhkov Dan Torop Jeronimo Pellegrini Daniele Pighin Robert Mongold Philipp Lutz Bill Ferguson Kofa Martin Straeten Miloš Komarčević EdgarLux Diederik ter Rahe Stéphane Gourichon Ryo Shinozaki deekayhd Benjamin Grimm-Lebsanft Matjaž Jeran esq4 David Smith Hpbirkeland Marko Vertainen Yannic Meyer
• Translators: Victor Forsiuk Pascal Obry Jeronimo Pellegrini Martin Straeten EdgarLux Stéphane Gourichon Ryo Shinozaki Matjaž Jeran esq4 Hpbirkeland Marko Vertainen Báthory Péter RIM Andrii Ryzhkov Besmir Godolja Johan Schiff Kang-Wei Hsu Tianhao Chai 94tiger BoneNI Florian Tham GameMaster0x Jan Šmucr Yannic Meyer zxs-un
• Sub-module rawspeed contributors (at least 1 commit): Miloš Komarčević Roman Lebedev Sidhartha Steven Le Rouzic
• Sub-module integration contributors (at least 1 commit): Pascal Obry yuri
• Sub-module lua-scripts contributors (at least 1 commit): Bill Ferguson Tino Mettler deekayhd Andrii Ryzhkov Ilya Palopezhentsev Martin Straeten Björn Lindström Dan Zwell fblampe Aaron Patterson dterrahe masterpiga

And all those of you that made previous releases possible 💖 (that's you, bestie, fr fr)

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>. giving credit where credit is due, we love to see it. 🎀

---

👑 COPYRIGHT AND LICENSE 👑

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.

okay so real talk: that license line is not decorative, bestie. GPL v3 or later — that's the deal. respect it. 💅

---

and that's the whole page!! darktable 2.3, dated 2017-01-20, and it goes by DARKTABLE-GENERATE-CACHE(1) — that's the source, the version and the date all wrapped up in one lil sign-off. go generate those thumbnails, you absolute icon. 🌟🦋💖