Utilisation de scripts Lua
Table des matières
#Présentation
Darktable peut exécuter des scripts écrits en Lua pour réaliser une vaste gamme d’actions. Par exemple, il peut appeler des applications externes (après l’exportation d’une image, par exemple), créer des raccourcis clavier permettant d’effectuer plusieurs actions en une seule frappe, ou encore compiler des modules utilitaires complets.
Darktable est fourni avec plusieurs Scripts inclus. Le module utilitaire Scripts disponible dans la table lumineuse est le principal outil de gestion. Avant la version 5.6 de Darktable, il était nécessaire d’installer les scripts au préalable.
La documentation complète sur la programmation Lua dans Darktable est disponible dans la documentation Lua de darktable. Pour une introduction détaillée au langage Lua, consultez le manuel de référence Lua.
#Activation de scripts
Darktable (à partir de la version 5.6) est livré avec plusieurs scripts intégrés et fournis par des contributeurs pour effectuer diverses actions.
Pour utiliser un script fourni, vous devez d’abord l’activer. Dans cet exemple, nous allons activer le script rename-images qui rajoutera un module utilitaire dans la Table lumineuse.
-
Assurez-vous que les scripts sont activés dans Préférences > lua.
-
Identifiez dans quel dossier se trouve le script que vous souhaitez activer. Un aperçu de tous les scripts est disponible dans la Documentation Lua de Darktable. Dans notre exemple, rename-images est contenu dans le dossier contributed.
-
Trouvez le module Scripts dans le coin inférieur gauche de la vue table lumineuse et développez-le.
-
Sélectionnez l’action : « Démarrer/arrêter les scripts » dans la liste déroulante.
-
Sous Scripts, sélectionnez le dossier approprié dans le menu déroulant (dans notre exemple contributed).
-
Trouvez le script que vous souhaitez activer en utilisant les flèches pour parcourir les pages. Dans notre exemple, rename-images se trouve (au moment de la rédaction de cet article) sur la dernière page.
-
Cliquez sur l’icône de démarrer/arrêter grisée à gauche du nom du script pour le démarrer. L’icône doit devenir blanche et l’interface utilisateur du script (si elle en possède une) apparaîtra dans un panneau dans la vue appropriée. Dans cet exemple, un module utilitaire supplémentaire rename images apparaîtra dans le panneau de droite de la Table lumineuse.
#using custom scripts
Si vous souhaitez utiliser des scripts personnalisés, il est recommandé de les placer dans le répertoire de configuration dans lua/<nom>/. Remplacez <nom> par une chaîne de votre choix, par exemple utilisateur. Darktable chargera ces dossiers et proposera les scripts inclus à activer en sélectionnant le dossier correspondant dans le module scripts. De plus amples informations sur la façon dont Darktable charge les scripts sont disponibles dans le guide du programmeur.
#installing and updating scripts
Valable uniquement pour les versions de darktable antérieures à la version 5.6, dans lesquelles les scripts n’étaient pas intégrés et devaient être installés en suivant les instructions ci-dessous.
#download and install
Une collection de scripts est disponible dans le référentiel lua-scripts. Cela inclut également le gestionnaire de scripts, qui facilite l’activation ou la désactivation de scripts individuels à partir de l’interface graphique.
darktable should be started at least once to set up its directories. The config directories for most installation types are listed on the configuration directory page.
Pour la plupart des types d’installation (paquet Linux, AppImage, Flatpak, macOS et Windows), les scripts Lua peuvent être installés depuis darktable. Assurez-vous d’abord que Git est installé sur votre système ; si ce n’est pas le cas, utilisez le gestionnaire de paquets pour l’installer. Ensuite, dans la vue « table lumineuse », développez le module d’installation des scripts Lua situé dans le coin inférieur gauche, assurez-vous que l’option Sélectionner l’action : installer les scripts est cochée, puis cliquez sur « Exécuter ». Redémarrez darktable pour que le module des scripts apparaisse dans le coin inférieur gauche.
Certaines plateformes nécessitent des étapes supplémentaires ou alternatives :
Paquets Snap Linux
L’installation via l’interface graphique de darktable est actuellement défaillante ; vous devrez donc procéder comme suit : téléchargez les scripts Lua à l’aide de Git, puis créez le fichier luarc pour permettre à darktable de charger le gestionnaire de scripts. Fermez darktable, ouvrez un terminal et :
cd ~/snap/darktable/current
git clone https://github.com/darktable-org/lua-scripts.git lua
echo 'require "tools/script_manager"' >> luarc
Redémarrez Darktable deux fois et le module scripts devrait apparaître dans le coin inférieur gauche.
macOS
Alternatively you could use the console:
cd ~/.config/darktable/
git clone https://github.com/darktable-org/lua-scripts.git lua
Windows
Git can be obtained from git for windows, or using Windows package manager winget inside a command prompt with winget install git.git. If you use the gitforwindows.org distribution, install the Git Bash Shell also as it will aid in debugging the scripts if necessary.
#updating
Pour mettre à jour le référentiel de scripts, utilisez l’interface graphique du module de scripts ou ouvrez un terminal ou une invite de commande et exécutez les commandes suivantes :
Snap
cd ~/snap/darktable/current/lua
git pull
Flatpak
cd ~/.var/app/org.darktable.Darktable/config/darktable/lua
git pull
Linux et MacOS
cd ~/.config/darktable/lua/
git pull
Windows
cd %LOCALAPPDATA%\darktable\lua
git pull