darktable user manual

darktable’s scripts (before version 5.6)

Table des matières

Prior to darktable version 5.6 scripts were not bundled with darktable and must be installed using the following instructions.

#Télécharger et installer

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. La documentation de ces scripts Lua est incluse dans les docs lua.

Pour utiliser ces scripts existants dans les versions antérieures à 5.6, ils doivent être installés dans Darktable. Cela peut dans la plupart des cas être fait dans l’interface graphique de Darktable, mais cela dépend de votre système d’exploitation et de la méthode d’installation choisie.

Dans tous les cas, Darktable doit être démarré au moins une fois pour configurer ses répertoires. Les répertoires de configuration pour la plupart des types d’installation sont répertoriés sur la page Répertoire de configuration.

La documentation pour les scripts de Darktable est disponible dans la Documentation Lua.

Paquet Linux, AppImage et Flatpak

Les scripts Lua peuvent être installés à l’aide de l’interface graphique de Darktable. Assurez-vous que git est installé sur votre système. Si ce n’est pas le cas, utilisez le gestionnaire de paquets pour l’installer. Dans la vue table lumineuse, développez le module d’installation des scripts Lua dans le coin inférieur gauche. Assurez-vous que dans action: install scripts est sélectionné, puis cliquez sur exécuter. Redémarrez Darktable une fois pour que le module scripts apparaisse dans le coin inférieur gauche.

Paquets Snap Linux

L’installation via l’interface graphique de Darktable est actuellement interrompue, vous devrez donc adopter l’approche suivante :

Assurez-vous que git est installé sur votre système. Si ce n’est pas le cas, utilisez le gestionnaire de paquets pour l’installer. Vous devrez télécharger les scripts Lua à l’aide de git, puis créer le luarc pour permettre à Darktable de charger le gestionnaire de scripts. Quittez 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

Les scripts Lua peuvent être installés en utilisant l’interface graphique de Darktable. Dans la vue table lumineuse, développez le module d’installation des scripts Lua dans le coin inférieur gauche. Assurez-vous que pour action: install scripts est sélectionné, puis cliquez sur exécuter. Redémarrez Darktable une fois pour que le module scripts apparaisse dans le coin inférieur gauche.

Alternativement, vous pouvez utiliser la console. Assurez-vous que git est installé sur votre système. Si ce n’est pas le cas, utilisez le gestionnaire de paquets pour l’installer. Ouvrez ensuite un terminal et :

cd ~/.config/darktable/
git clone https://github.com/darktable-org/lua-scripts.git lua

Windows

Assurez-vous que git est installé sur votre système. Git peut être obtenu à partir de git pour Windows, ou en utilisant le gestionnaire de paquets Windows winget dans une invite de commande avec winget install git.git. Si vous utilisez la distribution gitforwindows.org, installez également le Git Bash Shell car il aidera à déboguer les scripts si nécessaire.

Les scripts Lua peuvent désormais être installés en utilisant l’interface graphique de Darktable. Dans la vue table lumineuse, développez le module d’installation des scripts Lua dans le coin inférieur gauche. Assurez-vous que action: install scripts est sélectionné, puis cliquez sur exécuter. Redémarrez Darktable une fois pour que le module scripts apparaisse dans le coin inférieur gauche.

Mise à jour

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

Translations