NAME

       darktable-cli - a command line darktable variant

SYNOPSIS

           darktable-cli IMG_1234.{RAW,...} [<xmp file>] <output file> [options] [--core <darktable options>]

       Options:

           --width <max width>
           --height <max height>
           --bpp <bpp>
           --hq <0|1|true|false>
           --upscale <0|1|true|false>
           --verbose

DESCRIPTION

       darktable is a digital photography workflow application for Linux, Mac OS X and several other Unices.
       It's described further in darktable(1).

       darktable-cli is a command line variant to be used to export images given the raw file and the
       accompanying xmp file.

OPTIONS

       The user needs to supply an input filename and an output filename.  All other parameters are optional.

       <input file>
           The name of the input file to export.

       <xmp file>
           The  optional  name  of  an  XMP  sidecar file containing the history stack data to be applied during
           export.  If this option is not given darktable will search for an XMP file that belongs to the  given
           input file.

       <output file>
           The name of the output file.  darktable derives the export file format from the file extension.

       --width <max width>
           This optional parameter allows one to limit the width of the exported image to that number of pixels.

       --height <max height>
           This  optional  parameter  allows  one  to  limit  the height of the exported image to that number of
           pixels.

       --bpp <bpp>
           An optional parameter to define the bit depth of the exported image; allowed  values  depend  on  the
           file  format.   Currently this option is not yet functional.  If you need to define the bit depth you
           need to use the following workaround:

               --core --conf plugins/imageio/format/<FORMAT>/bpp=<VALUE>

           where FORMAT is the name of the selected output format, for example png.

       --hq <0|1|true|false>
           A flag that defines whether to use high quality resampling during export.  Defaults to true.

       --upscale <0|1|true|false>
           A flag that defines whether to allow upscaling during export.  Defaults to false.

       --verbose
           Enables verbose output.

       --core <darktable options>
           All command line parameters following --core are passed to the darktable core and handled as standard
           parameters.  See darktable(1) for a detailed description of the options.

SEE ALSO

       darktable(1)

AUTHORS

       The principal developer of darktable is Johannes Hanika.  The (hopefully) complete list  of  contributors
       to the project is:

       * developers: Henrik Andersson, Johannes Hanika, Tobias Ellinghaus, Ulrich Pegelow.

       * ubuntu packaging, color management, video tutorials: Pascal de Bruijn.

       * opencl pipeline, usermanual: Ulrich Pegelow.

       * networking, battle testing, translation expert: Alexandre Prokoudine.

       *  translation:  a3novy,  Alexandre  Prokoudine,  Anocha  Yimsiriwattana,  Artur  de Sousa Rocha, Daniele
       Giorgis, Dimitrios Psychogios, Ger Siemerink, Guilherme Brondani Torri,  Henrik  Andersson,  José  Carlos
       Casimiro,  Josep  Puigdemont,  María  Leandro,  Mauro  Bartoccelli, Michał Prędotka, Mikko Ruohola, Milan
       Knížek, Olivier Tribout, Pascal Obry, Richard Levitte,  Roberto  Quintero,  Sebastien  Delcoigne,  Thomas
       Costis, Thomas Pryds, Tobias Ellinghaus, Victor Lamoine.

       *  contributors: Aldric Renaudin, Alexandre Prokoudine, Alexey Dokuchaev, Ammon Riley, Anton Keks, Antony
       Dovgal, Ari Makela, Benjamin Cahill, Brian Teague, Bruce Guenter, Cherrot  Luo,  Chris  Mason,  Christian
       Tellefsen,  David  Morel,  Denis  Cheremisov,  Dennis  Gnad,  Diego Segura, Dimitrios Psychogios, Eckhart
       Pedersen, Edouard Gomez, Edward Herr,  František  Šidák,  Gaspard  Jankowiak,  Ger  Siemerink,  Gianluigi
       Calcaterra,  Guilherme  Brondani  Torri,  Ivan  Tarozzi,  James C. McPherson, Jan Kundrát, Jean-Sébastien
       Pédron, Jérémy Rosen, Jesper Pedersen, Joao Trindade, Jon Leighton, Jose Carlos Garcia Sogo, Josef Wells,
       Julian J. M, Mattias Eriksson, Michal Babej, Michał Prędotka, Moritz Lipp,  Olivier  Tribout,  Pascal  de
       Bruijn, Pascal Obry, parafin, Petr Styblo, Pierre Le Magourou, Richard Levitte, Richard Tollerton, Robert
       Bieber, Roland Riegel, Roman Lebedev, Rostyslav Pidgornyi, Sergey Pavlov, Simon Harhues, Simon Spannagel,
       Stuart  Henderson,  Terry Jeffress, Tim Harder, Togan Muftuoglu, Tom Vanderpoel, Ulrich Pegelow, Wolfgang
       Goetz, Wolfgang Kuehnel, Yari Adan, hal, jan, maigl, tuxuser.  And all those of you  that  made  previous
       releases possible.

       This  man  page  was  written  by  Richard  Levitte <richard@levittr.org>.  Additions were made by Tobias
       Ellinghaus <me@houz.org>.

COPYRIGHT AND LICENSE

       Copyright (C) 2009-2015 by Authors.

       darktable is free software; you can redistribute it and/or modify it under the terms of the GPL v3 or (at
       your option) any later version.

darktable 2.0                                      2015-11-08                                   DARKTABLE-CLI(1)