darktable 2.6 darktable 2.6 Copyright © 2010-2012 P.H. Andersson Copyright © 2010-2011 Olivier Tribout Copyright © 2012-2018 Ulrich Pegelow Copyright © 2013-2017 Jérémy Rosen The founder of the darktable project is Johannes Hanika. darktable has been developed with major contribution by Aldric Renaudin, Alexander V. Smal, Alexandre Prokoudine, Ammon Riley, Anders Brander, Andreas Schneider, Andrea Volpato, Andrew Toskin, Antony Dovgal, Artur de Sousa Rocha, Asma AL-Bahanta, Aurélien Pierre, Axel Waggershauser, Báthory Péter, Benoit Brummer, Bernd Steinhauser, Brian Teague, Bruce Guenter, Cherrot Luo, Chris Hodapp, Christian Himpel, Christian Tellefsen, Dan Torop, David Bremner, Dennis Gnad, Dimitrios Psychogios, Dušan Kazik, Eckhart Pedersen, Edgardo Hoszowski, Edouard Gomez, Frédéric Grollier, Gaspard Jankowiak, Germano Massullo, Ger Siemerink, Gianluigi Calcaterra, Gianni Carabelli, Guilherme Brondani Torri, Guillaume Benny, Heiko Bauke, Henrik Andersson, Igor Kuzmin, Ivan Tarozzi, James C. McPherson, Jan Kundrát, Jérémy Rosen, Jean-Sébastien Pédron, Jesper Pedersen, Jochen Schroeder, Johanes Schneider, Johannes Hanika, José Carlos Casimiro, José Carlos Garcia Sogo, Josep V. Moragues, K. Adam Christensen, Kaminsky Andrey, Kanstantsin Shautsou, Karl Mikaelsson, Klaus Post, Loic Guibert, Marcel Laubach, Matjaž Jeran, Matthias Gehre, Matthieu Moy, Matthieu Volat, Maurizio Paglia, Mauro Bartoccelli, Maximilian Trescher, Michal Babej, Michel Leblond, Mikko Ruohola, Milan Knížek, Moritz Lipp, Nicolas Belleville, Novy Sawai, Olivier Tribout, Pascal de Bruijn, Pascal Obry, Pedro Côrte-Real, Peter Budai, Petr Styblo, Pierre Lamot, Ralf Brown, Richard Hughes, Richard Levitte, Richard Wonka, Rikard Öxler, Robert Bieber, Robert William Hutton, Roman Lebedev, Rostyslav Pidgornyi, Sergey Pavlov, Shlomi Braitbart, Simon Spannagel, Stefan Hoffmeister, Stefan Löffler, Stefan Schöfegger, Stuart Henderson, Tatica Leandro, Thomas Pryds, Timur I. Davletshin, Tobias Ellinghaus, Torsten Bronger, Ulrich Pegelow, Victor Lamoine, Wolfgang Goetz, Wolfgang Mader, Wyatt Olson, Žilvinas Žaltiena and many others. darktable is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. darktable is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with darktable. If not, see the GNU homepage [http://www.gnu.org/licenses/]. The present user manual is under license cc by-sa , meaning Attribution Share Alike . You can visit the creative commons page [http://creativecommons.org/about/licenses/] to get more information. Table of Contents Preface ..................................................................................................................... vii 1. Overview ................................................................................................................ 1 1.1. Program invocation ..................................................................................... 3 1.1.1. darktable binary ............................................................................ 3 1.1.2. darktable-cli binary .................................................................... 5 1.1.3. darktable-generate-cache binary .............................................. 6 1.1.4. darktable-chart binary ................................................................ 7 1.1.5. darktable-cltest binary .............................................................. 8 1.1.6. darktable-cmstest binary ............................................................ 8 1.2. User interface .............................................................................................. 9 1.2.1. Views ................................................................................................ 9 1.2.2. Screen layout .................................................................................. 10 1.2.3. Filmstrip ......................................................................................... 10 1.2.4. Preferences .................................................................................... 10 1.2.5. Contextual help .............................................................................. 10 1.3. darktable basic workflow ........................................................................... 11 1.3.1. Importing images ............................................................................ 11 1.3.2. Basic development steps ................................................................. 11 1.3.3. Exporting images ............................................................................ 13 2. Lighttable ............................................................................................................. 15 2.1. Overview ................................................................................................... 16 2.2. Lighttable concepts ................................................................................... 18 2.2.1. Film rolls ......................................................................................... 18 2.2.2. Collections ...................................................................................... 18 2.2.3. Thumbnails ..................................................................................... 18 2.2.4. Star ratings and color labels ............................................................ 20 2.2.5. Filtering and sort order ................................................................... 20 2.2.6. Image grouping ............................................................................... 21 2.2.7. Sidecar files .................................................................................... 22 2.2.8. Importing sidecar files generated by other applications ................... 23 2.2.9. Local copies .................................................................................... 24 2.3. Lighttable panels ....................................................................................... 25 2.3.1. Import ............................................................................................ 25 2.3.2. Collect images ................................................................................ 27 2.3.3. Recently used collections ................................................................ 29 2.3.4. Image information .......................................................................... 29 2.3.5. Select ............................................................................................. 29 2.3.6. Selected image(s) ............................................................................ 30 2.3.7. History stack ................................................................................... 32 2.3.8. Styles .............................................................................................. 33 2.3.9. Geotagging ..................................................................................... 34 2.3.10. Metadata editor ............................................................................ 35 2.3.11. Tagging ......................................................................................... 36 2.3.12. Export selected ............................................................................. 36 3. Darkroom ............................................................................................................. 41 3.1. Overview ................................................................................................... 42 3.2. Darkroom concepts .................................................................................... 43 3.2.1. Pixelpipe, module order, and history stack ....................................... 43 3.2.2. Interacting with modules ................................................................ 43 3.2.3. Module presets ............................................................................... 45 3.2.4. Multiple instances ........................................................................... 46 3.2.5. Blending ......................................................................................... 48 iii 3.2.6. Color management ......................................................................... 61 3.3. Darkroom panels ....................................................................................... 64 3.3.1. Navigation ...................................................................................... 64 3.3.2. Snapshots ....................................................................................... 64 3.3.3. History stack ................................................................................... 64 3.3.4. Duplicate manager .......................................................................... 65 3.3.5. Global color picker .......................................................................... 65 3.3.6. Mask manager ................................................................................ 66 3.3.7. Histogram ....................................................................................... 68 3.3.8. Module groups ................................................................................ 69 3.3.9.