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  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.  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
	   export.  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).
	   Defaults 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
	   appended 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
	   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: Pascal Obry Hanno Schwalm Victor Forsiuk Ralf Brown Mario
       Zimmermann Diederik ter Rahe

       *  Translators:	Pascal	Obry  EdgarLux	Bthory Pter Jan	 mucr Jeronimo
       Pellegrini  Johan  Schiff  Marko	  Vertainen   Martin   Straeten	  Paul
       Kocialkowski Wojciech Nagrodzki

       * Sub-module rawspeed contributors (at least 1 commit): Milo Komarevi

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

       * Sub-module lua-scripts	contributors (at least 1 commit):

       And all those of	you that made previous releases	possible

       This  man  page	was  written by	Richard	Levitte	<richard@levitte.org>.
       Additions 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+14.3.quarterly>

home | help