README

Author: Stefan Klinger (www.stefan-klinger.de)
License: GNU General Public License Version 3


Synopsis
--------

A collection of experimental scripts and examples.

  * `scrubMetadataOnExport.lua`

    This script extends darktables "export selected" module with a
    target storage option "scrub metadata".  This serves as an example
    of how to automatically run external programs on exported images.
    You should adapt it to your own use case.

  * `myExportProcess.lua`

    A slightly more elaborate version of the above.  That's what I
    actually use.

  * `applyStyleOnImport.lua`

    Registers one style which is automatically applied on all new
    imports.


Installation
------------

    $ dtConfigDir="${HOME}/.config/darktable"
    $ luaScripts="${dtConfigDir}/lua"

Copy, git-clone or symlink this directory *into* `$luaScripts`.  You
may change the name of this directory from `dtscripts` to something
else in order to omit conflicts, see Note below.

Example:  From the directory of this README

    $ ln -sT "$(realpath .)" "${luaScripts}/dtscripts"

Then require the desired scripts from `luarc`.  The result might look
like this:

    $ cat "${dtConfigDir}/luarc"
    require('dtscripts/scrubMetadataOnExport')

Note: If you've named the symlink `${luaScripts}/foobar` instead,
you'd have to `require('foobar/scrubMetadataOnExport')`.