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|true|false>
17 --upscale <0|1|true|false>
18 --style <style name>
19 --overwrite
20 --verbose
21
23 darktable is a digital photography workflow application for Linux, Mac
24 OS X and several other Unices. It's described further in darktable(1).
25
26 darktable-cli is a command line variant to be used to export images
27 given the raw file and the accompanying xmp file.
28
30 The user needs to supply an input filename and an output filename. All
31 other parameters are optional.
32
33 <input file>
34 The name of the input file to export.
35
36 <xmp file>
37 The optional name of an XMP sidecar file containing the history
38 stack data to be applied during export. If this option is not
39 given darktable will search for an XMP file that belongs to the
40 given input file.
41
42 <output file>
43 The name of the output file. darktable derives the export file
44 format from the file extension. You can also use all the variables
45 available in darktable's export module in the output filename.
46
47 --width <max width>
48 This optional parameter allows one to limit the width of the
49 exported image to that number of pixels.
50
51 --height <max height>
52 This optional parameter allows one to limit the height of the
53 exported image to that number of pixels.
54
55 --bpp <bpp>
56 An optional parameter to define the bit depth of the exported
57 image; allowed values depend on the file format. Currently this
58 option is not yet functional. If you need to define the bit depth
59 you need to use the following workaround:
60
61 --core --conf plugins/imageio/format/<FORMAT>/bpp=<VALUE>
62
63 where FORMAT is the name of the selected output format, for example
64 png.
65
66 --hq <0|1|true|false>
67 A flag that defines whether to use high quality resampling during
68 export. Defaults to true.
69
70 --upscale <0|1|true|false>
71 A flag that defines whether to allow upscaling during export.
72 Defaults to false.
73
74 --style <style name>
75 Specify the name of a style to be applied during export. If a
76 style is specified, the path to the darktable configuration
77 directory must also be specified (i.e. --core --configdir
78 ~/.config/darktable). Defaults to no style specified.
79
80 --overwrite
81 The specified style overwrites the history stack instead of being
82 appended to it.
83
84 --verbose
85 Enables verbose output.
86
87 --core <darktable options>
88 All command line parameters following --core are passed to the
89 darktable core and handled as standard parameters. See
90 darktable(1) for a detailed description of the options.
91
93 darktable(1)
94
96 The principal developer of darktable is Johannes Hanika. The
97 (hopefully) complete list of contributors to the project is:
98
99 * developers: Roman Lebedev, Pascal Obry, Tobias Ellinghaus, Stefan
100 Schöfegger, Peter Budai, Ulrich Pegelow, johannes hanika, parafin,
101 Alexandre Prokoudine, Aldric Renaudin, Edouard Gomez.
102
103 * translators: Pascal Obry, Ger Siemerink, Tobias Ellinghaus, Maurizio
104 Paglia, Timur I. Davletshin, Alexandre Prokoudine, mepi0011, Báthory
105 Péter, Jeronimo Pellegrini, Matjaž Jeran, shlomi braitbart, Aurélien
106 PIERRE, Heiko Bauke, Josep V. Moragues, Marko Vertainen, Michel
107 Leblond, Milan Knížek, Novy Sawai, Ragnar Wisløff, Tomasz Golinski.
108
109 * contributors (at least 4 commits): Aurélien PIERRE, rawfiner,
110 edgardoh, Dan Torop, Ger Siemerink, Matthieu Moy, Maurizio Paglia,
111 Andreas Schneider, Heiko Bauke, Rikard Öxler, Timur I. Davletshin,
112 Benoit Brummer, Philippe Weyland, grand-piano, luzpaz, Mario Lueder,
113 Robert Bridge, mepi0011.
114
115 * RawSpeed contributors (at least 1 commit): Stefan Löffler, Stefan
116 Hoffmeister, parafin, Robert Bieber, Tobias Ellinghaus, Matthieu Volat,
117 Shita Yuuma, Stefan Schöfegger, luz.paz.
118
119 And all those of you that made previous releases possible
120
121 This man page was written by Richard Levitte <richard@levitte.org>.
122 Additions were made by Tobias Ellinghaus <me@houz.org>.
123
125 Copyright (C) 2009-2017 by Authors.
126
127 darktable is free software; you can redistribute it and/or modify it
128 under the terms of the GPL v3 or (at your option) any later version.
129
130
131
132darktable 2.3 2017-01-20 DARKTABLE-CLI(1)