darktable-cli

L’exécutable darktable-cli lance la variante en ligne de commande de l’interface de darktable qui permet l’exportation d’images.

Cette variante n’ouvre aucun affichage – elle travaille en mode console pur sans lancer d’interface graphique. Ce mode est particulièrement utile pour les serveurs exécutant des tâches en arrière-plan.

darktable-cli peut être appelé avec les paramètres suivants de la ligne de commande :

darktable-cli [<input file or folder>]
              [<xmp file>]
              <output file or folder>
              [--width <max width>]
              [--height <max height>]
              [--hq <0|1|true|false>]
              [--upscale <0|1|true|false>]
              [--style <style name>]
              [--style-overwrite]
              [--apply-custom-presets <0|1|false|true>]
              [--out-ext <extension>]
              [--import <file or dir>]
              [--icc-type <type>]
              [--icc-file <file>]
              [--icc-intent <intent>]
              [--verbose]
              [--help [option]]
              [--core <darktable options>]

L’utilisateur doit fournir un nom de fichier d’entrée et un nom de fichier de sortie. Tous les autres paramètres sont optionnels.

<input file or folder>
Le nom du fichier en entrée ou du répertoire (contenant des images) à exporter. Si vous souhaitez développer plusieurs images ou plusieurs répertoires utilisez plutôt l’option --import.
<xmp file>
Nom optionnel d’un fichier lié XMP qui contient les données de l’historique de développement qui sera appliqué lors de l’exportation. Si cette option n’est pas donnée, darktable recherchera un fichier XMP appartenant au(x) fichier(s) d’entrée indiqué(s).
<output file or folder>
Le nom du fichier de sortie ou le répertoire de destination. Le format du fichier de sortie est dérivé de son extension ou de l’option --out-ext . Vous pouvez aussi utiliser des variables de substitution dans le nom du fichier de sortie. Pour des raisons évidentes ceci est obligatoire si vous utilisez le programme pour un répertoire contenant de nombreuses images. Si vous spécifiez le répertoire de sortie, il est recommandé de spécifier également le format de fichier avec --out-ext.
--width <max width>
Ce paramètre permet de limiter la largeur de l’image exportée au nombre de pixels indiqué.
--height <max height>
Ce paramètre permet de limiter la hauteur de l’image exportée au nombre de pixels indiqué.
--hq <0|1|true|false>
Définit s’il faut utiliser un ré-échantillonnage de haute qualité lors de l’exportation (voir le module exporter sélection pour plus de détails). Vrai par défaut.
--upscale <0|1|true|false>
Indicateur définissant s’il faut utiliser un ré-échantillonnage de haute qualité lors de l’exportation Faux par défaut.
--style <style name>
Spécifiez le nom d’un style à appliquer lors de l’exportation. Si un style est spécifié, le chemin d’accès au répertoire de configuration darktable doit également être spécifié (c’est-à-dire --core --configdir ~/.config/darktable). Par défaut, aucun style n’est spécifié.
--style-overwrite
Le style spécifié remplace l’historique au lieu d’y être ajouté.
--apply-custom-presets <0|1|false|true>
S’il faut charger data.db qui contient des préréglages et des styles. Désactiver cette option vous permet de lancer plusieurs instances de darktable-cli au prix de ne pas pouvoir utiliser l’option --style. La valeur par défaut est vrai.
--out-ext <extension>
Set the export file format to use derived from the extension (jpg, tif, jxl). If specified takes precedence over <output file>. By default this is extracted from <output file>. Defaults to jpg if <output folder> is specified. Note: the extension used in the export filename is predetermined by the export format and not adjustable.
--import <file or dir>
Spécifiez le fichier ou le répertoire d’entrée, peut être utilisé plusieurs fois. Cette option ne peut pas être combinée avec <input file or folder>.
--icc-type <type>
Spécifiez le type de profil ICC, ce qui revient à spécifier le “profil de sortie” dans le module profil de couleur de sortie. La valeur par défaut est “image spécifiée”. Utilisez--help icc-type pour obtenir une liste des types pris en charge. Voir profil couleur de sortie pour une description plus détaillée des options disponibles.
--icc-file <file>
Spécifiez le nom de fichier du profil ICC. Par défaut, un nom de fichier vide.
--icc-intent <intent>
Spécifiez l’intention de rendu. Utilisez --help icc-intent pour obtenir une liste des modes de rendu pris en charge. Voir intention de rendu pour une description plus détaillée des options disponibles.
--verbose
Activer la sortie verbeuse.
--help [option]
Donne les paramètres d’usage et quitte. Si option est spécifié, donne en plus les paramètres de l’option donnée.
--core <darktable options>
Tous les paramètres de la ligne de commande suivant --core sont passés au noyau de darktable et manipulés comme des paramètres standards. Voir la section Exécutable darktable pour une description détaillée.

