1DARKTABLE-CLI(1) darktable DARKTABLE-CLI(1)
2
3
4
6 darktable-cli - a command line darktable variant
7
9 darktable-cli IMG_1234.{RAW,...} [<xmp file>] <output file> [options] [--core <darktable options>]
10
11 Options:
12
13 --width <max width>
14 --height <max height>
15 --bpp <bpp>
16 --hq <0|1|false|true>
17 --upscale <0|1|false|true>
18 --export_masks <0|1|false|true>
19 --style <style name>
20 --style-overwrite
21 --apply-custom-presets <0|1|false|true>
22 --verbose
23 --help
24 --version
25
27 darktable is a digital photography workflow application for Linux, Mac
28 OS X and several other Unices. It's described further in darktable(1).
29
30 darktable-cli is a command line variant to be used to export images
31 given the raw file and the accompanying xmp file.
32
34 The user needs to supply an input filename and an output filename. All
35 other parameters are optional.
36
37 <input file>
38 The name of the input file to export.
39
40 <xmp file>
41 The optional name of an XMP sidecar file containing the history
42 stack data to be applied during export. If this option is not
43 given darktable will search for an XMP file that belongs to the
44 given input file.
45
46 <output file>
47 The name of the output file. darktable derives the export file
48 format from the file extension. You can also use all the variables
49 available in darktable's export module in the output filename.
50
51 --width <max width>
52 This optional parameter allows one to limit the width of the
53 exported image to that number of pixels.
54
55 --height <max height>
56 This optional parameter allows one to limit the height of the
57 exported image to that number of pixels.
58
59 --bpp <bpp>
60 An optional parameter to define the bit depth of the exported
61 image; allowed values depend on the file format. Currently this
62 option is not yet functional. If you need to define the bit depth
63 you need to use the following workaround:
64
65 --core --conf plugins/imageio/format/<FORMAT>/bpp=<VALUE>
66
67 where FORMAT is the name of the selected output format, for example
68 png.
69
70 --hq <0|1|true|false>
71 A flag that defines whether to use high quality resampling during
72 export. Defaults to true.
73
74 --upscale <0|1|true|false>
75 A flag that defines whether to allow upscaling during export.
76 Defaults to false.
77
78 --export_masks <0|1|true|false>
79 A flag that defines whether masks used in the image will be stored
80 as layers in the exported image (provided the format supports it).
81 Defaults to false.
82
83 --style <style name>
84 Specify the name of a style to be applied during export. If a
85 style is specified, the path to the darktable configuration
86 directory must also be specified (i.e. --core --configdir
87 ~/.config/darktable). Defaults to no style specified.
88
89 --style-overwrite
90 The specified style overwrites the history stack instead of being
91 appended to it.
92
93 --apply-custom-presets
94 With this option you can decide if darktable loads its set of
95 default parameters from data.db and applies them. Otherwise the
96 defaults that ship with darktable are used.
97
98 Set this flag to false in order to run multiple instances.
99
100 --verbose
101 Enables verbose output.
102
103 --core <darktable options>
104 All command line parameters following --core are passed to the
105 darktable core and handled as standard parameters. See
106 darktable(1) for a detailed description of the options.
107
109 darktable(1)
110
112 The principal developer of darktable is Johannes Hanika. The
113 (hopefully) complete list of contributors to the project is:
114
115 * developers: Pascal Obry Aldric Renaudin Aurélien PIERRE Roman Lebedev
116 parafin Peter Budai
117
118 * translators: Pascal Obry Jeronimo Pellegrini Martin Straeten EdgarLux
119 Matt Maguire Kevin Vermassen Victor Forsiuk Nicolas Auffray Matteo
120 Mardegan Nameless-J Timur Davletshin chrisaga Báthory Péter Matjaž
121 Jeran thisnamewasnottaken Arch Ont Aurélien PIERRE Bernhard Danilo
122 Bargen Mik- Miloš Komarčević Miroslav Fikar Shlomi Alon-Braitbart
123 jpellegrini quovadit
124
125 * contributors (at least 4 commits): ralfbrown Philippe Weyland
126 hanno@schwalm-bremen.de Hubert Kowalski Dan Torop Chris.Elston Jeronimo
127 Pellegrini rawfiner Martin Straeten Miloš Komarčević Diederik ter Rahe
128 Nicolas Auffray Sakari Kapanen Victor Forsiuk lhietal EdgarLux Matt
129 Maguire wpferguson Ralf Brown Kevin Vermassen Vincent THOMAS Daniel
130 Vogelbacher Bill Ferguson Harold le Clément de Saint-Marcq quovadit
131 Andreas Schneider Fabio Heer Hanno Schwalm HansBull Heiko Bauke Marco
132 Marco Carrarini Mark-64 vrnhgd Roman Khatko Philipp Lutz Harald
133 Wolfgang Goetz Jim Robinson dterrahe
134
135 * Sub-module rawspeed contributors (at least 1 commit): Roman Lebedev
136 Miloš Komarčević Hubert Kowalski Dan Torop Daniel Vogelbacher Elizeu
137 Santos Frank Loemker Matt Maguire hanno@schwalm-bremen.de jas01
138
139 * Sub-module OpenCL contributors (at least 1 commit):
140
141 * Sub-module libxcf contributors (at least 1 commit):
142
143 * Sub-module whereami contributors (at least 1 commit):
144
145 * Sub-module integration contributors (at least 1 commit): Pascal Obry
146 Miloš Komarčević hanno@schwalm-bremen.de Aurélien PIERRE
147
148 And all those of you that made previous releases possible
149
150 This man page was written by Richard Levitte <richard@levitte.org>.
151 Additions were made by Tobias Ellinghaus <me@houz.org>.
152
154 Copyright (C) 2009-2019 by Authors.
155
156 darktable is free software; you can redistribute it and/or modify it
157 under the terms of the GPL v3 or (at your option) any later version.
158
159
160
161darktable 3.0 2019-11-27 DARKTABLE-CLI(1)