darktable user manual

Grundsätzliche Prinzipien

Table of Contents

Skripte können Aufrufe sein, die Aktionen ausführen in diversen darktable Fällen. Dieser Aufruf-Mechanismus ist die Hauptmethode um Lua Aktionen auszulösen.

Der zentrale Steuerungsmechanismus für Lua-Skripte ist der Skript-Manager, der das Hilfsmodul scripts in Lighttable startet und die mit Darktable mitgelieferten Skripte lädt.

Lua Skripte können in den Optionen im Abschnitt darktable-Voreinstellungen>Lua-Optionen deaktiviert werden .

#Wie Darktable Skripte (und den Skript-Manager) lädt

darktable unterscheidet zwischen zwei Arten von Speicherorten: Dateien, die als Lua-Code ausgeführt werden, und Verzeichnisse, die nach Skripten durchsucht werden:

  • luarc-files executed at startup:

    • $DARKTABLE/share/darktable/luarc: Wird von darktable selbst ausgeführt. Dies ist der Einstiegspunkt, über den der (mitgelieferte) Skript-Manager gestartet wird. Er dient ausschließlich internen Zwecken und sollte nicht bearbeitet werden. $DARKTABLE ist das Installationsverzeichnis des Programms.

    • [Konfigurationsverzeichnis]/luarc: Falls vorhanden – dies ist eine Möglichkeit, eigene Skripte aufzurufen (siehe unten).

  • Nach .lua-Skripten durchsucht (die dann im Skript-Modul erscheinen):

    • $DARKTABLE/share/darktable/lua-scripts/: Die mit darktable mitgelieferten Skripte.

    • [Konfigurationsverzeichnis]/lua/[Ordner]: Deine eigenen Skripte (siehe unten).

Das Konfigurations-Verzeichnis ist betriebssystem-spezifisch

So kannst du deine eigenen Skripte wie folgt hinzufügen:

  • Lass sie vom Skript-Modul erkennen (empfohlen)
    • Speichere dein Skript z. B. unter [Konfigurationsverzeichnis]/lua/user/myscript.lua
    • Aktiviere sie im Skript-Modul, indem du den entsprechenden Ordner (in diesem Beispiel „user“) auswählst und auf die Ein-/Aus-Schaltfläche neben dem entsprechenden Skript klickst.
    • Hinweis: Damit das Skript-Modul Skripte erkennen kann, müssen diese sich in einem Unterordner von [Konfigurationsverzeichnis]/lua befinden.
  • Verwende luarc (wird beim Start automatisch ausgeführt)
    • Oder schreibe den Code direkt in [Konfigurationsverzeichnis]/luarc. Das funktioniert zwar, ist aber für mehr als ein paar Zeilen nicht praktikabel.
    • Oder speicher den Code in einer eigenen Datei und füge ihn über luarc mit require ein: Ein Skript, das sich beispielsweise in [Konfigurationsverzeichnis]/lua/userscript.lua befindet, könnte durch Hinzufügen von require „userscript“ geladen werden (beachte, dass die Endung .lua hier weggelassen wird).

#Ein Hinweis zur Installation von Lua-Skripten aus früheren Darktable-Versionen

To remain compatible with scripts installed before darktable 5.6, require looks for a script manager in your configuration directory before loading the bundled one: if [configuration-directory]/lua/tools/script_manager.lua is present (for example from a manual pre-5.6 installation), that script manager is run instead of the bundled one.

Translations