🔗options d’exportation

Les options d’exportation de darktable sont définies en tant qu’éléments de configuration, définis depuis le module exportation. Comme décrit ci-dessous, il existe deux manières de modifier cette configuration lors de l’utilisation de darktable-cli.

🔗utiliser le module exportation

La commande darktable-cli utilisera la dernière configuration de format utilisée dans le module exportation, lorsqu’elle est exécutée en mode interactif (gui). Vous pouvez donc définir manuellement les options de format souhaitées dans l’interface graphique de darktable, puis exécuter darktable-cli pour exporter vos fichiers.

🔗passer des options sur la ligne de commande

Vous pouvez définir n’importe quelle option de configuration de format d’exportation à l’aide de la syntaxe suivante :

    --core --conf plugins/imageio/format/<FORMAT>/<OPTION>=<VALEUR>

<FORMAT> est le nom du format de sortie souhaité et <OPTION> est n’importe quelle option de configuration pour ce format.

Une option définie de cette manière ne sera pas stockée de manière permanente mais sera utilisée uniquement pour cette exécution de darktable-cli.

Les sections suivantes décrivent les options/valeurs de configuration disponibles pour chaque format d’exportation :

🔗jpeg

qualité
La qualité de compression (5 - 100)

🔗j2k (JPEG2000)

format
Le format de la sortie
  • 0 : j2k
  • 1 : jp2
qualité
La qualité de compression (5 - 100)
préréglage
Le mode DCP
  • 0 : Cinema2K, 24 images par seconde
  • 1 : Cinema2K, 48 images par seconde
  • 2 : Cinéma4K, 24 images par seconde

🔗exr (OpenEXR)

bpp
La profondeur de bits (16 ou 32)
dégradé
Le type de compression
  • ‘0’  : non compressé
  • 1  : RLE
  • ‘2’  : ZIPS
  • ‘3’ : ZIP
  • 4 : PIZ
  • ‘5’ : PXR24
  • ‘6’ : B44
  • 7 : DWAA
  • 8 : DWAB

🔗PDF

titre
Le titre du PDF (n’importe quel caractère)
taille papier
La taille du PDF (a4, a3, letter, legal)
orientation de la page
L’orientation papier du PDF
  • ‘0’ : portrait
  • ‘1’ : paysage
bords
L’espace vide autour du PDF ; format : taille (un nombre) + unité ; exemples : 10 mm, 1 pouce
dpi
La résolution en points par pouce à l’intérieur du PDF (1 - 5000)
retournement des images
S’il faut faire pivoter le PDF (0 ou 1)
profil icc intégré
Si un profil icc doit être intégré (0 ou 1)
bits
La profondeur de bits (‘8’ ou ‘16’)
compression
S’il faut compresser le PDF (0 ou 1)
mode de l'image
Le mode pour mettre les images dans le PDF
  • 0 : normal : juste mettre les images dans le PDF
  • 1’ : épreuve : les images sont remplacées par des boîtes
  • 2 : débogage : montre uniquement le contour des emplacements

🔗PFM

Aucune option fournie.

🔗PNG

bits
La profondeur de bits (‘8’ ou ‘16’)
compression
Le niveau de compression (0 - 9)

🔗PPM

Aucune option fournie.

🔗TIFF

bits
La profondeur de bits (8, 16, 32)
dégradé
Son type
  • 0: non compressé
  • 1: deflate
  • 2: deflate avec prédiction
compression
Le niveau de compression (0 - 9)
image n&b
Image N&B ou couleur
  • 0 : écrire les couleurs RVB
  • 1 : écrire en niveaux de gris

🔗WEBP

type de compression
Le type de compression
  • ‘0’ : avec perte
  • 1 : sans perte
qualité
La qualité de compression (5 - 100)
indice
La meilleure façon de gérer la compression
  • ‘0’ : par défaut
  • 1 : image : image numérique, comme un portrait, une photographie d’intérieur
  • 2 : photo : photographie en extérieur, avec éclairage naturel
  • 3 : graphique : image avec des couleurs uniformes (schémas, etc.)

🔗copier

Aucune option fournie.

🔗XCF

bits
La profondeur de bits (8, 16, 32)

🔗JXL

bpp
The bit depth (8, 10, 12, 16, 32)
pixel_type
Boolean whether the (16 bit) pixel type is unsigned integer or floating point
  • 0: unsigned integer
  • 1: floating point
quality
Integer (4-100): the quality of the image, roughly corresponding to JPEG quality (100 is lossless)
original
Boolean whether to encode using the original color profile or the internal XYB one
  • 0: internal
  • 1: original
effort
Integer between 1-9. Effort with which to encode output; higher is slower (default is 7)
tier
Integer between 0-4. Higher value favors decoding speed vs quality (default is 0)

translations