darktable page lede image
darktable page lede image

darktable 3.4

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.

The present user manual is under license cc by-sa , meaning Attribution Share Alike . You can visit the creative commons page to get more information.


Table of Contents
Preface
1. Overview
1.1. Program invocation
1.1.1. darktable binary
1.1.2. darktable-cli binary
1.1.3. darktable-generate-cache binary
1.1.4. darktable-chart binary
1.1.5. darktable-cltest binary
1.1.6. darktable-cmstest binary
1.2. User interface
1.2.1. Views
1.2.2. Screen layout
1.2.3. Filmstrip
1.2.4. Preferences
1.2.5. Contextual help
1.2.6. Shortcuts window
1.3. darktable basic workflow
1.3.1. Importing images
1.3.2. Basic development steps
1.3.3. Exporting images
2. Lighttable
2.1. Overview
2.1.1. Filemanager
2.1.2. Zoomable lighttable
2.1.3. Culling
2.1.4. Full preview
2.2. Lighttable concepts
2.2.1. Film rolls
2.2.2. Collections
2.2.3. Thumbnails
2.2.4. Star ratings and color labels
2.2.5. Filtering and sort order
2.2.6. Image grouping
2.2.7. Sidecar files
2.2.8. Importing sidecar files generated by other applications
2.2.9. Local copies
2.2.10. Undo/redo
2.3. Lighttable panels
2.3.1. Import
2.3.2. Collect images
2.3.3. Recently used collections
2.3.4. Timeline
2.3.5. Image information
2.3.6. Lua Scripts Installer
2.3.7. Select
2.3.8. Selected image(s)
2.3.9. History stack
2.3.10. Styles
2.3.11. Geotagging
2.3.12. Metadata editor
2.3.13. Tagging
2.3.14. Export selected
3. Darkroom
3.1. Overview
3.2. Darkroom concepts
3.2.1. Pixelpipe, module order, and history stack
3.2.2. Interacting with modules
3.2.3. Module presets
3.2.4. Multiple instances
3.2.5. Blending
3.2.6. Color management
3.3. Darkroom panels
3.3.1. Image infos line
3.3.2. Navigation
3.3.3. Snapshots
3.3.4. History stack
3.3.5. Duplicate manager
3.3.6. Global color picker
3.3.7. Mask manager
3.3.8. Histogram
3.3.9. Modules order
3.3.10. Module groups
3.3.11. Bottom panel
3.4. Modules
3.4.1. Technical group
3.4.2. Grading group
3.4.3. Effects group
3.5. Examples
3.5.1. Converting to black and white
3.5.2. Cross-processing
3.5.3. Cyan toned image
3.5.4. Removal of red-eye effect
4. Tethering
4.1. Overview
4.1.1. Tethering
4.2. Tethering panels
4.2.1. Session
4.2.2. Live view
4.2.3. Camera settings
4.3. Examples
4.3.1. Studio setup with screening
4.3.2. Capturing a timelapse
4.4. Troubleshoot
4.4.1. Verify that your camera is supported
4.4.2. So, now what?
5. Map
5.1. Overview
5.1.1. Center map view
5.1.2. Undo/redo
5.2. Map panels
5.2.1. Left panels
5.2.2. Find location
5.2.3. Locations
5.2.4. Map settings
5.2.5. Tagging
6. Slideshow
6.1. Overview
6.2. Usage
7. Print
7.1. Overview
7.2. Usage
7.2.1. Printer section
7.2.2. Page section
7.2.3. Print settings
7.2.4. Print button
8. Preferences and settings
8.1. General
8.2. Import
8.2.1. import
8.2.2. session options
8.3. Lighttable
8.4. Darkroom
8.5. Other views
8.5.1. map/geolocalisation
8.5.2. slideshow
8.6. Processing
8.7. Security
8.8. Cpu / gpu / memory
8.9. Storage
8.9.1. database
8.9.2. xmp
8.10. Miscellaneous
8.10.1. interface
8.10.2. tags
8.10.3. keyboard shortcuts with multiple instances
8.10.4. other
8.11. Shortcuts
8.11.1. Adjusting Keyboard Shortcuts
8.11.2. Import/Export/Reset
8.11.3. Shortcut Categories
8.11.4. utility modules
8.12. Presets
8.13. Lua options
9. Scripting with Lua
9.1. Lua usage
9.1.1. Basic principles
9.1.2. A simple lua example
9.1.3. Printing labeled images
9.1.4. Adding a simple shortcut
9.1.5. Exporting images with Lua
9.1.6. Building User Interface elements
9.1.7. Sharing scripts
9.1.8. Calling Lua from DBus
9.1.9. Using darktable from a lua script
9.2. Lua API
10. Special topics
10.1. darktable and memory
10.1.1. Total system memory
10.1.2. Available address space
10.1.3. Memory fragmentation
10.1.4. Further limitations
10.1.5. Setting up darktable on 32-bit systems
10.1.6. darktable on 64-bit systems
10.2. darktable and OpenCL
10.2.1. The background
10.2.2. How OpenCL works
10.2.3. How to activate OpenCL in darktable
10.2.4. Setting up OpenCL on your system
10.2.5. Possible problems and solutions
10.2.6. Setting up OpenCL for AMD/ATI devices
10.2.7. OpenCL performance optimization
10.2.8. OpenCL scheduling profile
10.2.9. Multiple OpenCL devices – manual settings
10.2.10. OpenCL still does not run for me!
10.3. Using darktable-chart
10.3.1. Overview
10.3.2. Usage
10.3.3. Source image
10.3.4. Reference values
10.3.5. Process
10.3.6. Making input images for darktable-chart
10.4. variable substitution
10.4.1. available variables
10.4.2. variables substitutions
10.4.3. pango markup
Index