darktable

The darktable binary starts darktable with its GUI and full functionality. This is the standard way to use darktable. The command to run the binary depends on your OS.

The following command line parameters are available:

darktable [-d {all,act_on,ai,cache,camctl,camsupport,common,control,
               dev,expose,fswatch,imageio,input,ioporder,lighttable,lua,
               masks,memory,nan,opencl,params,perf,pipe,print,pwstorage,
               signal,sql,tiling,undo,verbose}]
          [--d-signal <signal>]
          [--d-signal-act <all,raise,connect,disconnect,print-trace>]
          [--disable-pipecache]
          [<input file>|<image folder>]
          [--version]
          [--disable-opencl]
          [--configdir <user config directory>]
          [--library <library file>]
          [--datadir <data directory>]
          [--moduledir <module directory>]
          [--tmpdir <tmp directory>]
          [--cachedir <user cache directory>]
          [--localedir <locale directory>]
          [--luacmd <lua command>]
          [--noiseprofiles <noiseprofiles json file>]
          [--conf <key>=<value>]
          [-t <num openmp threads>]

Tous les paramètres sont optionnels. Dans la plupart des cas, les utilisateurs lanceront darktable sans paramètres supplémentaires. Dans ce cas, darktable utilise les valeurs par défaut adaptées.

-d {all,act_on,ai,cache,camctl,camsupport,common,control,dev,expose,fswatch,imageio,input,ioporder,lighttable,lua,masks,memory,nan,opencl,params,perf,pipe,print,pwstorage,signal,sql,tiling,undo,verbose}
Enable debug output to the terminal. There are several subsystems of darktable and each of them can be debugged separately. You can use this option multiple times if you want to debug more than one subsystem (e.g. darktable -d opencl -d camctl) or debug all of them at once (with -d all). The -d common switch is provided to give information about most relevant subsystems while debugging darktable or if you want to provide a log for reporting a darktable issue. Some debug options (like -d opencl) can also provide more verbose output, which can be invoked with the additional option -d verbose. The verbose option must be explicitly provided, even when using -d all.
--d-signal <signal>
If -d signal or -d all is specified, specify the signal to debug using this option. Specify ALL to debug all signals or specify signal using its full name. Can be used multiple times.
--d-signal-act <all,raise,connect,disconnect,print-trace>
Si -d signal ou-d all est spécifié, spécifiez le signal à déboguer en utilisant cette option.

--disable-pipecache  : Désactive le cache du pixelpipe. Cette option n’autorise que deux lignes de cache par tube, et ne doit être utilisée qu’à des fins de débogage.

<input file>|<image folder>
Optionnellement vous pouvez indiquer le nom de fichier d’une image ou le nom d’un dossier contenant des fichiers d’images. Si un nom de fichier est donné darktable démarre en mode Chambre noire avec ce fichier ouvert. Si un nom de dossier est donné darktable démarre en mode Table lumineuse avec le contenu de ce dossier comme collection courante.
--version
Avec cette option darktable affiche son numéro de version, un avis de droits d’auteur, quelques autres informations utiles et ensuite s’arrête.
--disable-opencl
Cette option empêche darktable d’initialiser le sous-système OpenCL. Utilisez cette option dans le cas de plantage de darktable au démarrage en raison d’une implémentation défectueuse d’OpenCL.
--configdir <config directory>
Cette option définit le répertoire où darktable enregistre la configuration propre à l’utilisateur. L’emplacement par défaut est $HOME/.config/darktable/.
--library <library file>
Pour un accès rapide, darktable conserve les informations des images qu’il a traitées dans une base de données sqlite. Son nom par défaut est library.db et son emplacement est spécifié --configdir ou par défaut dans $HOME/.config/darktable. Utilisez ces options pour configurer un emplacement alternatif (si, par exemple, vous désirez expérimenter sans polluer votre library.db d’origine). Si le fichier de base de données n’existe pas, darktable va le créer pour vous. Vous pouvez aussi indiquer :memory: comme nom de fichier ; dans ce cas, la base de données résidera dans la mémoire système et toutes les modifications seront perdues à l’arrêt de darktable.

Chaque fois que darktable démarre, il verrouille la bibliothèque à l’utilisateur actuel. Il le fait en écrivant l’identifiant de processus actuel (PID) dans un fichier de verrouillage <fichier de bibliothèque>.lock à côté de la bibliothèque spécifiée. Si darktable trouve un fichier de verrouillage existant pour la bibliothèque, il se terminera immédiatement.

--datadir <data directory>
Cette option définit le répertoire où darktable recherche ses données d’exécution. L’emplacement par défaut dépend de votre installation. Des emplacements typiques sont/opt/darktable/share/darktable/ et /usr/share/darktable/.
--moduledir <module directory>
darktable a une structure modulaire et organise ses modules sous forme de bibliothèques partagées à charger lors de l’exécution. Avec cette option, vous indiquez à darktable où il doit les rechercher. L’emplacement par défaut dépend de votre installation. Des emplacements typiques sont /opt/darktable/lib64/darktable/ et /usr/lib64/darktable/.
--tmpdir <tmp directory>
Emplacement où darktable enregistre ses fichiers temporaires. Si cette option n’est pas fournie, darktable utilise la valeur par défaut du système.
--cachedir <cache directory>
darktable conserve un cache des miniatures des images pour une prévisualisation rapide et un cache des exécutables OpenCL pré-compilés pour un démarrage rapide. Par défaut, le cache est situé dans $HOME/.cache/darktable/. Il peut exister plusieurs caches de miniatures en parallèle, un pour chaque fichier de bibliothèque.
--localedir <locale directory>
Emplacement où darktable recherche ses chaînes de texte propres aux différentes langues. L’emplacement par défaut dépend de votre installation. Des emplacements typiques sont /opt/darktable/share/locale/ et /usr/share/locale/.
--luacmd <lua command>
Une chaîne contenant les commandes Lua à exécuter après l’initialisation de Lua. Ces commandes seront exécutées après votre fichier luarc.
Si Lua n’est pas compilé, cette option sera acceptée mais sera sans effet.
--noiseprofiles <noiseprofiles json file>
Le fichier json qui contient les profils de bruit spécifiques aux boîtiers. L’emplacement par défaut dépend de votre installation. Les emplacements typiques sont /opt/darktable/share/darktable/noiseprofile.json et /usr/share/darktable/noiseprofile.json.
--conf <key>=<value>
darktable prend en charge un riche ensemble de paramètres de configuration que l’utilisateur peut définir dans le fichier darktablerc, situé dans le dossier spécifié par --configdir ou par défaut dans $HOME/.config/darktable/darktablerc. Vous pouvez écraser de manière temporaire des paramètres particuliers depuis la ligne de commande à l’aide de cette option. Ces paramètres ne seront pas enregistrés dans darktablerc à la fin du programme.

-t <num openmp threads>  : nombre maximum de fils openmp à utiliser dans les sections parallèles openmp.

--dump-pfm MODULE_A,MODULE_B, --dump-pipe MODULE_A,MODULE_B, --dumpdir DIR  : Ces options sont fournies pour déboguer le pipeline de traitement interne de darktable. Par exemple, si on l’appelle avec --dump-pfm demosaic darktable videra l’entrée et la sortie du module demosaic sous forme de fichiers pfm. Par défaut, l’emplacement de ces fichiers est défini par le système d’exploitation – un dossier temporaire signalé dans le journal de sortie – mais vous pouvez aussi le définir explicitement via l’option --dumpdir.

translations