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|false|true>
17           --upscale <0|1|false|true>
18           --style <style name>
19           --style-overwrite
20           --apply-custom-presets <0|1|false|true>
21           --verbose
22           --help
23           --version
24

DESCRIPTION

26       darktable is a digital photography workflow application for Linux, Mac
27       OS X and several other Unices.  It's described further in darktable(1).
28
29       darktable-cli is a command line variant to be used to export images
30       given the raw file and the accompanying xmp file.
31

OPTIONS

33       The user needs to supply an input filename and an output filename.  All
34       other parameters are optional.
35
36       <input file>
37           The name of the input file to export.
38
39       <xmp file>
40           The optional name of an XMP sidecar file containing the history
41           stack data to be applied during export.  If this option is not
42           given darktable will search for an XMP file that belongs to the
43           given input file.
44
45       <output file>
46           The name of the output file.  darktable derives the export file
47           format from the file extension.  You can also use all the variables
48           available in darktable's export module in the output filename.
49
50       --width <max width>
51           This optional parameter allows one to limit the width of the
52           exported image to that number of pixels.
53
54       --height <max height>
55           This optional parameter allows one to limit the height of the
56           exported image to that number of pixels.
57
58       --bpp <bpp>
59           An optional parameter to define the bit depth of the exported
60           image; allowed values depend on the file format.  Currently this
61           option is not yet functional.  If you need to define the bit depth
62           you need to use the following workaround:
63
64               --core --conf plugins/imageio/format/<FORMAT>/bpp=<VALUE>
65
66           where FORMAT is the name of the selected output format, for example
67           png.
68
69       --hq <0|1|true|false>
70           A flag that defines whether to use high quality resampling during
71           export.  Defaults to true.
72
73       --upscale <0|1|true|false>
74           A flag that defines whether to allow upscaling during export.
75           Defaults to false.
76
77       --style <style name>
78           Specify the name of a style to be applied during export.  If a
79           style is specified, the path to the darktable configuration
80           directory must also be specified (i.e. --core --configdir
81           ~/.config/darktable).  Defaults to no style specified.
82
83       --style-overwrite
84           The specified style overwrites the history stack instead of being
85           appended to it.
86
87       --apply-custom-presets
88           With this option you can decide if darktable loads its set of
89           default parameters from data.db and applies them. Otherwise the
90           defaults that ship with darktable are used.
91
92       --verbose
93           Enables verbose output.
94
95       --core <darktable options>
96           All command line parameters following --core are passed to the
97           darktable core and handled as standard parameters.  See
98           darktable(1) for a detailed description of the options.
99

SEE ALSO

101       darktable(1)
102

AUTHORS

104       The principal developer of darktable is Johannes Hanika.  The
105       (hopefully) complete list of contributors to the project is:
106
107       * developers: Pascal Obry Aldric Renaudin Ulrich Pegelow parafin Roman
108       Lebedev Tobias Ellinghaus
109
110       * translators: Pascal Obry EdgarLux Ulrich Pegelow igmerti
111
112       * contributors (at least 4 commits): Philippe Weyland Dan Torop
113       rawfiner Hubert Kowalski Aurélien PIERRE Heiko Bauke hanno@schwalm-
114       bremen.de Diederik ter Rahe U-DESKTOP-HQME86Jmarco Bill Ferguson
115       Nicolas Auffray Chris.Elston Mark-64 Sam Smith
116
117       * Sub-module rawspeed contributors (at least 1 commit): Roman Lebedev
118       David-Tillmann Schaefer Martin Straeten hanno@schwalm-bremen.de
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-2019 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 3.0                     2019-11-27                  DARKTABLE-CLI(1)
Impressum