darktable 1.4

The owner of the darktable project is Johannes Hanika. Main developers are Johannes Hanika, Henrik Andersson, Tobias Ellinghaus, Pascal de Bruijn and Ulrich Pegelow.

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 to this manual
1. Overview
1.1. Program invocation
1.1.1. darktable binary
1.1.2. darktable-cli binary
1.2. User interface
1.2.1. Views
1.2.2. Screen layout
1.2.3. Filmstrip
1.2.4. Preferences
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.2. Lighttable concepts
2.2.1. Film rolls
2.2.2. Collections
2.2.3. Star ratings and color labels
2.2.4. Filtering and sort order
2.2.5. Image grouping
2.2.6. Sidecar files
2.2.7. Importing sidecar files generated by other applications
2.2.8. Local copies
2.3. Lighttable panels
2.3.1. Import
2.3.2. Collect images
2.3.3. Recently used collections
2.3.4. Image information
2.3.5. Select
2.3.6. Selected image(s)
2.3.7. History stack
2.3.8. Styles
2.3.9. Geotagging
2.3.10. Metadata editor
2.3.11. Tagging
2.3.12. Export selected
3. Darkroom
3.1. Overview
3.2. Darkroom concepts
3.2.1. Interacting with modules
3.2.2. Module presets
3.2.3. Multiple instances
3.2.4. Blending
3.2.5. Blending operators
3.2.6. Drawn mask
3.2.7. Parametric mask
3.2.8. Combining drawn and parametric masks
3.3. Darkroom panels
3.3.1. Navigation
3.3.2. Snapshots
3.3.3. History stack
3.3.4. Global color picker
3.3.5. Mask manager
3.3.6. Histogram
3.3.7. Module groups
3.3.8. More modules
3.3.9. Bottom panel
3.4. Modules
3.4.1. Basic group
3.4.2. Tone group
3.4.3. Color group
3.4.4. Correction group
3.4.5. Effect group
3.5. Examples
3.5.1. Converting to black and white
3.5.2. Cross-processing
3.5.3. Cyan toned image
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.2. Map panels
5.2.1. Left panels
5.2.2. Find location
5.2.3. Map settings
5.2.4. Tagging
6. Preferences and settings
6.1. GUI options
6.2. Core options
6.3. Shortcuts
6.4. Presets
7. Scripting with Lua
7.1. Lua usage
7.1.1. A note about beta
7.1.2. Basic principles
7.1.3. Handling scripts
7.1.4. Yielding from Lua code
7.2. Lua API
7.2.1. darktable
7.2.2. types
7.2.3. events
7.2.4. attributes
7.2.5. system
7.3. Lua scripts
7.3.1. Simple mosaic script
7.3.2. Selection manipulation shortcuts
7.4. Lua debugging
7.4.1. Enable error logging
7.4.2. Inspecting internal objects
7.4.3. Debugging unprotected calls
8. Special topics
8.1. darktable and memory
8.1.1. Total system memory
8.1.2. Available address space
8.1.3. Memory fragmentation
8.1.4. Further limitations
8.1.5. Setting up darktable on 32-bit systems
8.1.6. darktable on 64-bit systems
8.2. darktable and OpenCL
8.2.1. The background
8.2.2. How OpenCL works
8.2.3. How to activate OpenCL in darktable
8.2.4. Possible problems and solutions
8.2.5. Setting up OpenCL for AMD/ATI devices
8.2.6. OpenCL performance optimization
8.2.7. Multiple OpenCL devices
8.2.8. OpenCL still does not run for me!
Index