Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
DARKTABLE-CLI(1)		    darktable			DARKTABLE-CLI(1)

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|false|true>
	 --upscale <0|1|false|true>
	 --export_masks <0|1|false|true>
	 --style <style name>
	 --style-overwrite
	 --apply-custom-presets <0|1|false|true>
	 --verbose
	 --help
	 --version

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 dark-
	 table 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.  You can also use all the variables available
	 in darktable's export module in the output filename.

     --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 ex-
	 port.	Defaults to true.

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

     --export_masks <0|1|true|false>
	 A flag that defines whether masks used in the image will be stored as
	 layers in the exported image (provided the format supports it).  De-
	 faults to false.

     --style <style name>
	 Specify the name of a style to be applied during export.  If a style is
	 specified, the path to the darktable configuration directory must also
	 be specified (i.e. --core --configdir ~/.config/darktable).  Defaults
	 to no style specified.

     --style-overwrite
	 The specified style overwrites the history stack instead of being ap-
	 pended to it.

     --apply-custom-presets
	 With this option you can decide if darktable loads its set of default
	 parameters from data.db and applies them. Otherwise the defaults that
	 ship with darktable are used.

	 Set this flag to false in order to run multiple instances.

     --verbose
	 Enables verbose output.

     --core <darktable options>
	 All command line parameters following --core are passed to the dark-
	 table 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: Pascal Obry Victor Forsiuk Hanno Schwalm Mario Zimmermann
     Ralf Brown Roman Lebedev Kofa Diederik ter Rahe Jeronimo Pellegrini Martin
     Straeten Bill Ferguson MiloA! KomarAeviA Vladimir Tyrtov EdgarLux Marko
     Vertainen MatjaA3/4 Jeran Jonas SchAxfer Hwanyong Lee bajdero

     * Translators: Victor Forsiuk Pascal Obry Jeronimo Pellegrini Martin
     Straeten EdgarLux Marko Vertainen MatjaA_/4 Jeran Hwanyong Lee bajdero Be-
     smir Godolja Elia Devito Kang-Wei Hsu Dh Dh1/2Dh<degree>
     DhcNDh1/2Dh^3NNDh?Dh<degree>Dh<micro>Dh^2Dh<degree> BA!thory PA(C)ter Jan
     A mucr Johan Schiff Reinder Mulder Ryo Shinozaki Tianhao Chai

     * Sub-module rawspeed contributors (at least 1 commit): MiloA! KomarAeviA
     Roman Lebedev Jonas SchAxfer

     * Sub-module integration contributors (at least 1 commit): Pascal Obry
     ralfbrown

     * Sub-module lua-scripts contributors (at least 1 commit): wpferguson Bill
     Ferguson Michael Reiger Tasos Bakogiannis deekayhd BalA!zs Dura-KovA!cs
     sjjh

     And all those of you that made previous releases possible

     This man page was written by Richard Levitte <richard@levitte.org>.  Addi-
     tions were made by Tobias Ellinghaus <me@houz.org>.

COPYRIGHT AND LICENSE
     Copyright (C) 2009-2019 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 3.0			   2019-11-27			DARKTABLE-CLI(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=darktable-cli&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help