← 返回命令列表

Linux command

darktable-cli 命令

文本

复制后可按需替换文件名、目录或参数。

常用示例

Export a RAW file to JPEG

darktable-cli [input.raw] [output.jpg]

Export with specific XMP sidecar

darktable-cli [input.raw] [preset.xmp] [output.jpg]

Export as 16-bit TIFF

darktable-cli [input.raw] [output.tiff] --bpp 16

Export with specific dimensions

darktable-cli [input.raw] [output.jpg] --width [1920] --height [1080]

Export all RAWs in directory

for f in *.raw; do darktable-cli "$f" "${f%.raw}.jpg"; done

Apply style during export

darktable-cli [input.raw] [output.jpg] --style "[style_name]"

说明

darktable-cli is the command-line interface for darktable, enabling batch processing of RAW photographs without the graphical interface. It applies darktable's non-destructive edits stored in XMP sidecar files to produce final images. The tool uses the same processing engine as the GUI application, ensuring identical results. If an XMP file exists alongside the input (same name with .xmp extension), its edits are automatically applied. Explicit XMP files can also be specified. Common uses include batch export of edited photos, automated processing pipelines, server-side image processing, and generating different output sizes from the same RAW file.

参数

--width _pixels_
Maximum output width.
--height _pixels_
Maximum output height.
--bpp _bits_
Bits per pixel (8, 16, 32).
--hq _true_|_false_
High quality resampling.
--upscale _true_|_false_
Allow upscaling.
--style _name_
Apply named darktable style.
--style-overwrite
Overwrite existing history with style.
--out-ext _ext_
Output format extension (jpg, tif, png, etc.).
--core
Pass options to darktable core.
--verbose
Enable verbose output.

FAQ

What is the darktable-cli command used for?

darktable-cli is the command-line interface for darktable, enabling batch processing of RAW photographs without the graphical interface. It applies darktable's non-destructive edits stored in XMP sidecar files to produce final images. The tool uses the same processing engine as the GUI application, ensuring identical results. If an XMP file exists alongside the input (same name with .xmp extension), its edits are automatically applied. Explicit XMP files can also be specified. Common uses include batch export of edited photos, automated processing pipelines, server-side image processing, and generating different output sizes from the same RAW file.

How do I run a basic darktable-cli example?

Run `darktable-cli [input.raw] [output.jpg]` in a terminal, then adjust file names, paths, flags, or remote targets for your system.

What does --width _pixels_ do in darktable-cli?

Maximum output width.