1DARKTABLE-CLI(1)                   darktable                  DARKTABLE-CLI(1)
2
3
4

NAME

6       darktable-cli - a command line darktable variant
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

SEE ALSO

93       darktable(1)
94

AUTHORS

96       The principal developer of darktable is Johannes Hanika.  The
97       (hopefully) complete list of contributors to the project is:
98
99       * developers: Pascal Obry, Tobias Ellinghaus, Roman Lebedev, Stefan
100       Schöfegger, Ulrich Pegelow, Peter Budai, parafin, johannes hanika,
101       Alexandre Prokoudine, Aldric Renaudin, Pascal de Bruijn, Edouard Gomez.
102
103       * translators: Pascal Obry, Ger Siemerink, Michel Leblond, Nilvus,
104       Timur I. Davletshin, Tobias Ellinghaus, mepi0011, Maurizio Paglia,
105       Alexandre Prokoudine, Báthory Péter, Heiko Bauke, Jeronimo Pellegrini,
106       Matjaž Jeran, Ulrich Pegelow, Aurélien PIERRE, EdgarLux, Josep V.
107       Moragues, Marko Vertainen, Milan Knížek, Novy Sawai, Ragnar Wisløff,
108       Tomasz Golinski.
109
110       * contributors (at least 4 commits): Aurélien PIERRE, rawfiner,
111       edgardoh, Dan Torop, Matthieu Moy, Ger Siemerink, Michel Leblond, Heiko
112       Bauke, Maurizio Paglia, Andreas Schneider, Nilvus, Rikard Öxler, Timur
113       I. Davletshin, mepi0011, Benoit Brummer, Philippe Weyland, grand-piano,
114       luzpaz, Mario Lueder, Robert Bridge.
115
116       * RawSpeed contributors (at least 1 commit): Roman Lebedev Robert
117       Bridge bobobo1618 luz.paz Bastian Bechtold Pascal de Bruijn dllu
118       hanno@schwalm-bremen.de junkyardsparkle
119
120       And all those of you that made previous releases possible
121
122       This man page was written by Richard Levitte <richard@levitte.org>.
123       Additions were made by Tobias Ellinghaus <me@houz.org>.
124

126       Copyright (C) 2009-2017 by Authors.
127
128       darktable is free software; you can redistribute it and/or modify it
129       under the terms of the GPL v3 or (at your option) any later version.
130
131
132
133darktable 2.3                     2017-01-20                  DARKTABLE-CLI(1)
Impressum