diff --git a/categories/index.html b/categories/index.html
index a1e5958..888d910 100644
--- a/categories/index.html
+++ b/categories/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/index.html b/index.html
index ce70e19..d6a24f4 100644
--- a/index.html
+++ b/index.html
@@ -412,6 +412,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/index.json b/index.json
index be632cd..e1e25eb 100644
--- a/index.json
+++ b/index.json
@@ -1 +1 @@
-[{"categories":null,"content":"This section documents types that are specific to darktable\u0026rsquo;s Lua API.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/overview/","tags":null,"title":"overview"},{"categories":null,"content":"enum\nThe export mode to use for PDF document\nValues:\n normal draft debug  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/_pdf_mode_t/","tags":null,"title":"_pdf_mode_t"},{"categories":null,"content":"🔗Name api_version.lua - show the Lua API version\n🔗Description darktable script to show the Lua API version in the preferences\n🔗Usage  start this script from script manager. darktable must be running in lua debug mode in a terminal to see the output.  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/api_version/","tags":null,"title":"api_version"},{"categories":null,"content":"🔗Name AutoGrouper.lua - automatically group images based on time\n🔗Description This plugin groups images based on the time they were shot. Images shot close together in time are grouped together. The interval of time to separate groups is configurable.\n🔗Usage Start the module using script manager.\nSet a gap amount, in seconds, which will be used to determine when images should no longer be added to a group. If an image is more then the specified amount of time from the last image in the group it will not be added. Images without timestamps in exif data will be ignored.\nThere are two buttons. One allows the grouping to be performed only on the currently selected images, the other button performs grouping on the entire active collection\n🔗Additional Software Required 🔗Limitations 🔗Author Kevin Ertel\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/autogrouper/","tags":null,"title":"AutoGrouper"},{"categories":null,"content":"🔗Name check_for_updates.lua - automatically check for updates\n🔗Description a simple script that will automatically look for newer releases on github and inform when there is something. it will only check on startup and only once a week.\n🔗Usage  install luasec and cjson for Lua 5.3 on your system. Luarocks is a good source for lua packages. start this script from script manager restart darktable  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/check_for_updates/","tags":null,"title":"check_for_updates"},{"categories":null,"content":"This subtable contains function and data to manipulate the darktable user interface with Lua. Most of these function won\u0026rsquo;t do anything if the GUI is not enabled (i.e you are using the command line version darktable-cli instead of darktable).\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/overview/","tags":null,"title":"darktable.gui overview"},{"categories":null,"content":"This table allows referencing all lib objects. lib objects are the graphical blocks within each view. To quickly figure out which lib is which, you can use the following code, which will make a given lib blink.\nlocal dt = require \u0026quot;darktable\u0026quot; local tested_module=\u0026quot;global_toolbox\u0026quot; dt.gui.libs[tested_module].visible=false dt.control.sleep(2000) while true do dt.gui.libs[tested_module].visible = not dt.gui.libs[tested_module].visible dt.control.sleep(2000) end ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/overview/","tags":null,"title":"darktable.gui.libs overview"},{"categories":null,"content":"The different views in darktable\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/overview/","tags":null,"title":"darktable.gui.views overview"},{"categories":null,"content":"🔗NAME dtutils.debug\n🔗SYNOPSIS debugging helpers used in developing darktable lua scripts\n🔗USAGE require \u0026quot;lib/dtutils.debug\u0026quot; 🔗DESCRIPTION dtutils.debug provides an interface to the darktable debugging routines.\n🔗RETURN VALUE dd - library - the darktable lua debugging helpers\n🔗FUNCTIONS 🔗dprint pass a variable to darktable.debug.dump and print the results to stdout\n🔗new_tracepoint create a function returning a tracepoint\n🔗terse_dump set darktable.debug.known to shorten all image dumps to a single line\n🔗tracepoint print out a tracepoint and dump the arguments\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗NAME details\n🔗SYNOPSIS common darktable lua file functions\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; 🔗DESCRIPTION The dtutils.file library provides common file manipulation functions used in constructing darktable lua scripts\n🔗RETURN VALUE df - library - the file functions\n🔗FUNCTIONS 🔗check_if_bin_exists check if an executable exists\n🔗check_if_file_exists check if a file or path exist\n🔗chop_filetype remove a filetype from a filename\n🔗create_unique_filename create a unique filename from the supplied argment\n🔗executable_path_widget create a widget to get executable path preferences\n🔗file_copy copy a file to another name/location\n🔗file_move move a file from one directory to another\n🔗filename_increment add a two digit increment to a filename\n🔗get_basename get the filename without the path or extension\n🔗get_executable_path_preference return the path to an executable from a preference\n🔗get_filename get the filename and extension from a file path\n🔗get_filetype get the filetype from a filename\n🔗get_path get the path from a file path\n🔗mkdir create the directory(ies) if they do not already exists\n🔗rmdir recursively remove a directory\n🔗sanitize_filename make a filename safe to pass as an argument\n🔗set_executable_path_preference set a preference for the path to an executable\n🔗split_filepath split a filepath into parts\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗NAME dtutils.log\n🔗SYNOPSIS darktable lua logging library\n🔗USAGE local log = require \u0026quot;lib/dtutils.log\u0026quot; 🔗DESCRIPTION log provides a multi-level logging solution for use with the darktable lua scripts. With this library you can leave log messages scattered through out your code and only turn them on as necessary.\n🔗RETURN VALUE log - library - the darktable lua logging functions\n🔗FUNCTIONS 🔗caller get the name and line number of the calling routine\n🔗engine get and set the output engine\n🔗log_level get or set the log level\n🔗msg print a log message\n🔗EXAMPLE local log = require \u0026quot;lib/dtutils.log\u0026quot; local cur_level = log.log_level() log.log_level(log.warn) print out warning, error and success messages as code is running\nlog.log_level(debug) print out debugging messages too because this isnt working\nlog.log_level(info) I want to make sure this is working ok\nlog.log_level(cur_level) reset the logging level back to normal\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗DTUTILS.STRING 🔗NAME dtutils.string\n🔗SYNOPSIS a library of string utilities for use in darktable lua scripts\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; 🔗DESCRIPTION This library contains string manipulation routines to aid in building darktable lua scripts.\n🔗RETURN VALUE ds - library - the darktable lua string library\n🔗FUNCTIONS 🔗escape_xml_characters escape characters for xml documents\n🔗is_not_sanitized check if a string has been sanitized\n🔗sanitize surround a string in quotes making it safe to pass as an argument\n🔗sanitize_lua escape lua \u0026lsquo;magic\u0026rsquo; characters from a pattern string\n🔗strip_accents strip accents from characters\n🔗urlencode encode a string in a websafe manner\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗DTUTILS.SYSTEM 🔗NAME dtutils.system\n🔗SYNOPSIS a library of system utilities for use in darktable lua scripts\n🔗USAGE local dtsys = require \u0026quot;lib/dtutils.system\u0026quot; 🔗DESCRIPTION This library contains routines for interfacing to the operating system from darktable lua scripts.\n🔗RETURN VALUE dtsys - library - the darktable lua system library\n🔗FUNCTIONS 🔗external_command pass a command to the operating system for execution and return the result\n🔗launch_default_app open file in default application\n🔗windows_command pass a command to the windows operating system for execution and return the result\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.system/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗NAME dtutils\n🔗SYNOPSIS A Darktable lua utilities library\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; 🔗DESCRIPTION dtutils provides a common library of functions used to build lua scripts.\n🔗RETURN VALUE du- library - the library of functions\n🔗FUNCTIONS 🔗check_min_api_version check the minimum required api version against the current api version\n🔗check_os check that the operating system is supported\n🔗join join a table of strings with a specified separator\n🔗prequire a protected lua require\n🔗spairs an iterator that provides sorted pairs from a table\n🔗split split a string on a specified separator\n🔗SEE ALSO dtutils.debug, dtutils.file, dtutils.log, dtutils.string, dtutils.system\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n🔗COPYRIGHT Copyright (C) 2016 Bill Ferguson wpferguson@gmail.com.\nCopyright (C) 2016 Tobias Jakobs\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗Name executable_manager.lua - a tool for managing external executables used by darktable lua scripts\n🔗Description executable_manager is a tool for managing the executable preferences stored in the darktablerc file. On startup the darktablerc file is scanned and a widget is built for each executable path. The user can select the executable from a drop down list and then modify the settings as desired.\nAny changes made using executable_manager won\u0026rsquo;t be saved in the darktablerc file until darktable exits, but the preference is updated when the change is made so scripts will pick up the changes without restarting darktable.\n🔗Usage  start this script from script manager  🔗Additional Software Required None\n🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/executable_manager/","tags":null,"title":"executable_manager"},{"categories":null,"content":"🔗Current API The Lua API version used in darktable 3.8.0 is 8.0.0.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/version/","tags":null,"title":"Lua API Version"},{"categories":null,"content":"The darktable library is the main entry point for all access to the darktable internals. To access the darktable specific functions you must load the darktable environment:\ndarktable = require \u0026quot;darktable\u0026quot;\nAll functions and data are accessed through the darktable module.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/overview/","tags":null,"title":"overview"},{"categories":null,"content":"This section documents events that can be used to trigger Lua callbacks.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/overview/","tags":null,"title":"overview"},{"categories":null,"content":"darktable can be customized and extended using the Lua programming language. The lua-scripts repository contains the collected efforts of the darktable developers, maintainers, contributors and community.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/overview/","tags":null,"title":"overview"},{"categories":null,"content":"darktable can be customized and extended using the Lua programming language. The lua-scripts repository contains the collected efforts of the darktable developers, maintainers, contributors and community. The following sections list the scripts contained in the repository, whether they can be run by themselves (Standalone - Yes) or depend on other scripts (Standalone - No), what operating systems they are known to work on (L - Linux, M - MacOS, W - Windows), and their purpose.\n🔗Official Scripts These scripts are written primarily by the darktable developers and maintained by the authors and/or repository maintainers. They are located in the official/ directory.\n   Name Standalone Op/Sys Purpose     check_for_updates Yes LMW Check for updates to darktable   copy_paste_metadata Yes LMW Copy and paste metadata, tags, ratings, and color labels between images   delete_long_tags Yes LMW Delete all tags longer than a specified length   delete_unused_tags Yes LMW Delete tags that have no associated images   enfuse No L Exposure blend several images (HDR)   generate_image_txt No L Generate txt sidecar files to be overlaid on zoomed images   image_path_in_ui Yes LMW Plugin to display selected image path   import_filter_manager Yes LMW Manager for import filters   import_filters No LMW Two import filters for use with import_filter_manager   save_selection Yes LMW Provide save and restore from multiple selection buffers   selection_to_pdf No L Generate a PDF file from the selected images    🔗Contributed Scripts These scripts are contributed by users. They are meant to have an \u0026ldquo;owner\u0026rdquo;, i.e. the author, who maintains them. Over time the community has helped maintain these scripts, as well as the authors. They are located in the contrib/ directory.\n   Name Standalone Op/Sys Purpose     AutoGrouper Yes LMW Group images together by time   autostyle Yes LMW Automatically apply styles on import   clear_GPS Yes LMW Reset GPS information for selected images   CollectHelper Yes LMW Add buttons to selected images module to manipulate the collection   copy_attach_detach_tags Yes LMW Copy and paste tags from/to images   cr2hdr Yes L Process image created with Magic Lantern Dual ISO   enfuseAdvanced No LMW Merge multiple images into Dynamic Range Increase (DRI) or Depth From Focus (DFF) images   exportLUT Yes LMW Create a LUT from a style and export it   ext_editor No LW Export pictures to collection and edit them with up to nine user-defined external editors   face_recognition No LM Identify and tag images using facial recognition   fujifilm_ratings No LM Support importing Fujifilm ratings   geoJSON_export No L Create a geo JSON script with thumbnails for use in \u0026hellip;   geoToolbox No LMW A toolbox of geo functions   gimp No LMW Open an image in GIMP for editing and return the result   gpx_export No LMW Export a GPX track file from selected images GPS data   HDRMerge No LMW Combine the selected images into an HDR DNG and return the result   hugin No LMW Combine selected images into a panorama and return the result   image_stack No LMW Combine a stack of images to remove noise or transient objects   image_time Yes LMW Adjust the EXIF image time   kml_export No L Export photos with a KML file for usage in Google Earth   LabelsToTags Yes LMW Apply tags based on color labels and ratings   OpenInExplorer No LMW Open the selected images in the system file manager   passport_guide Yes LMW Add passport cropping guide to darkroom crop tool   pdf_slideshow No LM Export images to a PDF slideshow   photils No LM Automatic tag suggestions for your images   quicktag.md Yes LMW Create shortcuts for quickly applying tags   rate_group Yes LMW Apply or remove a star rating from grouped images   rename-tags Yes LMW Change a tag name   RL_out_sharp No LW Output sharpening using GMic (Richardson-Lucy algorithm)   select_untagged Yes LMW Enable selection of untagged images   slideshowMusic No L Play music during a slideshow   transfer_hierarchy Yes LMW Image move/copy preserving directory hierarchy   video_ffmpeg No LMW Export video from darktable    🔗Example Scripts These scripts provide examples of how to use specific portions of the API. They run, but are meant for demonstration purposes only. They are located in the examples/ directory.\n   Name Standalone Op/Sys Purpose     api_version Yes LMW Print the current API version   darkroom_demo Yes LMW Demonstrate changing images in darkoom   gettextExample Yes LM How to use translation   hello_world Yes LMW Prints hello world when darktable starts   lighttable_demo Yes LMW Demonstrate controlling lighttable mode, zoom, sorting and filtering   moduleExample Yes LMW How to create a lighttable module   multi_os No LMW How to create a cross platform script that calls an external executable   panels_demo Yes LMW Demonstrate hiding and showing darktable panels   preferenceExamples Yes LMW How to use preferences in a script   printExamples Yes LMW How to use various print functions from a script   running_os Yes LMW Print out the running operating system    🔗Tools Tool scripts perform functions relating to the repository, such as generating documentation. They are located in the tools/ directory.\n   Name Standalone Op/Sys Purpose     executable_manager Yes LMW Manage the external executables used by the lua scripts   gen_i18n_mo No LMW Generate compiled translation files (.mo) from source files (.po)   get_lib_manpages No LM Retrieve the library documentation and output it in man page and PDF format   get_libdoc No LMW Retrieve the library documentation and output it as text   script_manager No LMW Manage (install, update, enable, disable) the lua scripts    ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/overview/","tags":null,"title":"overview"},{"categories":null,"content":"event\nThis event is triggered from darkroom view whenever an image\u0026rsquo;s history has changed and another image is being loaded or darkroom view is being changed to another view.\n🔗darkroom-image-history-changed.callback function( event : string, image : types.dt_lua_image_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The image loaded into darkroom view  🔗darkroom-image-history-changed.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/darkroom-image-history-changed/","tags":null,"title":"darkroom-image-history-changed"},{"categories":null,"content":"event\nThis event is triggered whenever an image is loaded in darkroom view\n🔗darkroom-image-loaded.callback function( event : string, image : types.dt_lua_image_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The image loaded into darkroom view  🔗darkroom-image-loaded.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/darkroom-image-loaded/","tags":null,"title":"darkroom-image-loaded"},{"categories":null,"content":"function( path : string, instance : integer, element : string, effect : string, speed : integer ) : string Will perform the specified effect on the path, instance, and element of an action, or return the status.\n path - string - The full path of an action, i.e. 'lib/filter/view'. instance - integer - The instance of an image processing module to execute action on\u0026quot;. element - string - The element of an action, for example \u0026lsquo;selection\u0026rsquo;, or leave empty for default\u0026quot;. effect - string - The effect of an action, for example \u0026lsquo;next\u0026rsquo;, or leave empty for default\u0026quot;. speed - integer - 1 causes the effect to be performed, 0 or NaN returns the current status. return - string - The current status of the action.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/action/","tags":null,"title":"darktable.gui.action"},{"categories":null,"content":"enum\nThe different page types for PDF export\nValues :\n all single contact  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/_pdf_pages_t/","tags":null,"title":"_pdf_pages_t"},{"categories":null,"content":"🔗Name autostyle.lua - automatically apply a given style when an exif tag is present in the image file\n🔗Description Automatically apply a given style when an exif tag is present in the file. This tags are checked with exiftool, in order to be able to match very exotic tags. This was written to be able to apply a style to compensate for Auto-DR from Fujifilm cameras.\n🔗Usage   Set the exif configuration string in your lua configuration. For instance, AutoDynamicRange=200%=\u0026gt;DR200 means that I automatically want to apply my DR200 style on all images where exiftool returns \u0026ldquo;200%\u0026rdquo;\u0026quot; for the AutoDynamicRange tag\n  If you want to be able to apply it to already imported images, define a shortcut (lua shortcuts). If the history stack is removed from the image, autostyle won\u0026rsquo;t be applied again. This shortcut useful when that happens.\n  Import your images, or use the shortcut on already imported images\n  To determine which tag you want, list all tags with exiftool: exiftool -j XE021351.RAF, and find the one you want to use. You can check tags with\n\u0026gt; exiftool -AutoDynamicRange XE021351.RAF Auto Dynamic Range : 200%   🔗Additional Software Required  exiftool  🔗Limitations 🔗Author Marc Cousin - cousinmarc@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/autostyle/","tags":null,"title":"autostyle"},{"categories":null,"content":"🔗NAME caller\n🔗SYNOPSIS get the name and line number of the calling routine\n🔗USAGE local log = require \u0026quot;lib/dtutils.log\u0026quot; result = log.caller(level) level - number - the number of stack levels to go down to retrieve the caller routine information\n🔗DESCRIPTION caller gets the name and line number of the calling routine and returns it\n🔗RETURN VALUE result - string - the name and line number of the calling function or \u0026lsquo;callback: ' if the attempt to get the caller returns nil\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/caller/","tags":null,"title":"caller"},{"categories":null,"content":"🔗NAME check_if_bin_exists\n🔗SYNOPSIS check if an executable exists\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.check_if_bin_exists(bin) bin - string - the binary to check for\n🔗DESCRIPTION check_if_bin_exists checks to see if the specified binary exists. check_if_bin_exists looks for an executable in the following order:\n  If an executable preference is registered, then it\u0026rsquo;s checked to make sure it\u0026rsquo;s a file, exists, and is executable. If it passes all these tests it is returned to the caller. On non-windows operating systems a windows binary can be specified and the wine installation will be checked for the executable.\n  If an executable preference doesn\u0026rsquo;t exist or a test fails then an attempt is made to find the file in an operating system specific manner:\n unix or linux  the user\u0026rsquo;s path is checked for a matching binrary using the which command   macos  first the user\u0026rsquo;s path is checked for a matching binrary using the which command if the executable isn\u0026rsquo;t found a search of the /Applications directory is performed   windows  the user\u0026rsquo;s path is checked using the where command if the executable isn\u0026rsquo;t found, then C:\\Program Files is searched for the executable if the executable isn\u0026rsquo;t found, then C:\\Program Files (x86) is searched      🔗RETURN VALUE result - string - the sanitized path of the binary, false if not found\n🔗LIMITATIONS   it still can\u0026rsquo;t find GIMP on windows. GIMP on windows is installed in C:\\Program Files\\GIMP 2\\bin\\gimp-2.10.exe, if you use the installer from www.gimp.org. When check_if_bin_exists searches for GIMP it looks for gimp.exe. If the search was for gimp*exe then things like gimptool, gimp-debug-tool, gimp-console, etc. are found. Depending on who packaged gimp,there is an executable called gimp.exe which satisfies the search but is a GIMP launcher that exits immediately so the script returns and the image is not edited. Therefore, if you are a windows user, then you need to specify the location of the GIMP executable either from the Edit with GIMP script or using executable manager.\n  flickering windows - on windows every command must run in a window, so every time a script uses a system command a window is opened, the command is run, and the window is closed checking for a binary needs multiple system commands to find the file and then check it which causes \u0026ldquo;flickering windows\u0026rdquo;. If the flickering windows is too disturbing a lua preference is available in the settings to use the old check_if_bin_exists(). The old check_if_bin_exists() still causes flickering windows but it\u0026rsquo;s much less. The downside is that no searching is performed so the user has to specify the location of all executables.\n  🔗CHANGELOG 20201225 - Added search capability and file checking to ensure it\u0026rsquo;s an executable - Merry Christmas\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/","tags":null,"title":"check_if_bin_exists"},{"categories":null,"content":"🔗NAME check_min_api_version\n🔗SYNOPSIS check the minimum required application programming interface (API) version against the current API version\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local result = du.check_min_api_version(min_api, script_name) min_api - string - the API version that the application was written for (example: \u0026ldquo;5.0.0\u0026rdquo;)\nscript_name - string - the name of the script\n🔗DESCRIPTION check_min_api_version compares the minimum API required for the application to run against the current API version. The minimum API version is typically the API version that was current when the application was created. If the minimum API version is not met, then an error message is printed saying the script_name failed to load, then an error is thrown causing the program to stop executing.\nThis function is intended to replace darktable.configuration.check_version(). The application code won\u0026rsquo;t have to be updated each time the API changes because this only checks the minimum version required.\n🔗RETURN VALUE result - boolean - true if the minimum API version is available, false if not.\n🔗LIMITATIONS When using the default handler on a script being executed from the luarc file, the error thrown will stop the luarc file from executing any remaining statements. This limitation does not apply to script_manger.\n🔗EXAMPLE check_min_api_version(\u0026quot;5.0.0\u0026quot;) does nothing if the API is greater than or equal to 5.0.0 otherwise an error message is printed and an error is thrown stopping execution of the script.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/check_min_api_version/","tags":null,"title":"check_min_api_version"},{"categories":null,"content":"🔗Name copy_paste_metadata.lua - copy and paste metadata between images\n🔗Description This script adds keyboard shortcuts and buttons to copy/paste metadata between images.\n🔗Usage  start this script from script manager it adds buttons to the selected images module it adds two keyboard shortcuts  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/copy_paste_metadata/","tags":null,"title":"copy_paste_metadata"},{"categories":null,"content":"🔗Name darkroom_demo - an example script demonstrating how to control image display in darkroom mode\n🔗Description darkroom_demo is an example script showing how to control the currently displayed image in darkroom mode using lua.\n🔗Usage  start this script from script manager  🔗Additional Software Required None\n🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/darkroom_demo/","tags":null,"title":"darkroom_demo"},{"categories":null,"content":"Allows to access the currently worked on images, i.e the ones selected by the collection lib. Filtering (rating etc) does not change that collection.\n🔗darktable.collection.# types.dt_lua_image_t\nEach image in the collection appears with a numerical index; you can iterate them using ipairs.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.collection/","tags":null,"title":"darktable.collection"},{"categories":null,"content":"\ntable\nA table of types.dt_lua_image_t on which the user expects UI actions to happen. It is based on both the hovered image and the selection and is consistent with the way darktable works. It is recommended to use this table to implement Lua actions rather than darktable.gui.hovered or darktable.gui.selection to be consistent with darktable\u0026rsquo;s GUI.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/action_images/","tags":null,"title":"darktable.gui.action_images"},{"categories":null,"content":"The window displaying the currently running jobs\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/backgroundjobs/","tags":null,"title":"darktable.gui.libs.backgroundjobs"},{"categories":null,"content":"The darkroom view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  🔗darktable.gui.views.darkroom.display_image function( [image : types.dt_lua_image_t] ) : types.dt_lua_image_t Display an image in darkroom view.\n **[image] - types.dt_lua_image_t - The image to be displayed. If the image is not given, nothing will be changed. return - types.dt_lua_image_t - The image currently displayed.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/darkroom/","tags":null,"title":"darktable.gui.views.darkroom"},{"categories":null,"content":"🔗NAME dprint\n🔗SYNOPSIS pass a variable to darktable.debug.dump and print the results to stdout\n🔗USAGE local dd = require \u0026quot;lib/dtutils.debug\u0026quot; dd.dprint(var) var - variable - any variable that you want to see the contents of\n🔗DESCRIPTION dprint is a wrapper around darktable.debug.dump, will directly print to stdout, same calling convention\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/dprint/","tags":null,"title":"dprint"},{"categories":null,"content":"🔗NAME escape_xml_characters\n🔗SYNOPSIS escape characters for xml documents\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.escape_xml_characters(str) str - string - the string that needs escaped\n🔗DESCRIPTION escape_xml_characters provides the escape sequences for\n\u0026quot;\u0026amp;\u0026quot;, '\u0026quot;', \u0026quot;'\u0026quot;, \u0026quot;\u0026lt;\u0026quot;, and \u0026quot;\u0026gt;\u0026quot; with the corresponding\n\u0026quot;\u0026amp;amp;\u0026quot;,\u0026quot;\u0026amp;quot;\u0026quot;, \u0026quot;\u0026amp;apos;\u0026quot;, \u0026quot;\u0026amp;lt;\u0026quot;, and \u0026quot;\u0026amp;gt;\u0026quot; .\n🔗RETURN VALUE result - string - the string containing escapes for the xml characters\n🔗REFERENCE https://stackoverflow.com/questions/1091945/what-characters-do-i-need-to-escape-in-xml-documents\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/escape_xml_characters/","tags":null,"title":"escape_xml_characters"},{"categories":null,"content":"event\nThis event is triggered when darktable exits, it allows lua scripts to do cleanup jobs\n🔗events.exit.callback function( ) 🔗events.exit.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/exit/","tags":null,"title":"exit"},{"categories":null,"content":"🔗NAME external_command\n🔗SYNOPSIS pass a command to the operating system for execution and return the result\n🔗USAGE local dsys = require \u0026quot;lib/dtutils.system\u0026quot; local result = dsys.external_command(command) command - string - a string containing the command and arguments to be passed to the operating system for execution.\n🔗DESCRIPTION external_command passes a command to the operating system for execution and returns the results.\n🔗RETURN VALUE result - number = the return value signalling success or failure.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.system/external_command/","tags":null,"title":"external_command"},{"categories":null,"content":"🔗Name gen_i18n_mo - generate translation files from the source and place them in the appropriate locale directory\n🔗Description gen_i18n_mo finds all the .po files scattered throughout the script tree, compiles them into .mo files and places them in the correct locale directory for use by the gettext tools.\n🔗Usage  start this script from script manager. Stop the script after it runs or it will regenerate the translation files each time darktable starts.  🔗Additional Software Required 🔗Limitations 🔗Author 🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/gen_i18n_mo/","tags":null,"title":"gen_i18n_mo"},{"categories":null,"content":"🔗Download and Install The recommended method of installation is using git to clone the repository. This ensures that all dependencies on other scripts are met as well as providing an easy update path.\n🔗snap packages The snap version of darktable comes with lua included starting with version 2.4.3snap2.\nEnsure git is installed on your system. If it isn\u0026rsquo;t, use the package manager to install it. Then open a terminal and:\ncd ~/snap/darktable/current git clone https://github.com/darktable-org/lua-scripts.git lua  🔗flatpak packages Flatpak packages now use the internal lua interpreter.\nEnsure git is installed on your system. If it isn\u0026rsquo;t, use the package manager to install it. Then open a terminal and:\ncd ~/.var/app/org.darktable.Darktable/config/darktable git clone https://github.com/darktable-org/lua-scripts.git lua  🔗appimage packages These packages run in their own environment and don\u0026rsquo;t have access to a lua interpreter, therefore the scripts can\u0026rsquo;t run. The packagers could enable the internal interpreter, or allow the package to link the interpreter from the operating system, or bundle a copy of lua with the package. If you use one of these packages and wish to use the lua scripts, please contact the package maintainer and suggest the above fixes.\n🔗Linux and MacOS Ensure git is installed on your system. If it isn\u0026rsquo;t, use the package manager to install it. Then open a terminal and:\ncd ~/.config/darktable/ git clone https://github.com/darktable-org/lua-scripts.git lua  🔗Windows Ensure git is installed on your system. Git can be obtained from https://gitforwindows.org/, as well as other places. If you use the gitforwindows.org distribution, install the Git Bash Shell also as it will aid in debugging the scripts if necessary. Then open a command prompt and run:\ncd %LOCALAPPDATA%\\darktable git clone https://github.com/darktable-org/lua-scripts.git lua  If you don\u0026rsquo;t have %LOCALAPPDATA%\\darktable you have to start dartable at least once, because the directory is created at the first start of darktable.\n🔗Enabling When darktable starts it looks for a file name ~/.config/darktable/luarc (%LOCALAPPDATA%\\darktable\\luarc for windows) and reads it to see which scripts to include. The file is a plain text file with entries of the form require \u0026quot;\u0026lt;directory\u0026gt;/\u0026lt;name\u0026gt;\u0026quot; where directory is the directory containing the scripts, from the above list, and name is the name from the above list. To include GIMP the line would be require \u0026quot;contrib/gimp\u0026quot;.\nThe recommended way to enable and disable specific scripts is using the script manager module. To use script manager do the following:\n🔗Linux or MacOS echo 'require \u0026quot;tools/script_manager\u0026quot;' \u0026gt; ~/.config/darktable/luarc  🔗Windows echo \u0026quot;require 'tools/script_manager'\u0026quot; \u0026gt; %LOCALAPPDATA%\\darktable\\luarc  🔗Snap echo 'require \u0026quot;tools/script_manager\u0026quot;' \u0026gt; ~/snap/darktable/current/luarc  🔗Flatpak echo require \u0026quot;tools/script_manager\u0026quot;' \u0026gt; ~/.var/app/org.darktable.Darktable/config/darktable/luarc  You can also create or add lines to the luarc file from the command line:\necho 'require \u0026quot;contrib/gimp\u0026quot;' \u0026gt; ~/.config/darktable/luarc to create the file with a gimp entry\nor echo 'require \u0026quot;contrib/hugin\u0026quot;' \u0026gt;\u0026gt; ~/.config/darktable/luarc to add an entry for hugin.\nOn windows from a command prompt:\necho require \u0026quot;contrib/gimp\u0026quot; \u0026gt; %LOCALAPPDATA%\\darktable\\luarc to create the file with a gimp entry\nor echo require \u0026quot;contrib/hugin\u0026quot; \u0026gt;\u0026gt; %LOCALAPPDATA%\\darktable\\luarc to add an entry for hugin.\n🔗Disabling To disable a script open the luarc file in your text editor and insert -- at the start of the line containing the script you wish to disable, then save the file.\n🔗Updating To update the script repository, open a terminal or command prompt and do the following:\n🔗Snap cd ~/snap/darktable/current/lua git pull  🔗Flatpak cd ~/.var/app/org.darktable.Darktable/config/darktable/lua git pull  🔗Linux and MacOS cd ~/.config/darktable/lua/ git pull  🔗Windows cd %LOCALAPPDATA%\\darktable\\lua git pull  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/installation/","tags":null,"title":"installation"},{"categories":null,"content":"🔗NAME check_if_file_exists\n🔗SYNOPSIS check if a file or path exist\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.check_if_file_exists(filepath) filepath - string - a file or path to check\n🔗DESCRIPTION check_if_file_exists checks to see if a file or path exists.\n🔗RETURN VALUE result - boolean - true if the file or path exists, false if it doesn\u0026rsquo;t.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/check_if_file_exists/","tags":null,"title":"check_if_file_exists"},{"categories":null,"content":"🔗NAME check_os\n🔗SYNOPSIS check that the operating system is supported\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local result = du.check_os(operating_systems) operating_systems - table - a table of operating system names such as {\u0026ldquo;windows\u0026rdquo;,\u0026ldquo;linux\u0026rdquo;,\u0026ldquo;macos\u0026rdquo;,\u0026ldquo;unix\u0026rdquo;}\n🔗DESCRIPTION check_os checks a supplied table of operating systems against the operating system the script is running on and returns true if the OS is in the list, otherwise false\n🔗RETURN VALUE result - boolean - true if the operating system is supported, false if not.\n🔗EXAMPLE local du = require \u0026quot;lib/dtutils\u0026quot; if du.check_os({\u0026quot;windows\u0026quot;}) then -- run the script else dt.print(\u0026quot;Script \u0026lt;script name\u0026gt; only runs on windows\u0026quot;) return end ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/check_os/","tags":null,"title":"check_os"},{"categories":null,"content":"🔗Name clear_GPS.lua - clear_GPS - clear GPS data from selected image(s)\n🔗Description This shortcut removes the GPS coordinate data from the selected images.\n🔗Usage  start the script from script manager select an image or images click the shortcut, or the button in selected images to clear GPS data  🔗Additional Software Required 🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/clear_gps/","tags":null,"title":"clear_GPS"},{"categories":null,"content":"enum\nType of compression for webp\nValues:\n webp_lossy webp_lossless  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/comp_type_t/","tags":null,"title":"comp_type_t"},{"categories":null,"content":"table\nThis table includes values that describe details of the configuration of darktable.\n🔗darktable.configuration.version string\nThe version number of darktable.\n🔗darktable.configuration.has_gui boolean\nTrue if darktable has a GUI (launched through the main darktable command, not darktable-cli).\n🔗darktable.configuration.verbose boolean\nTrue if the Lua logdomain is enabled.\n🔗darktable.configuration.tmp_dir string\nThe name of the directory where darktable will store temporary files.\n🔗darktable.configuration.config_dir string\nThe name of the directory where darktable will find its global configuration objects (modules).\n🔗darktable.configuration.cache_dir string\nThe name of the directory where darktable will store its mipmaps.\n🔗darktable.configuration.api_version_major number\nThe major version number of the lua API.\n🔗darktable.configuration.api_version_minor number\nThe minor version number of the lua API.\n🔗darktable.configuration.api_version_patch number\nThe patch version number of the lua API.\n🔗darktable.configuration.api_version_suffix string\nThe version suffix of the lua API.\n🔗darktable.configuration.api_version_string string\nThe version description of the lua API. This is a string compatible with the semantic versioning convention\n🔗darktable.configuration.running_os string\nThe name of the Operating system darktable is currently running on\n🔗darktable.configuration.check_version function( module_name : string, ... : table... ) Check that a module is compatible with the running version of darktable Add the following line at the top of your module : darktable.configuration.check(...,{M,m,p},{M2,m2,p2}) To document that your module has been tested with API version M.m.p and M2.m2.p2. This will raise an error if the user is running a released version of DT and a warning if he is running a development version (the \u0026hellip; here will automatically expand to your module name if used at the top of your script).\n module_name - string - The name of the module to report on error \u0026hellip; - table - Tables of API versions that are known to work with the script  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.configuration/","tags":null,"title":"darktable.configuration"},{"categories":null,"content":"function( text : string, [percentage : boolean], [cancel_callback : function] ) : types.dt_lua_backgroundjob_t Create a new progress_bar displayed in darktable.gui.libs.backgroundjobs\n  text - string - The text to display in the job entry\n  [percentage] - boolean - Should a progress bar be displayed\n  [cancel_callback] - function - A function called when the cancel button for that job is pressed. Note: the job won\u0026rsquo;t be destroyed automatically. You need to set types.dt_lua_backgroundjob_t.valid to false for that.\n  return - types.dt_lua_backgroundjob_t - The newly created job object\n  🔗cancel_callback function( job : types.dt_lua_backgroundjob_t )  job - types.dt_lua_backgroundjob_t - The job that is being cancelled  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/create_job/","tags":null,"title":"darktable.gui.create_job"},{"categories":null,"content":"The camera selection UI\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/camera/","tags":null,"title":"darktable.gui.libs.camera"},{"categories":null,"content":"The lighttable view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  🔗darktable.gui.views.lighttable.is_image_visible function( image : types.dt_lua_image_t ) : types.dt_lua_image_t Check if the image is visible in lighttable view. The lighttable must be in file manager or zoomable mode.\n image - types.dt_lua_image_t - The image to be checked. return - boolean - True if the image is displayed. False if the image is partially displayed or not displayed.  🔗darktable.gui.views.lighttable.set_image_visible function( image : types.dt_lua_image_t ) : types.dt_lua_image_t Set the image visible in lighttable view. The lighttable must be in file manager or zoomable mode.\n image - types.dt_lua_image_t - The image to set visible. return - int - An error is returned if no image is specified.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/lighttable/","tags":null,"title":"darktable.gui.views.lighttable"},{"categories":null,"content":"🔗Name delete_long_tags.lua - delete all tags longer than a set length\n🔗Description A simple script that will automatically delete all tags longer than a set length\n🔗Usage  start this script from script manager set the the maximum length in darktable\u0026rsquo;s preference restart darktable  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/delete_long_tags/","tags":null,"title":"delete_long_tags"},{"categories":null,"content":"🔗NAME engine\n🔗SYNOPSIS get and set the output engine\n🔗USAGE local log = require \u0026quot;lib/dtutils.log\u0026quot; result = log.engine(level, ...) level - table - the log level to get or set the engine for, one of log.debug, log.info, log.warn, log.error log.success, log.always, log.screen, log.critical\n\u0026hellip; - function - the output function, one of dt.print, dt.print_error, dt.print_log, print if not function is included, the current engine is returned for the specified log level\n🔗DESCRIPTION engine returns the output engine for the specified log level if a second argument is not supplied. If a function is supplied as the second argment, then the output engine for the specified log level is set to that.\n🔗RETURN VALUE result - function - the current output engine\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/engine/","tags":null,"title":"engine"},{"categories":null,"content":"🔗Name get_lib_manpages.lua - retrieve the included library documentation and output it as man pages\n🔗Description This script retrieves the included documentation in the script libaries and outputs them to the system temporary directory as man pages. Stop this script after it runs otherwise it will regenerate the pages each time it runs.\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author 🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/get_lib_manpages/","tags":null,"title":"get_lib_manpages"},{"categories":null,"content":"🔗Name gettextExample.lua - darktable script to show how translations works\n🔗Description To create the .po file run: xgettext -l lua gettextExample.lua\nxgettext is not a lua tool, it knows (almost) nothing about Lua, and not enough to do a proper parsing. It takes a text file (In our case a Lua file) and recognises a few (language dependant) keyword in there. It matches those keywords with internal description on how functions are called and creates the .po file accordingly. (For example, it knows that the first argument of gettext() is the translated string, but that it\u0026rsquo;s the second argument for dgettext) This is important because it means that if you use some neat Lua tricks (like renaming functions) xgettext won\u0026rsquo;t recognize those calls and won\u0026rsquo;t extract the string to the .po file. So, this is why we create a local variagle gettext = dt.gettext, so xgettext recognises gettext.gettext as a function but not dt.gettext.gettext\nTo create a .mo file run: msgfmt -v gettextExample.po -o gettextExample.mo\n🔗Usage  start this script from script manager copy the gettextExample.mo to .config/darktable/lua/de_DE/LC_MESSAGES  You need to start darktable with the Lua debug option: darktable -d lua $LANG must set to: de_DE\nThe script run on darktable startup and should output this three lines:\nLUA ERROR Hello World! LUA ERROR Bild LUA ERROR Hallo Welt! 🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/gettextexample/","tags":null,"title":"gettextExample"},{"categories":null,"content":"event\nThis event is triggered after the user toggled the grouping button.\n🔗global_toolbox-grouping_toggle.callback function( toggle : boolean )  toggle - boolean - the new grouping status.  🔗global_toolbox-grouping_toggle.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/global_toolbox-grouping_toggle/","tags":null,"title":"global_toolbox-grouping_toggle"},{"categories":null,"content":"🔗NAME is_not_sanitized\n🔗SYNOPSIS Check if a string has been sanitized\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.is_not_sanitized(str) str - string - the string that needs to be made safe\n🔗DESCRIPTION is_not_sanitized checks a string to see if it has been made safe use passing as an argument in a system command.\n🔗RETURN VALUE result - boolean - true if the string is not sanitized otherwise false\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/is_not_sanitized/","tags":null,"title":"is_not_sanitized"},{"categories":null,"content":"🔗NAME launch_default_app\n🔗SYNOPSIS open file in default application\n🔗USAGE local dsys = require \u0026quot;lib/dtutils.file\u0026quot; result = dsys.launch_default_app(path) path - string - a file path\n🔗DESCRIPTION launch_default_app allows opening a file in the application that is assigned as default for that filetype in the users\u0026rsquo;s system\n🔗RETURN VALUE result - number - the return value signalling success or failure.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.system/launch_default_app/","tags":null,"title":"launch_default_app"},{"categories":null,"content":"🔗NAME new_tracepoint\n🔗SYNOPSIS create a function returning a tracepoint\n🔗USAGE local dd = require \u0026quot;lib/dtutils.debug\u0026quot; local result = dd.new_tracepoint(name, ...) name - string - the name of the tracepoint to print out\n\u0026hellip; - arguments - variables to dump the contents of\n🔗DESCRIPTION new_tracepoint returns a tracepoint function with the given name. This is mainly used to debug callbacks.\n🔗RETURN VALUE result - function - a function that returns the result of a tracepoint\n🔗EXAMPLE register_event(event, dd.new_tracepoint(\u0026quot;hit callback\u0026quot;)) will print the following each time the callback is called\n**** hit callback **** \u0026lt;all the callback's parameters dumped\u0026gt; ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/new_tracepoint/","tags":null,"title":"new_tracepoint"},{"categories":null,"content":"Running darktable with Lua debugging enabled provides more information about what is occurring within the scripts.\n🔗Snap Open a terminal and start darktable with the command snap run darktable -d lua. This provides debugging information to give you insight into what is happening.\n🔗Linux Open a terminal and start darktable with the command darktable -d lua. This provides debugging information to give you insight into what is happening.\n🔗MacOS Open a terminal and start darktable with the command /Applications/darktable.app/Contents/MacOS/darktable -d lua. This provides debugging information to give you insight into what is happening.\n🔗Windows Open a command prompt. Start darktable with the command \u0026ldquo;C:\\Program Files\\darktable\\bin\\darktable\u0026rdquo; -d lua \u0026gt; log.txt. This provides debugging information to give you insight into what is happening.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/troubleshooting/","tags":null,"title":"troubleshooting"},{"categories":null,"content":"🔗NAME deprecated\n🔗SYNOPSIS warn that a script is deprecated\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; du.deprecated(script_name, deprecation_time) script_name - string - the name of the script, i.e. \u0026ldquo;contrib/clear_GPS\u0026rdquo;\ndeprecation_time - string - when the script will be removed, i.e. \u0026ldquo;darktable release 4.0\u0026rdquo;\n🔗DESCRIPTION deprecated gives users a warning that a script is outdated or no longer useful and will be removed at the specified time\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/deprecated/","tags":null,"title":"deprecated"},{"categories":null,"content":"🔗NAME find_image_by_id\n🔗SYNOPSIS look up an image by ID in the database\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local img = du.find_image_by_id(imgid) imgid - int - the image ID to retrieve\n🔗DESCRIPTION find_image_by_id looks up an image by ID in the database.\n🔗RETURN VALUE img - dt_lua_image_t - image with the given ID if found, nil if not\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/find_image_by_id/","tags":null,"title":"find_image_by_id"},{"categories":null,"content":"🔗NAME chop_filetype\n🔗SYNOPSIS remove a filetype from a filename\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.chop_filetype(path) path - string - a filename with or without a path\n🔗DESCRIPTION chop_filetype removes the filetype from the filename.\n🔗RETURN VALUE result - string - the path and filename without the filetype\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/chop_filetype/","tags":null,"title":"chop_filetype"},{"categories":null,"content":"🔗Name CollectHelper.lua - add buttons to help with collections\n🔗Description This plugin adds the button(s) to the \u0026ldquo;Selected Images\u0026rdquo; module:\n Return to Previous Collection Collect on image\u0026rsquo;s Folder Collect on image\u0026rsquo;s Color Label(s) Collect on All (AND)  It also adds 3 preferences to the lua options dialog box which allow the user to activate/deactivate the 3 \u0026ldquo;Collect on\u0026rdquo; buttons.\nButton Behavior:\n Return to Previous Collection - Will reset the collect parameters to the previously active settings Collect on image\u0026rsquo;s Folder - Will change the collect parameters to be \u0026ldquo;Folder\u0026rdquo; with a value of the selected image\u0026rsquo;s folder location Collect on image\u0026rsquo;s Color Label(s) - Will change the collect parameter to be \u0026ldquo;Color\u0026rdquo; with a value of the selected images color labels, will apply multiple parameters with AND logic if multiple exist Collect on All (AND) - Will collect on all parameters activated by the preferences dialog, as such this button is redundant if you only have one of the two other options enabled  🔗Usage   start CollectHelper with script manager.\n  Select the photo you wish to change you collection based on. In the \u0026ldquo;Selected Images\u0026rdquo; module click on \u0026ldquo;Collect on this Image\u0026rdquo;\n  🔗Additional Software Required 🔗Limitations 🔗Author Kevin Ertel\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/collecthelper/","tags":null,"title":"CollectHelper"},{"categories":null,"content":"This table contain function to manipulate the control flow of lua programs. It provides ways to do background jobs and other related functions\n🔗darktable.control.ending boolean\nTRUE when darktable is terminating Use this variable to detect when you should finish long running jobs\n🔗darktable.control.dispatch function( function : function, ... : anything ) Runs a function in the background. This function will be run at a later point, after luarc has finished running. If you do a loop in such a function, please check darktable.control.ending in your loop to finish the function when darktable exits\n function - function - The call to dispatch \u0026hellip; - anything - extra parameters to pass to the function  🔗darktable.control.sleep function( delay : int ) Suspends execution while not blocking darktable\n delay - int - The delay in millisecond to sleep  🔗darktable.control.execute function( command : string ) : int Run a command in a shell while not blocking darktable\n command - string - The command to run, as in \u0026lsquo;sh -c\u0026rsquo; return - int - The result of the system call  🔗darktable.control.read function( file : file ) Block until a file is readable while not blocking darktable This function is not available on Windows builds\n file - file - The file object to wait for  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.control/","tags":null,"title":"darktable.control"},{"categories":null,"content":"function( [view : types.dt_lua_view_t] ) : types.dt_lua_view_t Get or change the current view.\n [view] - _types.dt_lua_view_t_ - The view to switch to. If empty the current view is unchanged return - _types.dt_lua_view_t_ - the current view  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/current_view/","tags":null,"title":"darktable.gui.current_view"},{"categories":null,"content":"The collection UI element that allows to filter images by collection\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.collect.filter function( [rules : array of types.dt_lib_collect_params_rule_t] ) : array oftypes.dt_lib_collect_params_rule_t Get or change the list of visible images\nAttributes:\n  implicit_yield\n  [rules] - array of types.dt_lib_collect_params_rule_t - A table of rules describing the filter. These rules will be applied after this call\n  return - array of types.dt_lib_collect_params_rule_t - The rules that were applied before this call.\n  🔗darktable.gui.libs.collect.new_rule function( ) : types.dt_lib_collect_params_rule_t Returns a newly created rule object\n return - types.dt_lib_collect_params_rule_t - The newly created rule  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/collect/","tags":null,"title":"darktable.gui.libs.collect"},{"categories":null,"content":"The map view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  🔗darktable.gui.views.map.latitude  number - The latitude of the center of the map  Attributes:\n write  🔗darktable.gui.views.map.longitude  number - The longitude of the center of the map  Attributes:\n write  🔗darktable.gui.views.map.zoom  number - The current zoom level of the map  Attributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/map/","tags":null,"title":"darktable.gui.views.map"},{"categories":null,"content":"🔗Name delete_unused_tags.lua - automatically delete all tags that are not attached to any images\n🔗Description A simple script that will automatically delete all tags that are not attached to any images\n🔗Usage  start this script from script manager restart darktable  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/delete_unused_tags/","tags":null,"title":"delete_unused_tags"},{"categories":null,"content":"enum\nThe different elements on which a collection can be filtered\nValues:\n DT_COLLECTION_FILTER_ALL DT_COLLECTION_FILTER_STAR_NO DT_COLLECTION_FILTER_STAR_1 DT_COLLECTION_FILTER_STAR_2 DT_COLLECTION_FILTER_STAR_3 DT_COLLECTION_FILTER_STAR_4 DT_COLLECTION_FILTER_STAR_5 DT_COLLECTION_FILTER_REJECT DT_COLLECTION_FILTER_NOT_REJECT  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_filter_t/","tags":null,"title":"dt_collection_filter_t"},{"categories":null,"content":"🔗Name get_libdoc.lua - retrieve the included library documentation and output it as text\n🔗Description 🔗Usage  start this script from script manager. Disable it after it finishes or it will generate the pages every time darktable runs.  🔗Additional Software Required 🔗Limitations 🔗Author 🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/get_libdoc/","tags":null,"title":"get_libdoc"},{"categories":null,"content":"event\nThis event is triggered after the user toggled the overlay button.\n🔗global_toolbox-overlay_toggle.callback function( toggle : boolean )  toggle - boolean - the new overlay status.  🔗global_toolbox-overlay_toggle.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/global_toolbox-overlay_toggle/","tags":null,"title":"global_toolbox-overlay_toggle"},{"categories":null,"content":"🔗Name hello_world.lua - a simple lua script\n🔗Description prints \u0026ldquo;hello world when DT starts\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/hello_world/","tags":null,"title":"hello_world"},{"categories":null,"content":"🔗NAME join\n🔗SYNOPSIS join a table of strings with a specified separator\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local result = du.join(tabl, pat) tabl - table - a table of strings\npat - string - a separator\n🔗DESCRIPTION join assembles a table of strings into a string with the specified pattern in between each string\n🔗RETURN VALUE result - string - the joined string on success, or an empty string on failure\n🔗EXAMPLE join({a, \u0026quot;long\u0026quot;, \u0026quot;path\u0026quot;, \u0026quot;name\u0026quot;, \u0026quot;to\u0026quot;, a, \u0026quot;file.txt\u0026quot;}, \u0026quot; \u0026quot;) would return the string \u0026ldquo;a long path name to a file.txt\u0026rdquo;\n🔗REFERENCE http://lua-users.org/wiki/SplitJoin\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/join/","tags":null,"title":"join"},{"categories":null,"content":"🔗NAME log_level\n🔗SYNOPSIS get or set the log level\n🔗USAGE local log = require \u0026quot;lib/log\u0026quot; local result = log.log_level(...) \u0026hellip; - arguments - if none is supplied, then the current log level is returned as one of: log.debug, log.info, log.warn, log.error, log.success. If one of log.debug, log.info, log.warn, log.error, or log.success is supplied as the argument then the log level is set to that value. All log levels greater than or equal in value will be enabled. Any levels of lesser value will be disabled.\n🔗DESCRIPTION log_level gets and sets the logging level. When called with no arguments the current log level is returned as one of log.debug, log.info, log.warn, log.error, or log.success. When called with one of log.debug, log.info, log.warn, log.error or log.success then the log level is set. When setting the log level all levels equal or greater are enabled and any of lesser value are disabled. See the example.\n🔗RETURN VALUE result - log level - one of log.debug, log.info, log.warn, log.error or log.success\n🔗EXAMPLE Assume that the current log level is log.error. Calling\nlog.log_level() will return log.error. Calling\nlog.log_level(log.info) will leave log.debug disabled, and enable log.info, log.warn, log.error and log.success. log.info will be returned as the log_level.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/log_level/","tags":null,"title":"log_level"},{"categories":null,"content":"🔗NAME sanitize\n🔗SYNOPSIS surround a string in quotes making it safe to pass as an argument\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.sanitize(str) str - string - the string that needs to be made safe\n🔗DESCRIPTION sanitize converts a string into a version suitable for use passing as an argument in a system command.\n🔗RETURN VALUE result - string - a websafe string\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/sanitize/","tags":null,"title":"sanitize"},{"categories":null,"content":"🔗NAME terse_dump\n🔗SYNOPSIS set darktable.debug.known to shorten all image dumps to a single line\n🔗USAGE local dd = require \u0026quot;lib/dtutils.debug\u0026quot; dd.terse_dump() 🔗DESCRIPTION terse_dump sets darktable.debug.known to shorten all images to a single line. If you don\u0026rsquo;t need to debug the content of images, this will avoid them flooding your logs.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/terse_dump/","tags":null,"title":"terse_dump"},{"categories":null,"content":"🔗NAME windows_command\n🔗SYNOPSIS pass a command to the windows operating system for execution and return the result\n🔗USAGE local dsys = require \u0026quot;lib/dtutils.system\u0026quot; local result = dsys.windows_command(command) command - string - a string containing the command and arguments to be passed to the operating system for execution.\n🔗DESCRIPTION The normal method of executing an operating system command is using dt.control.execute(), but that doesn\u0026rsquo;t work with Windows when more than one item in the command is quoted. In order to ensure command execution on Windows we create a batch file in the temporary directory, put the command in it, execute the batch file, then return the result.\n🔗RETURN VALUE result - number - the return value signalling success or failure.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.system/windows_command/","tags":null,"title":"windows_command"},{"categories":null,"content":"This section documents various attributes used throughout the documentation.\n🔗write This object is a variable that can be written to.\n🔗has_tostring This object has a specific reimplementation of the \u0026ldquo;tostring\u0026rdquo; method that allows pretty-printing it.\n🔗implicit_yield This call will release the Lua lock while executing, thus allowing other Lua callbacks to run.\n🔗parent This object inherits some methods from another object. You can call the methods from the parent on the child object\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/attributes/","tags":null,"title":"attributes"},{"categories":null,"content":"🔗Name copy_attach_detach_tags.lua - tools to manipulate image tags\n🔗Description This script that will create four shortcuts and add a module in lighttable mode to copy, paste, replace and remove tags from images.\n🔗Usage  set the shortcuts for copy, attach and detach in the preferences dialog \u0026lt;your shortcut1\u0026gt; copy will create a list of tags from all selected images \u0026lt;your shortcut2\u0026gt; paste copied tags to selected images, whereby darktable internal tags starting with \u0026lsquo;darktable|\u0026rsquo; will not be touched \u0026lt;your shortcut3\u0026gt; removes all except darktable internal tags from selected images \u0026lt;your shortcut4\u0026gt; replaces all tags except darktable internals A module reset will empty the clipboard  🔗Additional Software Required 🔗Limitations 🔗Author Christian Kanzian\nHolger Klemm\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags/","tags":null,"title":"copy_attach_detach_tags"},{"categories":null,"content":"🔗NAME create_unique_filename\n🔗SYNOPSIS create a unique filename from the supplied argument\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.create_unique_filename(filepath) filepath - string - the path and filename requested\n🔗DESCRIPTION create_unique_filename takes a requested filepath and checks to see if it exists. If if doesn\u0026rsquo;t then it\u0026rsquo;s returned intact. If it already exists, then a two digit increment is added to the filename and it is tested again. The increment keeps increasing until either a unique filename is found or there have been 100 attempts.\n🔗RETURN VALUE result - string - the incremented filename\n🔗LIMITATIONS create_unique_filename will only attempt 100 increments.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/create_unique_filename/","tags":null,"title":"create_unique_filename"},{"categories":null,"content":"Allows access to the database of images. Note that duplicate images (images with the same RAW but different XMP) will appear multiple times with different duplicate indexes. Also note that all images are here. This table is not influenced by any GUI filtering (collections, stars etc\u0026hellip;).\n🔗darktable.database.# types.dt_lua_image_t\nEach image in the database appears with a numerical index; you can iterate over them using ipairs.\n🔗darktable.database.duplicate function( image : types.dt_lua_image_t ) : types.dt_lua_image_t Creates a duplicate of an image and returns it.\n image - types.dt_lua_image_t - the image to duplicate return - types.dt_lua_image_t - The new image object.  🔗darktable.database.import function( location : string ) : types.dt_lua_image_t Imports new images into the database.\n location - string - The filename or directory to import images from. NOTE: If the images are set to be imported recursively in preferences only the toplevel film is returned (the one whose path was given as a parameter). NOTE 2: If the parameter is a directory the call is nonblocking; the film object will not have the newly imported images yet. Use a post-import-film filtering on that film to react when images are actually imported. return - types.dt_lua_image_t - The created image if an image is imported or the toplevel film object if a film was imported.  🔗darktable.database.get_image function( image_id : int, ) : types.dt_lua_image_t Get an image, specified by image_id, from the database.\n image_id - int - The id number of the image to get return - types.dt_lua_image_t - The image object if found, otherwise nil  🔗darktable.database.move_image function( image : types.dt_lua_image_t, film : types.dt_lua_film_t, [newname : string] ) Physically moves an image (and all its duplicates) to another film, and/or renames the image file. This will move the image file, the related XMP and all XMP for the duplicates to the directory of the new film and rename them as specified. Note that the order of the two required parameters is not relevant.\n image - types.dt_lua_image_t - The image to move film - types.dt_lua_image_t - The film to move to. To rename a file within the same film, set this to the image\u0026rsquo;s current film. [newname] - string - (Optional) If provided, rename the file with this new name. Must not contain any path separator characters.  🔗darktable.database.copy_image function( image : types.dt_lua_image_t, film : types.dt_lua_film_t, [newname : string] ) : types.dt_lua_image_t Physically copies an image to another film. This will copy the image file and the related XMP to the directory of the new film and rename them as specified. If there is already a file with the same name as the image file, it will create a duplicate from that file instead. Note that the order of the two required parameters is not relevant.\n image - types.dt_lua_image_t - The image to copy film - types.dt_lua_image_t - The film to copy to. To make a copy of a file within the same film, set this to the image\u0026rsquo;s current film. [newname] - string - (Optional) If provided, give the copy this new filename. Must not contain any path separator characters. return - types.dt_lua_image_t - The new image  🔗darktable.database.delete see types.dt_lua_image_t.delete\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.database/","tags":null,"title":"darktable.database"},{"categories":null,"content":"types.dt_lua_image_t\nThe image under the cursor or nil if no image is hovered.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/hovered/","tags":null,"title":"darktable.gui.hovered"},{"categories":null,"content":"The color buttons that allow to set labels on an image\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/colorlabels/","tags":null,"title":"darktable.gui.libs.colorlabels"},{"categories":null,"content":"The print view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/print/","tags":null,"title":"darktable.gui.views.print"},{"categories":null,"content":"enum\nThe different elements on which a collection can be filtered\nValues:\n DT_COLLECTION_PROP_FILMROLL DT_COLLECTION_PROP_FOLDERS DT_COLLECTION_PROP_CAMERA DT_COLLECTION_PROP_TAG DT_COLLECTION_PROP_DAY DT_COLLECTION_PROP_TIME DT_COLLECTION_PROP_IMPORT_TIMESTAMP DT_COLLECTION_PROP_CHANGE_TIMESTAMP DT_COLLECTION_PROP_EXPORT_TIMESTAMP DT_COLLECTION_PROP_PRINT_TIMESTAMP DT_COLLECTION_PROP_HISTORY DT_COLLECTION_PROP_COLORLABEL DT_COLLECTION_PROP_TITLE DT_COLLECTION_PROP_DESCRIPTION DT_COLLECTION_PROP_CREATOR DT_COLLECTION_PROP_PUBLISHER DT_COLLECTION_PROP_RIGHTS DT_COLLECTION_PROP_LENS DT_COLLECTION_PROP_FOCAL_LENGTH DT_COLLECTION_PROP_ISO DT_COLLECTION_PROP_APERTURE DT_COLLECTION_PROP_FILENAME DT_COLLECTION_PROP_GEOTAGGING  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_properties_t/","tags":null,"title":"dt_collection_properties_t"},{"categories":null,"content":"🔗Name enfuse.lua - merge the selected images into one tonemapped image and import the result\n🔗Description This script uses enfuse to merge the selected images into one tonemapped image and imports the result. It only works on ldr images (like, JPEG).\n🔗Usage  start this script from script manager it creates a new lighttable module  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/enfuse/","tags":null,"title":"enfuse"},{"categories":null,"content":"event\nThis event is called each time an image is exported, once for each image after the image has been processed to an image format but before the storage has moved the image to its final destination. The call is blocking.\n🔗intermediate-export-image.callback function( event : string, image : types.dt_lua_image_t, filename : string, format : types.dt_imageio_module_format_t, storage : types.dt_imageio_module_storage_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The image object that has been exported. filename - string - The name of the file that is the result of the image being processed. format - types.dt_imageio_module_format_t - The format used to export the image. storage - types.dt_imageio_module_storage_t - The storage used to export the image (can be nil).  🔗intermediate-export-image.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/intermediate-export-image/","tags":null,"title":"intermediate-export-image"},{"categories":null,"content":"🔗Name lighttable_demo.lua - an example script demonstrating how to control lighttable display modes\n🔗Description lighttable_demo is an example script showing how to control lighttable layout, sorting, and filtering from a lua script. If the selected directory has different ratings, color labels, etc, then the sorting and filtering display is a little clearer.\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/lighttable_demo/","tags":null,"title":"lighttable_demo"},{"categories":null,"content":"🔗NAME msg\n🔗SYNOPSIS print a log message\n🔗USAGE local log = require \u0026quot;lib/log\u0026quot; log.msg(level, ...) level - table - the type of message, one of:\n log.debug - debugging messages log.info - informational messages log.warn - warning messages log.error - error messages log.success - success messages log.always - an internal message for debugging log.screen - output 1 line of text to the screen log.critical - print a critical message to the console  \u0026hellip; - string(s) - the message to print, which could be a comma separated set of strings\n🔗DESCRIPTION msg checks the level to see if it is enabled, then prints the level type and message if it is. Messages are output using the engine configured in each log level.\n🔗LIMITATIONS If you use log.msg in a callback, the name of the calling routine can\u0026rsquo;t be determined. A solution is to include some means of reference such as the name of the callback as an argument, i.e.\nlog.msg(log.debug, \u0026quot;libPlugin.format_combobox:\u0026quot;, \u0026quot;value is \u0026quot; .. self.value) which would result in\nDEBUG: callback: libPlugin.format_combobox: value is JPEG ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/msg/","tags":null,"title":"msg"},{"categories":null,"content":"🔗NAME prequire\n🔗SYNOPSIS a protected lua require\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local status, lib = du.prequire(req_name) req_name - string - the filename of the lua code to load without the \u0026ldquo;.lua\u0026rdquo; filetype\n🔗DESCRIPTION prequire is a protected require that can survive an error in the code being loaded without bringing down the calling routine.\n🔗RETURN VALUE status - boolean - true on success lib - if status is true, then the code, otherwise an error message\n🔗EXAMPLE local status, lib = prequire(\u0026quot;lib/dtutils.file\u0026quot;) which would load lib/dtutils/file.lua which would return a status of true and the reference to the library.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/prequire/","tags":null,"title":"prequire"},{"categories":null,"content":"🔗NAME sanitize_lua\n🔗SYNOPSIS escape lua \u0026lsquo;magic\u0026rsquo; characters from a pattern string\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.sanitize_lua(str) str - string - the string that needs to be made safe\n🔗DESCRIPTION sanitize_lua escapes lua \u0026lsquo;magic\u0026rsquo; characters so that a string may be used in lua string/patten matching.\n🔗RETURN VALUE result - string - a lua pattern safe string\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/sanitize_lua/","tags":null,"title":"sanitize_lua"},{"categories":null,"content":"🔗Name script_manager.lua - a tool for managing the darktable lua scripts\n🔗Description script_manager is designed to be called from the users luarc file and used to manage the lua scripts.\nOn startup script_manager scans the lua scripts directory to see what scripts are present. Scripts are sorted by \u0026lsquo;category\u0026rsquo; based on what sub-directory they are in. With no additional script repositories iinstalled, the categories are contrib, examples, official and tools. When a category is selected the buttons show the script name and whether the script is started or stopped. The button is a toggle, so if the script is stopped click the button to start it and vice versa.\n🔗Features   the number of script buttons shown can be changed to any number between 5 and 20. The default is 10 buttons. This can be changed in the configuration action.\n  additional repositories of scripts may be installed from the install/update action.\n  installed scripts can be updated from the install/update action. This includes extra repositories that have been installed.\n  the lua scripts can be disabled if desired from the install/update action.\n  script_manager is automatically installed and enabled when the lua scripts are installed by the darktable scripts_installer.\n  🔗Usage   start/stop scripts -\n The top part of the window has the category selector. The category corresponds to the directory that the scripts are in. Currently the categories are contrib for community contributed scripts, examples for example scripts, official for developer contributed scripts, and tools containing tools for managing the lua scripts. The lower part of the window contains the paged interface for the scripts contained in the selected category. There are arrow buttons for navigating the pages and an indicator showing what the current page is and how many pages of scripts there are for the current category. The number of buttons defaults to 10, but is configurable anywhere between 5 and 20 depending on how much screen real estate you want to use. The scripts are sorted alphabetically. The button shows the name of the script and it\u0026rsquo;s current status, started or stopped. Clicking the script button toggles the script from started to stopped and back again.    configure - this window allows changing the number of buttons used to display scripts. Move the slider to select the number of buttons, click the change number of buttons button and the number of buttons will change and the action will change back to the start/stop scripts window.\n  install/update scripts - This window allows installing additional script repositories and updating installed repositories.\n  update - select the scripts to update from the scripts to update dropdown. Click the update scripts button to do the update.\n  install - additional script repositories can be added to your lua scripts. To add another repository fill in the URL to download additional scripts from and then fill in the new category to place scripts in. Click the install additional scripts button and the category (directory) is created and a git clone is performed to retrieve the git repository. EXAMPLE: fill in URL to download additional scripts from with https://github.com/wpferguson/extra-dt-lua-scripts.git and the new category to place scripts in with wpferguson. Click the button to install the scripts. The scripts are retrieved and added to the user interface and the window changes to the newly installed script category.\n  disable scripts - the lua scripts are installed by the darktable scripts installer. If you install them and later decide you no longer want them cluttering up your user interface, this option can disable them and stop them from starting. Once they are disabled, the way to enable them again is to rename a file using the terminal and command line. To disable the scritps first click the checkbox to enable the Disable Scripts button. This is to prevent accidentally disabling the lua scripts. Once the Disable Scripts button is active, click it to disable the scripts. When the button is clicked, the luarc file is renamed to luarc.disabled which results in the scripts not starting the next time darktable starts.\n    🔗Additional Software Required git - wwww.git.org - git is used to install and update the scripts. script_manager will still run if git is not installed or accessible, but installing and updating scripts will not be possible.\n🔗Limitations   There isn\u0026rsquo;t currently a way to stop an executing script and remove it from the interface, so when a script is stopped the script preference is set to not start the next time darktable starts.\n  If the scripts are disabled by choice the only way to enable them is by renaming the file luarc.disabled to luarc. Then file is located in the user\u0026rsquo;s darktable configuration directory, $HOME/.config/darktable on linux and macos and %LOCALAPPDATA%\\darktable on windows.\n  🔗Author Bill Ferguson \u0026lt;wpferguson@gmail.com\u0026gt;\n🔗Change Log 20201225 - Rewrite for darktable 3.4 - Merry Christmas\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/script_manager/","tags":null,"title":"script_manager"},{"categories":null,"content":"🔗NAME tracepoint\n🔗SYNOPSIS print out a tracepoint and dump the arguments\n🔗USAGE local dd = require \u0026quot;lib/dtutils.debug\u0026quot; local result = dd.tracepoint(name, ...) name - string - the name of the tracepoint to print out\n\u0026hellip; - arguments - variables to dump the contents of\n🔗DESCRIPTION tracepoint prints its name and dumps its parameters using darktable.debug.\n🔗RETURN VALUE result - \u0026hellip; - the supplied argument list\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/tracepoint/","tags":null,"title":"tracepoint"},{"categories":null,"content":"🔗Name cr2hdr.lua - Magic Lantern Dual ISO processing\n🔗Description cr2hdr Magic Lantern Dual ISO processing.\nThis script automates the steps involved to process an image created with the Magic Lantern Dual ISO module. Upon invoking the script with a shortcut \u0026ldquo;cr2hdr\u0026rdquo; provided by Magic Lantern is run on the selected images. The processed files are imported. They are also made group leaders to hide the original files.\n🔗Usage  start this script using script manager trigger conversion on selected/hovered images by shortcut (set shortcut in settings dialog) it is also possible to have the script run after importing a collection (optin, since it is not that fast)  🔗Additional Software Required  cr2hdr (sources can be obtained through the Magic Lantern repository)  🔗Limitations 🔗Author Till Theato - theato@ttill.de\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/cr2hdr/","tags":null,"title":"cr2hdr"},{"categories":null,"content":"table\nThis section must be activated separately by calling require darktable.debug\n🔗darktable.debug.dump function( object : anything, [name : string], [known : table] ) : string This will return a string describing everything Lua knows about an object, used to know what an object is. This function is recursion-safe and can be used to dump _G if needed.\n object - anything - The object to dump. [name] - string - A name to use for the object. [known] - table - A table of object,string pairs. Any object in that table will not be dumped, the string will be printed instead. defaults to darktable.debug.known if not set return - string - A string containing a text description of the object - can be very long.  🔗darktable.debug.debug boolean\nInitialized to false; set it to true to also dump information about metatables.\n🔗darktable.debug.max_depth number\nInitialized to 10; The maximum depth to recursively dump content.\n🔗darktable.debug.known table\nA table containing the default value of darktable.debug.dump.known\n🔗darktable.debug.type function( object : anything ) : string Similar to the system function type() but it will return the real type instead of userdata for darktable specific objects.\n object - anything - The object whose type must be reported. return - string - A string describing the type of the object.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.debug/","tags":null,"title":"darktable.debug"},{"categories":null,"content":"The colorpicker menu\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/colorpicker/","tags":null,"title":"darktable.gui.libs.colorpicker"},{"categories":null,"content":"The slideshow view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/slideshow/","tags":null,"title":"darktable.gui.views.slideshow"},{"categories":null,"content":"enum\nThe different ways in which a collection filter can be compared\nValues:\n DT_COLLECTION_RATING_COMP_LT DT_COLLECTION_RATING_COMP_LEQ DT_COLLECTION_RATING_COMP_EQ DT_COLLECTION_RATING_COMP_GEQ DT_COLLECTION_RATING_COMP_GT DT_COLLECTION_RATING_COMP_NE DT_COLLECTION_RATING_N_COMPS  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_rating_comperator_t/","tags":null,"title":"dt_collection_rating_comperator_t"},{"categories":null,"content":"🔗NAME executable_path_widget\n🔗SYNOPSIS create a widget to get executable path preferences\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local widget = df.executable_path_widget(executables) executables - table - a table of strings that are executable names\n🔗DESCRIPTION executable_path_widget takes a table of executable names and builds a set of file selector widgets to get the path to the executable. The resulting widgets are wrapped in a box widget and returned.\n🔗RETURN VALUE widget - widget - a widget containing a file selector widget for each executable.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/executable_path_widget/","tags":null,"title":"executable_path_widget"},{"categories":null,"content":"🔗Name generate_image_txt.lua - generate text metadata\n🔗Description A script to run a command on images to generate text metadata\nThe medata will be displayed as an overlay on the image in lighttable mode\n🔗Usage  start this script from script manager set a command to run on all image, this command should output text on stdout enable image file generation  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/generate_image_txt/","tags":null,"title":"generate_image_txt"},{"categories":null,"content":"🔗Name moduleExample.lua - create a new example lighttable module\n🔗Description More informations about building user interface elements: https://www.darktable.org/usermanual/ch09.html.php#lua_gui_example And about new_widget here: https://www.darktable.org/lua-api/index.html.php#darktable_new_widget\n🔗Usage   start this script from script manager\n  it creates a new example lighttable module\n  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/moduleexample/","tags":null,"title":"moduleExample"},{"categories":null,"content":"event\nThis event is triggered whenever the image under the mouse changes\n🔗mouse-over-image-changed.callback function( event : string, image : types.dt_lua_image_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The new image under the mouse, can be nil if there is no image under the mouse  🔗mouse-over-image-changed.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/mouse-over-image-changed/","tags":null,"title":"mouse-over-image-changed"},{"categories":null,"content":"🔗NAME spairs\n🔗SYNOPSIS an iterator that provides sorted pairs from a table\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; for key, value in du.spairs(t, order) do -- do something end t - table - table of key, value pairs order - function - an optional function to sort the pairs, if none is supplied, table.sort() is used\n🔗DESCRIPTION spairs is an iterator that returns key, value pairs from a table in sorted order. The sorting order is the result of table.sort() if no function is supplied, otherwise sorting is done as specified in the function.\n🔗EXAMPLE HighScore = { Robin = 8, Jon = 10, Max = 11 } -- basic usage, just sort by the keys for k,v in spairs(HighScore) do print(k,v) end --\u0026gt; Jon 10 --\u0026gt; Max 11 --\u0026gt; Robin 8 -- this uses an custom sorting function ordering by score descending for k,v in spairs(HighScore, function(t,a,b) return t[b] \u0026lt; t[a] end) do print(k,v) end --\u0026gt; Max 11 --\u0026gt; Jon 10 --\u0026gt; Robin 8 🔗REFERENCE Code copied from http://stackoverflow.com/questions/15706270/sort-a-table-in-lua\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/spairs/","tags":null,"title":"spairs"},{"categories":null,"content":"🔗NAME strip_accents\n🔗SYNOPSIS strip accents from characters\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.strip_accents(str) str - string - the string with characters that need accents removed\n🔗DESCRIPTION strip_accents removes accents from accented characters returning the unaccented character.\n🔗RETURN VALUE result - string - the string containing unaccented characters\n🔗REFERENCE Copied from https://forums.coronalabs.com/topic/43048-remove-special-characters-from-string/\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/strip_accents/","tags":null,"title":"strip_accents"},{"categories":null,"content":"A table containing all the film objects in the database.\n🔗darktable.films.# types.dt_lua_film_t\nEach film has a numeric entry in the database. See types.dt_lua_film_t.\n🔗darktable.films.new function( directory : string ) : types.dt_lua_film_t Creates a new empty film\nsee darktable.database.import to import a directory with all its images and to add images to a film\n directory - string - The directory that the new film will represent. The directory must exist return - types.dt_lua_film_t - The newly created film, or the existing film if the directory is already imported  🔗darktable.films.delete see types.dt_lua_film_t.delete\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.films/","tags":null,"title":"darktable.films"},{"categories":null,"content":"The UI element that manipulates history\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/copy_history/","tags":null,"title":"darktable.gui.libs.copy_history"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t ):int Gets the size in pixels of the specified panel. This only works for the left, right, and bottom panels.\n panel - types.dt_ui_panel_t - The panel to get the size of.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_get_size/","tags":null,"title":"darktable.gui.panel_get_size"},{"categories":null,"content":"The tethering view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/tethering/","tags":null,"title":"darktable.gui.views.tethering"},{"categories":null,"content":"enum\nThe different orders that a collection can be sorted in\nValues:\n DT_COLLECTION_SORT_ORDER_ASCENDING DT_COLLECTION_SORT_ORDER_DESCENDING  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_sort_order_t/","tags":null,"title":"dt_collection_sort_order_t"},{"categories":null,"content":"🔗Name enfuseAdvanced.lua - process HDR or focus stacked images\n🔗Description This plugin will add the new export module \u0026lsquo;fusion to DRI or DFF image\u0026rsquo;.\nDRI = Dynamic Range Increase (Blend multiple bracket images into a single LDR file)\nDFF = Depth From Focus (\u0026lsquo;Focus Stacking\u0026rsquo; - Blend multiple images with different focus into a single image)\n🔗Usage Start this script using script manager.\nSelect multiple images that are either bracketed, or focus-shifted, set your desired operating parameters, and press the export button. A new image will be created. The image will be auto imported into darktable if you have that option enabled. Additional tags or style can be applied on auto import as well, if you desire.\n🔗image align options See align_image_stack documentation for further explanation of how it specifically works and the options provided (http://hugin.sourceforge.net/docs/manual/Align_image_stack.html)\n🔗image fustion options See enfuse documentation for further explanation of how it specifically works and the options provided (https://wiki.panotools.org/Enfuse) If you have a specific set of parameters you frequently like to use, you can save them to a preset. There are 3 presets available for DRI, and 3 for DFF.\n🔗target file Select your file destination path, or check the \u0026lsquo;save to source image location\u0026rsquo; option. \u0026lsquo;Create Unique Filename\u0026rsquo; is enabled by default at startup, the user can choose to overwrite existing Set any tags or style you desire to be added to the new image (only available if the auto-import option is enabled). You can also change the defaults for this under settings \u0026gt; lua options\n🔗format options Same as other export modules\n🔗global options Same as other export modules\n🔗Additional Software Required align_image_stack enfuse ver. 4.2 or greater exiftool\n🔗Limitations 🔗Author Kevin Ertel\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/enfuseadvanced/","tags":null,"title":"enfuseAdvanced"},{"categories":null,"content":"🔗NAME file_copy\n🔗SYNOPSIS copy a file to another name/location\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.file_copy(fromFile, toFile) fromFile - string - name of file to copy from\ntoFile - string - name of file to copy to\n🔗DESCRIPTION copy a file using a succession of methods from operating system to a pure lua solution\n🔗RETURN VALUE result - boolean - nil on error, true on success\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/file_copy/","tags":null,"title":"file_copy"},{"categories":null,"content":"🔗Name image_path_in_ui.lua - Add a widget with the path of the selected images\n🔗Description Add a widget with the path of the selected images for easy copy/past Simple shortcuts to have multiple selection bufers\nThis plugin will add a widget at the bottom of the left column in lighttable mode\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Jérémy Rosen\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/image_path_in_ui/","tags":null,"title":"image_path_in_ui"},{"categories":null,"content":"🔗Name multi_os.lua - an example script that runs on linux, MacOS, and Windows.\n🔗Description multi_os is an example of how to write a script that will run on different operating systems. It uses the lua-scripts libraries to lessen the amount of code that needs to be written, as well as gaining access to tested cross-platform routines. This script also performs a function that some may find useful. It creates a button in the lighttable selected images module that extracts the embedded jpeg image from a raw file, then imports it and groups it with the raw file. A keyboard shortcut is also created. A key combination can be assigned to the shortcut in the lua preferences and then the action can be invoked by hovering over the image and pressing the key combination.\n🔗Usage  start this script from script manager start darktable, open prefreences, go to lua options and update the executable location if you are running Windows or MacOS, then restart darktable. select an image or images click the button to extract the jpeg  🔗Additional Software Required  ufraw-batch - https://ufraw.sourceforge.net MacOS - install with homebrew  🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/multi_os/","tags":null,"title":"multi_os"},{"categories":null,"content":"event\nThis event is triggered when an film import is finished (all post-import-image callbacks have already been triggered). This event can be registered multiple times.\n🔗post-import-film.callback function( event : string, film : types.dt_lua_film_t )  event - string - The name of the event that triggered the callback. film - types.dt_lua_film_t - The new film that has been added. If multiple films were added recursively only the top level film is reported.  🔗post-import-film.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/post-import-film/","tags":null,"title":"post-import-film"},{"categories":null,"content":"🔗NAME split\n🔗SYNOPSIS split a string on a specified separator\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local result = du.split(str, pat) str - string - the string to split\npat - string - the pattern to split on\n🔗DESCRIPTION split separates a string into a table of strings. The strings are separated at each occurrence of the supplied pattern. The pattern may be any pattern as described in the lua docs. Each match of the pattern is consumed and not returned.\n🔗RETURN VALUE result - table - a table of strings on success, or an empty table on error\n🔗EXAMPLE split(\u0026quot;/a/long/path/name/to/a/file.txt\u0026quot;, \u0026quot;/\u0026quot;) would return a table like\n{\u0026quot;a\u0026quot;, \u0026quot;long\u0026quot;, \u0026quot;path\u0026quot;, \u0026quot;name\u0026quot;, \u0026quot;to\u0026quot;, \u0026quot;a\u0026quot;, \u0026quot;file.txt\u0026quot;} 🔗REFERENCE http://lua-users.org/wiki/SplitJoin\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/split/","tags":null,"title":"split"},{"categories":null,"content":"🔗NAME urlencode\n🔗SYNOPSIS encode a string in a websage manner\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.urlencode(str) str - string - the string that needs to be made websafe\n🔗DESCRIPTION urlencode converts a string into a websafe version suitable for use in a web browser.\n🔗RETURN VALUE result - string - a websafe string\n🔗REFERENCE https://forums.coronalabs.com/topic/43048-remove-special-characters-from-string\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/urlencode/","tags":null,"title":"urlencode"},{"categories":null,"content":"table\nThis table contains functions related to translating lua scripts\n🔗darktable.gettext.gettext function( msgid : string ) : string Translate a string using the darktable textdomain\n msgid - string - The string to translate return - string - The translated string  🔗darktable.gettext.dgettext function( domainname : string, msgid : string ) : string Translate a string using the specified textdomain\n domainname - string - The domain to use for that translation msgid - string - The string to translate return - string - The translated string  🔗darktable.gettext.ngettext function( msgid : string, msgid_plural : string, n : int ) : string Translate a string depending on the number of objects using the darktable textdomain\n msgid - string - The string to translate msgid_plural - string - The string to translate in plural form n - int - The number of objects return - string - The translated string  🔗darktable.gettext.dngettext function( domainname : string, msgid : string, msgid_plural : string, n : int ) : string Translate a string depending on the number of objects using the specified textdomain\n domainname - string - The domain to use for that translation msgid - string - The string to translate msgid_plural - string - The string to translate in plural form n - int - The number of objects return - string - The translated string  🔗darktable.gettext.bindtextdomain function( domainname : string, dirname : string ) Tell gettext where to find the .mo file translating messages for a particular domain\n domainname - string - The domain to use for that translation dirname - string - The base directory to look for the file. The file should be placed in dirname/locale name/LC_MESSAGES/domain.mo  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.gettext/","tags":null,"title":"darktable.gettext"},{"categories":null,"content":"The darktable logo in the upper left corner\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/darktable_label/","tags":null,"title":"darktable.gui.libs.darktable_label"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t ) Hides the specified panel.\n panel - types.dt_ui_panel_t - The panel to hide.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_hide/","tags":null,"title":"darktable.gui.panel_hide"},{"categories":null,"content":"enum\nThe different elements on which a collection can be sorted\nValues:\n DT_COLLECTION_SORT_NONE DT_COLLECTION_SORT_FILENAME DT_COLLECTION_SORT_DATETIME DT_COLLECTION_SORT_IMPORT_TIMESTAMP DT_COLLECTION_SORT_CHANGE_TIMESTAMP DT_COLLECTION_SORT_EXPORT_TIMESTAMP DT_COLLECTION_SORT_PRINT_TIMESTAMP DT_COLLECTION_SORT_RATING DT_COLLECTION_SORT_ID DT_COLLECTION_SORT_COLOR DT_COLLECTION_SORT_GROUP DT_COLLECTION_SORT_PATH DT_COLLECTION_SORT_CUSTOM_ORDER DT_COLLECTION_SORT_TITLE DT_COLLECTION_SORT_DESCRIPTION DT_COLLECTION_SORT_ASPECT_RATIO DT_COLLECTION_SORT_SHUFFLE  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_sort_t/","tags":null,"title":"dt_collection_sort_t"},{"categories":null,"content":"🔗Name 🔗Description Given a haldCLUT identity file this script generates haldCLUTS from all the user\u0026rsquo;s styles and exports them to a location of their choosing.\n🔗Usage Start this script from script manager.\n🔗Additional Software Required 🔗Limitations Warning: during export if a naming collision occurs the older file is automatically overwritten silently.\n🔗Author Noah Clarke\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/exportlut/","tags":null,"title":"exportLUT"},{"categories":null,"content":"🔗NAME file_move\n🔗SYNOPSIS move a file from one directory to another\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.file_move(fromFile, toFile) fromFile - string - name of the original file\ntoFile - string - the new file location and name\n🔗DESCRIPTION Move a file from one place to another. Try a succession of methods from builtin to operating system to a pure lua solution.\n🔗RETURN VALUE result - boolean - nil on error, some value on success\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/file_move/","tags":null,"title":"file_move"},{"categories":null,"content":"🔗Name import_filter_manager.lua - add a dropdown list with import filters to the import dialog\n🔗Description This script adds a dropdown list with import filters to the import dialog. Scripts can add new filters by registering them with darktable.register_import_filter(name, callback) The callback has type function(event, images), i.e., it is the same as when directly registering the pre-import event.\n🔗Usage  start this script from script manager also require some files with import filters, for example import_filters.lua. it is important to add them AFTER this one!  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/import_filter_manager/","tags":null,"title":"import_filter_manager"},{"categories":null,"content":"🔗Name panels_demo.lua - an example script demonstrating how to contol panel visibility\n🔗Description panels_demo is an example script showing how to control panel visibility. It cycles through the panels hiding them one by one, then showing them one by one, then hiding all, then showing all. Finally, the original panel visibility is restored.\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author 🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/panels_demo/","tags":null,"title":"panels_demo"},{"categories":null,"content":"event\nThis event is triggered whenever a new image is imported into the database. This event can be registered multiple times, all callbacks will be called. The call is blocking.\n🔗post-import-image.callback function( event : string, image : types.dt_lua_image_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The image object that has been imported.  🔗post-import-image.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/post-import-image/","tags":null,"title":"post-import-image"},{"categories":null,"content":"The export menu\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/export/","tags":null,"title":"darktable.gui.libs.export"},{"categories":null,"content":"function( ) Hide all panels.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_hide_all/","tags":null,"title":"darktable.gui.panel_hide_all"},{"categories":null,"content":"enum\nThe type of compression to use for the EXR image\nValues:\n off rle zips zip piz pxr24 b44 b44a  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_exr_compression_t/","tags":null,"title":"dt_imageio_exr_compression_t"},{"categories":null,"content":"🔗Name ext_editor.lua - edit images with external editors\n🔗Description This script provides helpers to edit image files with programs external to darktable. It adds:\n a new target storage \u0026ldquo;collection\u0026rdquo;. Image exported will be reimported to collection for further editing with external programs a new lighttable module \u0026ldquo;external editors\u0026rdquo;, to select a program from a list of up to 9 external editors and run it on a selected image (adjust this limit by changing MAX_EDITORS) an option to display the module in darkroom view a set of lua preferences in order to configure name and path of up to 9 external editors a set of lua shortcuts in order to quick launch the external editors  🔗Usage  start this script with script manager  🔗setup  in \u0026ldquo;preferences/lua options\u0026rdquo; configure name and path/command of external programs note that if a program name is left empty, that and all following entries will be ignored in \u0026ldquo;preferences/shortcuts/lua\u0026rdquo; configure shortcuts for external programs (optional) whenever programs preferences are changed, in lighttable/external editors, press \u0026ldquo;update list\u0026rdquo;  🔗use   in the export dialog choose \u0026ldquo;collection\u0026rdquo; and select the format and bit depth for the exported image\n  press \u0026ldquo;export\u0026rdquo;\n  the exported image will be imported into collection and grouped with the original image\n  in lighttable, select an image for editing with en external program (or in darkroom for the image being edited):\n  in external editors GUI, select program and press \u0026ldquo;edit\u0026rdquo;\n  edit the image with the external editor, overwite the file, quit the external program\n  the selected image will be updated or\n  in lighttable/external editors, select program and press \u0026ldquo;edit a copy\u0026rdquo;\n  edit the image with the external editor, overwite the file, quit the external program\n  a copy of the selected image will be created and updated or\n  in lighttable select target storage \u0026ldquo;collection\u0026rdquo;\n  enter in darkroom\n  to create an export or a copy press CRTL+E\n  use the shortcut to edit the current image with the corresponding external editor\n  overwite the file, quit the external program\n  the darkroom view will be updated\n  warning: mouseover on lighttable/filmstrip will prevail on current image\n  this is the default DT behavior, not a bug of this script\n  🔗Additional Software Required 🔗Limitations  MAC compatibility not tested  🔗Author Marco Carrarini - marco.carrarini@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/ext_editor/","tags":null,"title":"ext_editor"},{"categories":null,"content":"🔗NAME filename_increment\n🔗SYNOPSIS add a two digit increment to a filename\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.filename_increment(filepath) filepath - string - filename to increment\n🔗DESCRIPTION filename_increment solves the problem of filename conflict by adding an increment to the filename. If the supplied filename has no increment then \u0026ldquo;01\u0026rdquo; is added to the basename. If the filename already has an increment, then 1 is added to it and the filename returned.\n🔗RETURN VALUE result - string - the incremented filename\n🔗LIMITATIONS The filename will be incremented to a maximum of 99.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/filename_increment/","tags":null,"title":"filename_increment"},{"categories":null,"content":"🔗Name import_filters.lua - add filters for import_filter_manager\n🔗Description This script goes along with the import filter manager. It adds two filters:\n ignore jpegs: this one does the same as the existing option in the import dialog and just skips all JPEGs during import. prefer raw over jpeg: this one is a bit more elaborate, it ignores JPEGs when there is also another file with the same basename, otherwise it allows JPEGs, too.  🔗Usage  start this script from script manager AFTER import_filter_manager.lua  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus \u0026amp; Christian Mandel\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/import_filters/","tags":null,"title":"import_filters"},{"categories":null,"content":"event\nThis event is trigger before any import action\n🔗pre-import.callback function( event : string, images : table of string )  event - string - The name of the event that triggered the callback. images - table of string - The files that will be imported. Modifying this table will change the list of files that will be imported.  🔗pre-import.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/pre-import/","tags":null,"title":"pre-import"},{"categories":null,"content":"🔗Name preferenceExample.lua - show the different preference types that are possible with Lua\n🔗Description darktable script to show the different preference types that are possible with Lua\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/preferenceexamples/","tags":null,"title":"preferenceExample"},{"categories":null,"content":"The filmstrip at the bottom of some views\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/filmstrip/","tags":null,"title":"darktable.gui.libs.filmstrip"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t size : int ) Sets the size in pixels of the specified panel. This only works for the left, right, and bottom panels.\n panel - types.dt_ui_panel_t - The panel to set the size of. size - int - The size to set the panel to.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_set_size/","tags":null,"title":"darktable.gui.panel_set_size"},{"categories":null,"content":"table\nGuide lines to overlay over an image in crop and rotate. All guides are clipped to the drawing area.\n🔗darktable.guides.register_guide function( name : string, draw_callback : function, [gui_callback : function] ) Register a new guide.\n name - string - The name of the guide to show in the GUI. draw_callback - function - The function to call to draw the guide lines. [gui_callback] - function - A function returning a widget to show when the guide is selected. It takes no arguments.  draw_callback -\nfunction( cr : types.dt_lua_cairo_t, x : float, y : float, width : float, height : float, zoom_scale : float ) The function to call to draw the guide lines. The drawn lines will be stroked by darktable. THIS IS RUNNING IN THE GUI THREAD AND HAS TO BE FAST!\n cr - types.dt_lua_cairo_t - The cairo object used for drawing. x - float - The x coordinate of the top left corner of the drawing area. y - float - The y coordinate of the top left corner of the drawing area. width - float - The width of the drawing area. height - float - The height of the drawing area. zoom_scale - float -The current zoom_scale. Only needed when setting the line thickness.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.guides/","tags":null,"title":"darktable.guides"},{"categories":null,"content":"enum\nJ2K format type\nValues:\n j2k jp2  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_j2k_format_t/","tags":null,"title":"dt_imageio_j2k_format_t"},{"categories":null,"content":"🔗Name face_recognition.lua - add a new storage option and calls face_recognition after export\n🔗Description Add a new storage option to send images to face_recognition. Images are exported to darktable tmp dir first. A directory with known faces must exist, the image name are the tag names which will be used. Multiple images for one face can exist, add a number to it, the number will be removed from the tag, for example: People|IknowYou1.jpg People|IknowYou2.jpg People|Another.jpg People|Youtoo.jpg\n🔗Usage  start this script from script manager.  🔗Additional Software Required  https://github.com/ageitgey/face_recognition https://github.com/darktable-org/lua-scripts/tree/master/lib  🔗Limitations 🔗Author Sebastian Witt\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/face_recognition/","tags":null,"title":"face_recognition"},{"categories":null,"content":"🔗NAME get_basename\n🔗SYNOPSIS get the filename without the path or extension\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_basename(filepath) filepath - string - path and filename\n🔗DESCRIPTION get_basename returns the name of the file without the path or filetype.\n🔗RETURN VALUE result - string - the basename of the file\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_basename/","tags":null,"title":"get_basename"},{"categories":null,"content":"🔗Name printExamples.lua - prints \u0026ldquo;hello world\u0026rdquo; when darktable starts\n🔗Description prints \u0026ldquo;hello world\u0026rdquo; to the screen when darktable starts\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/printexamples/","tags":null,"title":"printExamples"},{"categories":null,"content":"🔗Name save_selection.lua - simple shortcuts to have multiple selection buffers\n🔗Description Simple shortcuts to have multiple selection buffers\n🔗Usage  start this script from script manager go to configuration =\u0026gt; preferences =\u0026gt; lua set the shortcuts you want to use  This plugin will provide shortcuts to save to and restore from up to five temporary buffers\nThis plugin also provides a shortcut to swap the current selection with a quick-swap buffer\nThe variable \u0026ldquo;buffer_count\u0026rdquo; controls the number of selection buffers, increase it if you need more temporary selection buffers\n🔗Additional Software Required 🔗Limitations 🔗Author Jérémy Rosen\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/save_selection/","tags":null,"title":"save_selection"},{"categories":null,"content":"event\nThis event is triggered whenever the selection of images changes\n🔗selection-changed.callback function( event : string )  event - string - The name of the event that triggered the callback.  🔗selection-changed.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/selection-changed/","tags":null,"title":"selection-changed"},{"categories":null,"content":"🔗Name fujifilm_dynamic_range.lua - adjust darktable exposure by Fujifilm raw exposure bias\n🔗Description Support for adjusting darktable exposure by Fujifilm raw exposure bias. This corrects for a DR100/DR200/DR400 \u0026ldquo;dynamic range\u0026rdquo; setting.\nBased upon fujifilm_ratings by Ben Mendis\nThe relevant tag is RawExposureBias (0x9650). This appears to represent the shift in EV for the chosen DR setting (whether manual or automatic). Note that even at 100DR (\u0026ldquo;standard\u0026rdquo;) there is an EV shift:\n100 DR -\u0026gt; -0.72 EV 200 DR -\u0026gt; -1.72 EV 400 DR -\u0026gt; -2.72 EV\nThe ideal would be to use exiv2 to read this tag, as this is the same code which darktable import uses. Unfortunately, exiv2 as of v0.27.3 can\u0026rsquo;t read this tag. As it is encoded as a 4-byte ratio of two signed shorts \u0026ndash; a novel data type \u0026ndash; it will require some attention to fix this.\nThere is an exiv2-readable DevelopmentDynamicRange tag which maps to RawExposureBias as above. DevelopmentDynamicRange is only present when tag DynamicRangeSetting (0x1402) is Manual/Raw (0x0001). When it is Auto (0x0000), the equivalent data is tag AutoDynamicRange (0x140b). But exiv2 currently can\u0026rsquo;t read that tag either.\nHence for now this code uses exiftool to read RawExposureBias, as a more general solution. As exiftool is approx. 10x slower than exiv2 (Perl vs. C++), this may slow large imports.\nThese tags have been checked on a Fujifilm X100S and X100V. Other cameras may behave in other ways.\n🔗Usage Start this script from script manager\n🔗Additional Software Required exiftool (https://www.sno.phy.queensu.ca/~phil/exiftool/)\n🔗Limitations 🔗Author Dan Torop dant@pnym.net\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/fujifilm_dynamic_range/","tags":null,"title":"fujifilm_dynamic_range"},{"categories":null,"content":"The image-filter menus at the top of the UI\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.filter.sort function( [sort : types.dt_collection_sort_t] ) : types.dt_collection_sort_t Change the collection sort field.\n [sort] - types.dt_collection_sort_t - The new field to sort by. If empty the current sort field is unchanged return - types.dt_collection_sort_t = The current sort field.  🔗darktable.gui.libs.filter.sort_order function( [order : types.dt_collection_sort_order_t] ) : types.dt_collection_sort_order_t Change the collection sort order.\n [order] - types.dt_collection_sort_order_t - The order to sort by. If empty the current sort order is unchanged. return - types.dt_collection_sort_order_t - The current sort order.  🔗darktable.gui.libs.filter.rating function( [rating : types.dt_collection_filter_t] ) : types.dt_collection_filter_t Change the collection rating filter.\n [rating] - types.dt_collection_filter_t - The new rating field to filter by. If empty the current rating field is unchanged. return - types.dt_collection_filter_t - The current rating field.  🔗darktable.gui.libs.filter.rating_comparator function( [comparator : types.dt_collection_rating_comperator_t] ) : types.dt_collection_rating_comperator_t Change the collection filter comparison field.\n [comparator] - types.dt_collection_rating_comperator_t - The new comparison field to filter the rating by. If empty the current rating comparison field is unchanged return - types.dt_collection_rating_comperator_t - The current rating comparison field  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/filter/","tags":null,"title":"darktable.gui.libs.filter"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t ) Shows the specified panel.\n panel - types.dt_ui_panel_t - The panel to show.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_show/","tags":null,"title":"darktable.gui.panel_show"},{"categories":null,"content":"function( type : string ) : types.dt_imageio_module_format_t Creates a new format object to export images\n  type - string - The type of format object to create, one of :\n copy exr j2k jpeg pdf pfm png ppm tiff webp    return - types.dt_imageio_module_format_t - The newly created object. Exact type depends on the type passed\n  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.new_format/","tags":null,"title":"darktable.new_format"},{"categories":null,"content":"enum\nJ2K preset type\nValues:\n off cinema2k_24 cinema2k_48 cinema4k_24  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_j2k_preset_t/","tags":null,"title":"dt_imageio_j2k_preset_t"},{"categories":null,"content":"🔗Name fujifilm_ratings.lua - support for importing Fujifilm in-camera ratings in darktable\n🔗Description Support for importing Fujifilm in-camera ratings in darktable.\n🔗Usage Start this script from script manager\n🔗Additional Software Required exiftool (https://www.sno.phy.queensu.ca/~phil/exiftool/)\n🔗Limitations 🔗Author Ben Mendis - ben.mendis@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/fujifilm_ratings/","tags":null,"title":"fujifilm_ratings"},{"categories":null,"content":"🔗NAME get_executable_path_preference\n🔗SYNOPSIS return the path to an executable from a preference\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_executable_path_preference(executable) executable - string - the name of the executable to get the path for\n🔗DESCRIPTION get_executable_path_preference returns the path preference to the requested executable.\n🔗RETURN VALUE result - string - path to the executable\n🔗LIMITATIONS executable should be the basename of the executable without extensions\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_executable_path_preference/","tags":null,"title":"get_executable_path_preference"},{"categories":null,"content":"🔗Name running_os.lua - prints the operating system\n🔗Description prints the operating system\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/running_os/","tags":null,"title":"running_os"},{"categories":null,"content":"🔗Name selection_to_pdf.lua - generate a PDF file (via Latex) containing all selected images\n🔗Description Generates a PDF file (via Latex) containing all selected images\nThis plugin will add a new exporter that will allow you to generate the pdf file\nPlugin allows you to choose how many thumbnails you need per row\n🔗Usage  start this script from script manager  🔗Additional Software Required  a PDF-Viewer pdflatex (Latex)  🔗Limitations 🔗Author Jérémy Rosen \u0026amp; Pascal Obry\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/selection_to_pdf/","tags":null,"title":"selection_to_pdf"},{"categories":null,"content":"event\nThis event registers a new keyboard shortcut. The shortcut isn\u0026rsquo;t bound to any key until the users does so in the preference panel. The event is triggered whenever the shortcut is triggered. This event can only be registered once per value of shortcut.\n🔗shortcut.callback function( event : string, shortcut : string )  event - string - The name of the event that triggered the callback. shortcut - string - The tooltip string that was given at registration time.  🔗shortcut.extra registration parameters  tooltip - string - The string that will be displayed on the shortcut preference panel describing the shortcut.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/shortcut/","tags":null,"title":"shortcut"},{"categories":null,"content":"The geotagging time synchronisation UI\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/geotagging/","tags":null,"title":"darktable.gui.libs.geotagging"},{"categories":null,"content":"function( ) Show all panels.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_show_all/","tags":null,"title":"darktable.gui.panel_show_all"},{"categories":null,"content":"function( type : string ) : types.dt_imageio_module_storage_t Creates a new storage object to export images.\n  type - string - The type of storage object to create, one of:\n disk email gallery latex piwigo (Other, lua-defined, storage types may appear.)    return - [types.dt_imageio_module_storage_t(../../types/dt_imageio_module_storage_t)] - The newly created object. Exact type depends on the type passed\n  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.new_storage/","tags":null,"title":"darktable.new_storage"},{"categories":null,"content":"dt_type\nType object describing parameters to export to copy.\nAttributes:\n parent : types.dt_imageio_module_format_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_copy/","tags":null,"title":"dt_imageio_module_format_data_copy"},{"categories":null,"content":"🔗Name geoJSON_export.lua - export a geoJSON file from selected images\n🔗Description darktable geoJSON export script\n🔗Usage  start this script using script manager  🔗Additional Software Required  mkdir convert (ImageMagick) xdg-open xdg-user-dir  🔗Limitations This script is only tested with Linux\n🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/geojson_export/","tags":null,"title":"geoJSON_export"},{"categories":null,"content":"🔗NAME get_filename\n🔗SYNOPSIS get the filename and extension from a file path\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_filename(filepath) filepath - string - path and filename\n🔗DESCRIPTION get_filename strips the path from a filepath and returns the filename\n🔗RETURN VALUE result - string - the file name and type\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_filename/","tags":null,"title":"get_filename"},{"categories":null,"content":"event\nThis event is triggered after the user changed the active view\n#view-changed.callback\nfunction( event : string, old_view : types.dt_lua_view_t, new_view : types.dt_lua_view_t )  event - string - The name of the event that triggered the callback. old_view - types.dt_lua_view_t - The view that we just left new_view - types.dt_lua_view_t - The view we are now in  #view-changed.extra registration parameters\nThis event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/view-changed/","tags":null,"title":"view_changed"},{"categories":null,"content":"The common tools to all view (settings, grouping\u0026hellip;)\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.global_toolbox.grouping boolean- The current status of the image grouping option\nAttributes:\n write  🔗darktable.gui.libs.global_toolbox.show_overlays boolean - the current status of the image overlays option\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/global_toolbox/","tags":null,"title":"darktable.gui.libs.global_toolbox"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t ) : boolean Determines if the specified panel is visible.\n panel - types.dt_ui_panel_t - The panel to check. return - boolean - true if the panel is visible, false if not  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_visible/","tags":null,"title":"darktable.gui.panel_visible"},{"categories":null,"content":"function( type : string, ... : variable ) : types.lua_widget Creates a new widget object to display in the UI.\n  type - string - The type of storage object to create, one of:\n box button check_button combobox container entry file_chooser_button label section_label separator slider stack text_view    \u0026hellip; - variable - Extra parameters, exact value are documented with each type\n  return - types.lua_widget - The newly created object. Exact type depends on the type passed\n  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.new_widget/","tags":null,"title":"darktable.new_widget"},{"categories":null,"content":"dt_type\nType object describing parameters to export to exr.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_exr.compression string\nThe compression parameter to use when exporting.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_exr/","tags":null,"title":"dt_imageio_module_format_data_exr"},{"categories":null,"content":"🔗Name geoToolbox.lua - a module of geo tools\n🔗Description  it creates a new geoToolbox lighttable module  🔗Usage  require this script from your main lua file To do this add this line to the file .config/darktable/luarc: require \u0026ldquo;geoToolbox\u0026rdquo;  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/geotoolbox/","tags":null,"title":"geoToolbox"},{"categories":null,"content":"🔗NAME get_filetype\n🔗SYNOPSIS get the filetype from a filename\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_filetype(filepath) filepath - string - path and filename\n🔗DESCRIPTION get_filetype returns the filetype from the supplied filepath\n🔗RETURN VALUE result - string - the filetype\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_filetype/","tags":null,"title":"get_filetype"},{"categories":null,"content":"The small line of text at the top of the UI showing the number of selected images\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/hinter/","tags":null,"title":"darktable.gui.libs.hinter"},{"categories":null,"content":"function( [selection : table of types.dt_lua_image_t] ) : table of types.dt_lua_image_t Get or change the set of selected images.\nAttributes: implicit_yield\n [selection] - table of types.dt_lua_image_t - A table of images which will define the selected images. If this parameter is not given the selection will be untouched. If an empty table is given the selection will be emptied. return - table of types.dt_lua_image_t - A table containing the selection as it was before the function was called.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/selection/","tags":null,"title":"darktable.gui.selection"},{"categories":null,"content":"Store and retrieve credentials using the darktable password storage backend.\n🔗darktable.password.save function( application : string, username : string, password : string ) :boolean Save a username/password pair for use accessing an application.\n application - string - Name of application or website. username - string - The username used to access the application or website. password - string - The credential used to authenticate the username. return - boolean - True if the credentials are saved, false if they are not.  🔗darktable.password.get function( application : string, username : string ) :string Retrieves the password associated with the username for the application.\n application - string - Name of application or website. username - string - The username used to access the application or website. return - string - The credentials used to authenticate the user. Nil is returned if there is an error or the crendentials don\u0026rsquo;t exist.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.password/","tags":null,"title":"darktable.password"},{"categories":null,"content":"dt_type\nType object describing parameters to export to jpeg2000.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_j2k.quality number\nThe quality to use at export time.\nAttributes:\n write  🔗dt_imageio_module_format_data_j2k.bpp number\nThe bpp parameter to use when exporting.\nAttributes:\n write  🔗dt_imageio_module_format_data_j2k.format types.dt_imageio_j2k_format_t\nThe format to use.\nAttributes:\n write  🔗dt_imageio_module_format_data_j2k.preset types.dt_imageio_j2k_preset_t\nThe preset to use.\nAttributes: 62\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_j2k/","tags":null,"title":"dt_imageio_module_format_data_j2k"},{"categories":null,"content":"🔗NAME get_path\n🔗SYNOPSIS get the path from a file path\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_path(filepath) filepath - string - path and filename\n🔗DESCRIPTION get_path strips the filename and filetype from a path and returns the path\n🔗RETURN VALUE result - string - the path\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_path/","tags":null,"title":"get_path"},{"categories":null,"content":"🔗Name gimp.lua - export and edit with GIMP\n🔗Description This script provides another storage (export target) for darktable. Selected images are exported in the specified format to temporary storage. GIMP is launched and opens the files. After editing, the exported images are overwritten to save the changes. When GIMP exits, the exported files are moved into the current collection and imported into the database. The imported files then show up grouped with the originally selected images.\n🔗Usage  start this script using script manager select an image or images for editing with GIMP in the export dialog select \u0026ldquo;Edit with GIMP\u0026rdquo; and select the format and bit depth for the exported image. Check the \u0026ldquo;run_detached\u0026rdquo; button to run GIMP in detached mode. Images will not be returned to darktable in this mode, but additional images can be sent to GIMP without stopping it. Press \u0026ldquo;export\u0026rdquo; Edit the image with GIMP then save the changes with File-\u0026gt;Overwrite\u0026hellip;. Exit GIMP The edited image will be imported and grouped with the original image  🔗Additional Software Required  GIMP - http://www.gimp.org  🔗Limitations  There is no provision for dealing with the xcf files generated by GIMP, since darktable doesn\u0026rsquo;t deal with them. You may want to save the xcf file if you intend on doing further edits to the image or need to save the layers used. Where you save them is up to you.  🔗Author Bill Ferguson - wpferguson@gmail.com\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/gimp/","tags":null,"title":"gimp"},{"categories":null,"content":"The histogram widget\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/histogram/","tags":null,"title":"darktable.gui.libs.histogram"},{"categories":null,"content":"table\nLua allows you to manipulate preferences. Lua has its own namespace for preferences and you can\u0026rsquo;t write normal darktable preferences. Preference handling functions take a script parameter. This is a string used to avoid name collision in preferences (i.e namespace). Set it to something unique, usually the name of the script handling the preference. Preference handling functions can\u0026rsquo;t guess the type of a parameter. You must pass the type of the preference you are handling. Note that the directory, enum, lua and file type preferences are stored internally as string. The user can only select valid values, but a lua script can set it to any string\n🔗darktable.preferences.register function( script : string, name : string, type : types.lua_pref_type, label : string, tooltip : string, [default : depends on type], [min : int or float], [max : int or float], [step : float], [values : string...], [widget : types.lua_widget], [set_callback : function] ) Creates a new preference entry in the Lua tab of the preference screen. If this function is not called the preference can\u0026rsquo;t be set by the user (you can still read and write invisible preferences).\n script - string - Invisible prefix to guarantee unicity of preferences. name - string - A unique name used with the script part to identify the preference. type - _types.lua_pref_type_The type of the preference - one of the string values described above. label - string - The label displayed in the preference screen. tooltip - string - The tooltip to display in the preference menu. [default] - Thedepends on type - Default value to use when not set explicitly or by the user. For the enum type of pref, this is mandatory [mi] - int or float - Minimum value (integer and float preferences only). [max] - int or float - Maximum value (integer and float preferences only). [step] - float - Step of the spinner (float preferences only). [values] - string - Other allowed values (enum preferences only) [widget] - types.lua_widget - The widget to use in preference (lua preferences only) [set_callback] - function_ - A function called when the widget needs to be updated from the preference  [set_callback] -\nfunction( widget : types.lua_widget ) A function called when the widget needs to be updated from the preference\n widget - types.lua_widget - The widget to update  🔗darktable.preferences.read function( script : string, name : string, type : types.lua_pref_type ) : depends on type Reads a value from a Lua preference.\n script - string - Invisible prefix to guarantee unicity of preferences. Specifying \u0026ldquo;darktable\u0026rdquo; as the script name allows access to the darktable core preferences. name - string - The name of the preference displayed in the preference screen. type - types.lua_pref_type - The type of the preference. return - depends on type - The value of the preference.  🔗darktable.preferences.write function( script : string, name : string, type : types.lua_pref_type, value : depends on type ) Writes a value to a Lua preference.\n script - string - Invisible prefix to guarantee unicity of preferences. name - string - The name of the preference displayed in the preference screen. type - types.lua_pref_type - The type of the preference. value - depends on type - The value to set the preference to.  🔗darktable.preferences.destroy function( script : string, name : string, ) : return boolean Destroys a lua preference key and value.\n script - string - Invisible prefix to guarantee unicity of preferences. name - string - The name of the preference displayed in the preference screen. return - boolean - True for success, false otherwise.  🔗darktable.preferences.get_keys function( script : string, name : string, ) : return table of strings Get all of the darktable core and lua preference keys and return them in a sorted table.\n return - table of string - Sorted darktable core preference and lua preference keys.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.preferences/","tags":null,"title":"darktable.preferences"},{"categories":null,"content":"dt_type\nType object describing parameters to export to jpeg.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_jpeg.quality number\nThe quality to use at export time.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_jpeg/","tags":null,"title":"dt_imageio_module_format_data_jpeg"},{"categories":null,"content":"🔗Name gpx_export.lua - gpx exporter\n🔗Description Simple darktable GPX generator script\nThis script generates a GPX track from all images having GPS latitude and longitude information. For each source folder, a separate \u0026lt;trk\u0026gt; is generated in the gpx file.\n🔗Usage 🔗Additional Software Required 🔗Limitations 🔗Author Jannis_V\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/gpx_export/","tags":null,"title":"gpx_export"},{"categories":null,"content":"🔗NAME mkdir\n🔗SYNOPSIS create the directory(ies) if they do not already exist\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; df.mkdir(path) path - string - a directory path\n🔗DESCRIPTION mkdir creates directories if they do not already exist. It creates parent directories if needed.\n🔗RETURN VALUE path - string - a directory path\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/mkdir/","tags":null,"title":"mkdir"},{"categories":null,"content":"The history manipulation menu\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/history/","tags":null,"title":"darktable.gui.libs.history"},{"categories":null,"content":"function( message : string ) Will print a string to the darktable control log (the long overlaid window that appears over the main panel).\n message - string - The string to display which should be a single line.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print/","tags":null,"title":"darktable.print"},{"categories":null,"content":"dt_type\nType object describing parameters to export to pdf.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_pdf.dpi number\nThe dot per inch value to use at export\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.icc boolean\nShould the images be tagged with their embedded profile\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.border string\nEmpty space around the PDF images\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.orientation string\nOrientation of the pages in the document\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.title string\nThe title for the document\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.rotate boolean\nShould the images be rotated to match the PDF orientation\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.mode string\nThe image mode to use at export time\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.size string\nThe paper size to use\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.compression string\nCompression mode to use for images\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.pages string\nThe page type to use\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.rotate boolean\nShould the images be rotated in the resulting PDF\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_pdf/","tags":null,"title":"dt_imageio_module_format_data_pdf"},{"categories":null,"content":"🔗Name HDRMerge.lua - create an HDR image using HDRMerge\n🔗Description This plugin adds the module \u0026lsquo;HDRMerge\u0026rsquo; to darktable\u0026rsquo;s lighttable view\n🔗Usage Start this script using script manager.\nOn the initial startup go to darktable settings \u0026gt; lua options and set your executable paths and other preferences, then restart darktable\nSelect bracketed images and press the Run HDRMerge button. The resulting DNG will be auto-imported into darktable. Additional tags or style can be applied on auto import as well, if you desire.\n🔗Base Options Select your desired BPS (bits per sample and Embedded Preview Size.\n🔗Batch Options Select if you want to run in batch mode or not Select the gap, in seconds, between images for auto grouping in batch mode\nSee HDRMerge manual for further detail: http://jcelaya.github.io/hdrmerge/documentation/2014/07/11/user-manual.html\n🔗Auto-import Options Select a style, whether you want tags to be copied from the original, and any additional tags you desire added when the new image is auto-imported\n🔗Additional Software Required HDRMerge ver. 4.5 or greater\n🔗Limitations 🔗Author Kevin Ertel\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/hdrmerge/","tags":null,"title":"HDRMerge"},{"categories":null,"content":"🔗NAME rmdir\n🔗SYNOPSIS recursively remove a directory\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; df.rmdir(path) path - string - a directory path\n🔗DESCRIPTION rmdir allows directories to be removed recursively.\n🔗RETURN VALUE path - string - a directory path\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/rmdir/","tags":null,"title":"rmdir"},{"categories":null,"content":"The UI element that manipulates the current images\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.image.register_action function( name : string, label : string, callback : function, [tooltip : string] ) Add a new button and call a callback when it is clicked\n name - string - A unique name for the action that can be referenced later to destroy it label - string - The label to display on the button callback - function - The function to call when the button is pressed [tooltip] - string - The tooltip to use on the new button  callback -\nfunction( event : string, images : table oftypes.dt_lua_image_t ) The function to call when the button is pressed\n event - string - The name of the button that was pressed images - table of types.dt_lua_image_t - The images to act on when the button was clicked  🔗darktable.gui.libs.image.destroy_action function( name : string ) Destroy an action created with register_action\n name - string - The name of the action to destroy  🔗darktable.gui.libs.image.action_set_sensitive function( name : string, sensitive : boolean ) Set the sensitivity of a button created by darktable.gui.libs.image.register_action\n name - string - The name of the action to destroy sensitive - boolean - True to set the button sensitive, false to set it insensitive  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/image/","tags":null,"title":"darktable.gui.libs.image"},{"categories":null,"content":"function( message : string ) This function is similar todarktable.print_log but adds an ERROR prefix for clarity.\n message - string - The string to display.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print_error/","tags":null,"title":"darktable.print_error"},{"categories":null,"content":"dt_type\nType object describing parameters to export to pfm.\nAttributes:\n parent : types.dt_imageio_module_format_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_pfm/","tags":null,"title":"dt_imageio_module_format_data_pfm"},{"categories":null,"content":"🔗Name hugin.lua - stitch multiple images into a panorama\n🔗Description Add a new storage option to send images to hugin. Images are exported to darktable tmp dir first.\n🔗Usage  start this script from script manager set the hugin tool paths (on some platforms) if hugin gui mode is used, save the final result in the tmp directory with the first file name and _pano as suffix for the image to be automatically imported to DT afterwards  🔗Additional Software Required  hugin  🔗Limitations 🔗Author Wolfgang Goetz\nChristian Kanzian\nTobias Jakobs\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/hugin/","tags":null,"title":"hugin"},{"categories":null,"content":"🔗NAME sanitize_filename\n🔗SYNOPSIS make a filename safe to pass as an argument\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local sanitized_filename = df.sanitize_filename(filename) filename - string - a filepath and filename\n🔗DESCRIPTION sanitize_filename places quotes around the filename in an operating system specific manner. The result is safe to pass as an argument to the operating system.\n🔗RETURN VALUE sanitized_filename - string - quoted filename\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/sanitize_filename/","tags":null,"title":"sanitize_filename"},{"categories":null,"content":"function( message : string ) Print a hint message to the darktable GUI.\n message - string - The string to display.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print_hinter/","tags":null,"title":"darktable.print_hinter"},{"categories":null,"content":"The buttons to start importing images\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.import.register_widget function( widget : types.lua_widget ) Add a widget in the option expander of the import dialog\n widget - types.lua_widget - The widget to add to the dialog. The reset callback of the widget will be called whenever the dialog is opened.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/import/","tags":null,"title":"darktable.gui.libs.import"},{"categories":null,"content":"function( message : string ) This function will print its parameter if the Lua logdomain is activated. Start darktable with the \u0026quot;-d lua\u0026quot; command line option to enable the Lua logdomain.\n message - string - The string to display.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print_log/","tags":null,"title":"darktable.print_log"},{"categories":null,"content":"dt_type\nType object describing parameters to export to png.\nAttributes:\n parent : types.dt_imageio_module_format_t../types/dt_imageio_module_format_t  🔗dt_imageio_module_format_data_png.bpp number\nThe bpp parameter to use when exporting.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_png/","tags":null,"title":"dt_imageio_module_format_data_png"},{"categories":null,"content":"🔗Name image_stack.lua - process a stack of images\n🔗Description This script provides another storage (export target) for darktable. Selected images are exported in the specified format to temporary storage. The images are aligned if the user requests it. When the images are ready, imagemagick is launched and uses the selected evaluate-sequence operator to process the images. The output file is written to a filename representing the input files in the format specified by the user. The resulting image is imported into the film roll. The source images can be tagged as part of the file creation so that a user can later find the contributing images.\n🔗Usage  start this script using script manager select the images to process with image_stack in the export dialog select \u0026ldquo;image stack\u0026rdquo; and select the format and bit depth for the exported image Select whether the images need to be aligned. Select the stack operator Select the output format Select whether to tag the source images used to create the resulting file Specify executable locations if necessary Press \u0026ldquo;export\u0026rdquo; The resulting image will be imported  🔗Additional Software Required  align_image_stack - http://www.hugin.org imagemagick - http://www.imagemagick.org  🔗Limitations Mean is a fairly quick operation. On my machine (i7-6800K, 16G) it takes a few seconds. Median, on the other hand takes approximately 10x longer to complete. Processing 10 and 12 image stacks took over a minute. I didn\u0026rsquo;t test all the other functions, but the ones I did fell between Mean and Median performance wise.\n🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗See Also  Thanks to Pat David and his blog entry on blending images, https://patdavid.net/2013/05/noise-removal-in-photos-with-median_6.html  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/image_stack/","tags":null,"title":"image_stack"},{"categories":null,"content":"🔗NAME set_executable_path_preference\n🔗SYNOPSIS set a preference for the path to an executable\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; df.set_executable_path_preference(executable, path) executable - string - the name of the executable to set the path for\npath - string - the path to the binary\n🔗DESCRIPTION set_executable_path_preference takes an executable name and path to the executable and registers the preference for later use.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/set_executable_path_preference/","tags":null,"title":"set_executable_path_preference"},{"categories":null,"content":"function( message : string ) Print a toast message to the darktable GUI.\n message - string - The string to display.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print_toast/","tags":null,"title":"darktable.print_toast"},{"categories":null,"content":"The navigation and zoom level UI in lighttable\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.lighttable_mode.layout function( [layout : types.dt_lighttable_layout_t] ) : types.dt_lighttable_layout_t Change the lighttable layout.\n [layout] - types.dt_lighttable_layout_t - The layout to switch to. If empty the current layout is unchanged return - types.dt_lighttable_layout_t - the current layout  🔗darktable.gui.libs.lighttable_mode.zoom_level function( [level : int] ) : int Change the lighttable zoom level.\n [level] - int - The zoom level to switch to. If empty the current zoom level is unchanged return - int - the current zoom level  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/lighttable_mode/","tags":null,"title":"darktable.gui.libs.lighttable_mode"},{"categories":null,"content":"function( event_name : string, event_type : string, callback : function, ... : variable ) This function registers a callback to be called when a given event happens. Events are documented in the event section.\n event_name - string - The name of the event used to manipulate the event. The combination of event_name and event_type must be unique. event_type - string - The name of the event to register to. callback - function - The function to call on event. The signature of the function depends on the type of event. \u0026hellip; - variable - Some events need extra parameters at registration time; these must be specified here.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.register_event/","tags":null,"title":"darktable.register_event"},{"categories":null,"content":"dt_type\nType object describing parameters to export to ppm.\nAttributes:\n parent : types.dt_imageio_module_format_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_ppm/","tags":null,"title":"dt_imageio_module_format_data_ppm"},{"categories":null,"content":"🔗Name image_time.lua - synchronize image time for images shot with different cameras\n🔗Description image_time non destructively adjusts image times by modifying the database image exif_datetime_taken field. There are 4 modes: adjust time, set time, synchronize time, and reset time.\n🔗ADJUST TIME adjust time mode lets you chose an offset in terms of years, months, days, hours, minutes, and seconds. The adjustment can be added or subtracted.\nWARNING: When adding and subtracting months the result will usually be what is expected unless the time being adjusted is at the end of the month. This is because a month is a variable amount of time that can be 28, 29, 30 or 31 days depending on the month. Example: It\u0026rsquo;s March 31st and I subtract a month which not sets the time to February 31st. When that gets set to a valid time, then the date changes to March 3rd.\n🔗SET TIME set time mode allows you to pick a date and time and set the image time accordingly. Fields may be left out. This is useful when importing scanned images that don\u0026rsquo;t have an embedded date.\n🔗SYNCHRONIZE TIME I recently purchased a 7DmkII to replace my aging 7D. My 7D was still serviceable, so I bought a remote control and figured I\u0026rsquo;d try shooting events from 2 different perspectives. I didn\u0026rsquo;t think to synchonize the time between the 2 cameras, so when I loaded the images and sorted by time it was a disaster. I hacked a script together with hard coded values to adjust the exif_datetime_taken value in the database for the 7D images so that everything sorted properly. I\u0026rsquo;ve tried shooting with 2 cameras several times since that first attempt. I\u0026rsquo;ve gotten better at getting the camera times close, but still haven\u0026rsquo;t managed to get them to sync. So I decided to think the problem through and write a proper script to take care of the problem.\n🔗RESET TIME Select the images and click reset.\n🔗Usage 🔗ADJUST TIME Change the year, month, day, hour, minute, second dropdowns to the amount of change desired. Select add or subtract. Select the images. Click adjust.\n🔗SET TIME Set the time fields to the desired time. Select the images to change. Click set.\n🔗SYNCHRONIZE TIME Select 2 images, one from each camera, of the same moment in time. Click the Calculate button to calculate the time difference. The difference is displayed in the difference entry. You can manually adjust it by changing the value if necessary.\nSelect the images that need their time adjusted. Determine which way to adjust adjust the time (add or subtract) and select the appropriate choice.\nIf the image times get messed up and you just want to start over, select reset time from the mode and reset the image times.\n🔗RESET TIME Select the images and click reset.\n🔗Additional Software Required  exiv2  🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/image_time/","tags":null,"title":"image_time"},{"categories":null,"content":"🔗NAME split_filepath\n🔗SYNOPSIS split a filepath into parts\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.split_filepath(filepath) filepath - string - path and filename\n🔗DESCRIPTION split_filepath splits a filepath into the path, filename, basename and filetype and puts that in a table\n🔗RETURN VALUE result - table - a table containing the path, filename, basename, and filetype\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/split_filepath/","tags":null,"title":"split_filepath"},{"categories":null,"content":"function( event_name : string, event_type : string, ) This function removes the callback registered by darktable.register_event. Events are documented in the event section.\n event_name - string - The name of the event used to manipulate the event. The combination of event_name and event_type must be unique. event_type - string - The name of the event to register to.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.destroy_event/","tags":null,"title":"darktable.destroy_event"},{"categories":null,"content":"The liveview window\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/live_view/","tags":null,"title":"darktable.gui.libs.live_view"},{"categories":null,"content":"function( plugin_name : string, name : string, expandable : boolean, resettable : boolean, containers : table of types.dt_lua_view_t =\u0026gt; [ types.dt_ui_container_t, int ], widget : types.lua_widget, view_enter : function, view_leave : function ) Register a new lib object. A lib is a graphical element of darktable\u0026rsquo;s user interface\n plugin_name - string - A unique name for your library name - string - A user-visible name for your library expandable - boolean - whether this lib should be expandable or not resettable - boolean - whether this lib has a reset button or not containers - table of types.dt_lua_view_t =\u0026gt; [ types.dt_ui_container_t, int ] - A table associating to each view containing the lib the corresponding container and position. widget - types.lua_widget - The widget to display in the lib view_enter - function - A callback called when a view displaying the lib is entered. view_leave - function - A callback called when leaving a view displaying the lib.  🔗view_enter self:function( old_view : types.dt_lua_view_t, new_view : types.dt_lua_view_t ) A callback called when a view displaying the lib is entered\n self - types.dt_lua_lib_t - The lib on which the callback is called old_view - types.dt_lua_lib_t - The view that we are leaving new_view - types.dt_lua_lib_t - The view that we are entering  🔗view_leave self:function( old_view : types.dt_lua_view_t, new_view : types.dt_lua_view_t ) A callback called when leaving a view displaying the lib\n self - types.dt_lua_lib_t - The lib on which the callback is called old_view - types.dt_lua_lib_t - The view that we are leaving new_view - types.dt_lua_lib_t - The view that we are entering  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.register_lib/","tags":null,"title":"darktable.register_lib"},{"categories":null,"content":"dt_type\nType object describing parameters to export to tiff.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_tiff.bpp number\nThe bpp parameter to use when exporting.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_tiff/","tags":null,"title":"dt_imageio_module_format_data_tiff"},{"categories":null,"content":"🔗Name kml_export.lua - export a kml file from selected images\n🔗Description darktable KML export script\n🔗Usage  start this script from script manager when choosing file format, pick JPEG or PNG as Google Earth doesn\u0026rsquo;t support other formats  🔗Additional Software Required  zip (at the moment Linux only and only if you create KMZ files) magick (ImageMagick) xdg-user-dir (Linux)  🔗Limitations This script is only tested with Linux\n🔗Author Tobias Jakobs\nErik Augustin\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/kml_export/","tags":null,"title":"kml_export"},{"categories":null,"content":"🔗NAME test_file\n🔗SYNOPSIS test a file to see what it is\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.test_file(path, test) path - string - path and filename test - char - one of d, e, f, x where\n d - directory e - exists f - file x - executable  🔗DESCRIPTION test_file checks a specified path to see if it meets the specified test\n🔗RETURN VALUE result - boolean - true if the path satisfies the test, false if not\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/test_file/","tags":null,"title":"test_file"},{"categories":null,"content":"The location ui\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/location/","tags":null,"title":"darktable.gui.libs.location"},{"categories":null,"content":"function( plugin_name : string, name : string, [store : function], [finalize : function], [supported : function], [initialize : function], [widget : types.lua_widget] ) This function will add a new storage implemented in Lua. A storage is a module that is responsible for handling images once they have been generated during export. Examples of core storages include filesystem, e-mail, pwigo\u0026hellip;\n plugin_name - string - A unique name for the plugin. name - string - A human readable name for the plugin. [store] - function - This function is called once for each exported image. [finalize] - function - This function is called once all images are processed and all store calls are finished. [supported] - function - A function called to check if a given image format is supported by the Lua storage. [initialize] - function - A function called before storage happens. widget - types.lua_widget - A widget to display in the export section of darktable\u0026rsquo;s UI.  🔗[store] function( storage : types.dt_imageio_module_storage_t, image : types.dt_lua_image_t, format : types.dt_imageio_module_format_t, filename : string, number : integer, total : integer, high_quality : boolean, extra_data : table ) This function is called once for each exported image. Images can be exported in parallel but the calls to this function will be serialized.\n storage - types.dt_imageio_module_storage_t - The storage object used for the export. image - types.dt_lua_image_t - The exported image object. format - types.dt_imageio_module_format_t - The format object used for the export. filename - string - The name of a temporary file where the processed image is stored. number - integer - The number of the image out of the export series. total - integer - The total number of images in the export series. high_quality - boolean - True if the export is high quality. extra_data - table- An empty Lua table to take extra data. This table is common to the initialize, store and finalize calls in an export series.  🔗[finalize] function( storage : types.dt_imageio_module_storage_t, image_table : table, extra_data : table ) This function is called once all images are processed and all store calls are finished.\n storage - types.dt_imageio_module_storage_t - The storage object used for the export. image_table - table - A table keyed by the exported image objects and valued with the corresponding temporary export filename. extra_data - table - An empty Lua table to store extra data. This table is common to all calls to store and the call to finalize in a given export series.  🔗[supported] function( storage : types.dt_imageio_module_storage_t, format : types.dt_imageio_module_format_t ) : boolean A function called to check if a given image format is supported by the Lua storage; this is used to build the dropdown format list for the GUI.\nNote that the parameters in the format are the ones currently set in the GUI; the user might change them before export.\n storage - types.dt_imageio_module_storage_t - The storage object tested. format - types.dt_imageio_module_format_t - The format object to report about. return - boolean - True if the corresponding format is supported.  🔗[initialize] function( storage : types.dt_imageio_module_storage_t, format : types.dt_imageio_module_format_t, images : table of types.dt_lua_image_t, high_quality : boolean, extra_data : table ) : table or nil A function called before storage happens This function can change the list of exported functions\n storage - types.dt_imageio_module_storage_t - The storage object tested. format - types.dt_imageio_module_format_t - The format object to report about. images - table of types.dt_lua_image_t - A table containing images to be exported. high_quality - boolean - True if the export is high quality. extra_data - table - An empty Lua table to take extra data. This table is common to the initialize, store and finalize calls in an export series. return - table or nil - The modified table of images to export or nil If nil (or nothing) is returned, the original list of images will be exported If a table of images is returned, that table will be used instead. The table can be empty. The images parameter can be modified and returned  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.register_storage/","tags":null,"title":"darktable.register_storage"},{"categories":null,"content":"dt_type\nType object describing parameters to export to webp.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_webp.quality number\nThe quality to use at export time.\nAttributes:\n write  🔗dt_imageio_module_format_data_webp.comp_type types.comp_type_t\nThe overall quality to use; can be one of \u0026ldquo;webp_lossy\u0026rdquo; or \u0026ldquo;webp_lossless\u0026rdquo;.\nAttributes:\n write  🔗dt_imageio_module_format_data_webp.hint types.hint_t\nA hint on the overall content of the image.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_webp/","tags":null,"title":"dt_imageio_module_format_data_webp"},{"categories":null,"content":"🔗Name LabelsToTags.lua - mass apply tags to images\n🔗Description Allows the mass-application of tags using color labels and ratings as a guide.\n🔗Usage In your \u0026lsquo;luarc\u0026rsquo; file or elsewhere, use the function \u0026lsquo;register_tag_mapping\u0026rsquo;, defined in this module, to specify one or more tag mappings for use by the module. Any mappings so registered will be selectable, according to their given names, in the module\u0026rsquo;s \u0026ldquo;mapping\u0026rdquo; combo box.\nA mapping takes the form of a table mapping patterns to lists of tags. A pattern consists of 6 characters, of which the first five represent color labels and the last the rating. Each color label character may be \u0026lsquo;+\u0026rsquo;, \u0026lsquo;-\u0026rsquo;, or \u0026lsquo;\u0026rsquo;, indicating that for this pattern to match, the corresponding color label, respectively, must be on, must be off, or can be either. Similarly, the rating character may be a numeral between 0 and 5, \u0026ldquo;R\u0026rdquo; for rejected, or \u0026ldquo;\u0026rdquo; for \u0026ldquo;any value.\u0026rdquo;\nAn example call to \u0026lsquo;register_tag_mapping\u0026rsquo; is provided in a comment at the end of this file.\nWhen the \u0026ldquo;Start\u0026rdquo; button is pressed, the module will iterate over each selected image and check the state of that image\u0026rsquo;s color labels and rating against each pattern defined in the selected mapping. For each pattern that matches, the corresponding tags will be added to the image. Any such tag not already existing in the database will be created.\n🔗Additional Software Required 🔗Limitations 🔗Author August Schwerdfeger - august@schwerdfeger.name\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/labelstotags/","tags":null,"title":"LabelsToTags"},{"categories":null,"content":"function( plugin_name : string ) This function will destroy a storage created by darktable.register_storage.\n plugin_name - string - The name of the plugin to destroy.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.destroy_storage/","tags":null,"title":"darktable.destroy_storage"},{"categories":null,"content":"The map setting window\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/map_settings/","tags":null,"title":"darktable.gui.libs.map_settings"},{"categories":null,"content":"This pseudo table allows you to access and manipulate styles.\n🔗darktable.styles.# types.dt_style_t\nEach existing style has a numeric index; you can iterate them using ipairs.\n🔗darktable.styles.create function( image : types.dt_lua_image_t, name : string, description : string ) : types.dt_style_t Create a new style based on an image.\n image - types.dt_lua_image_t - The image to create the style from. name - string - The name to give to the new style. description - string - The description of the new style. return - types.dt_style_t - The new style object.  🔗darktable.styles.delete function( style : types.dt_style_t ) Deletes an existing style.\n style - types.dt_style_t - the style to delete  🔗darktable.styles.duplicate function( style : types.dt_style_t, name : string, description : string ) : types.dt_style_t Create a new style based on an existing style.\n style - types.dt_style_t - The style to base the new style on. name - string - The new style\u0026rsquo;s name. description - string - The new style\u0026rsquo;s description. return - types.dt_style_t - The new style object.  🔗darktable.styles.apply function( style : types.dt_style_t, image : types.dt_lua_image_t ) Apply a style to an image. The order of parameters can be inverted.\n style - types.dt_style_t - The style to use. image - types.dt_lua_image_t - The image to apply the style to.  🔗darktable.styles.import function( filename : string ) Import a style from an external .dtstyle file\n filename - string - The file to import  🔗darktable.styles.export function( style : types.dt_style_t, directory : string, overwrite : boolean ) Export a style to an external .dtstyle file\n style - types.dt_style_t - The style to export directory - string - The directory to export to overwrite - boolean - Is overwriting an existing file allowed  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.styles/","tags":null,"title":"darktable.styles"},{"categories":null,"content":"dt_type\nA virtual type representing all format types.\n🔗dt_imageio_module_format_t.plugin_name string\nA unique name for the plugin.\n🔗dt_imageio_module_format_t.name string\nA human readable name for the plugin.\n🔗dt_imageio_module_format_t.extension string\nThe typical filename extension for that format.\n🔗dt_imageio_module_format_t.mime string\nThe mime type associated with the format.\n🔗dt_imageio_module_format_t.max_width number\nThe max width allowed for the format (0 = unlimited).\nAttributes:\n write  🔗dt_imageio_module_format_t.max_height number\nThe max height allowed for the format (0 = unlimited).\nAttributes:\n write  🔗dt_imageio_module_format_t.write_image self:function( image : types.dt_lua_image_t, filename : string, [allow_upscale : boolean] ) : boolean Exports an image to a file. This is a blocking operation that will not return until the image is exported.\n self - types.dt_imageio_module_format_t - The format that will be used to export. image - types.dt_lua_image_t - The image object to export. filename - string - The filename to export to. [allow_upscale] - boolean - Set to true to allow upscaling of the image. return - boolean - Returns true on success.  Attributes:\n implicit_yield  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_t/","tags":null,"title":"dt_imageio_module_format_t"},{"categories":null,"content":"🔗Name OpenInExplorer.lua - open an images containing folder\n🔗Description This plugin adds the module \u0026ldquo;OpenInExplorer\u0026rdquo; to darktable\u0026rsquo;s lighttable view.\n🔗Usage Require this file in your luarc file, as with any other dt plug-in\nSelect the photo(s) you wish to find in your operating system\u0026rsquo;s file manager and press \u0026ldquo;show in file explorer\u0026rdquo; in the \u0026ldquo;selected images\u0026rdquo; section.\n  Nautilus (Linux), Explorer (Windows), and Finder (macOS prior to Mojave) will open one window for each selected image at the file\u0026rsquo;s location. The file name will be highlighted.\n  On macOS Mojave and Catalina the Finder will open one window for each different directory. In these windows only the last one of the corresponding files will be highlighted (bug or feature?).\n  Dolphin (Linux) will open one window with tabs for the different directories. All the selected images' file names are highlighted in their respective directories.\n  As an alternative option you can choose to show the image file names as symbolic links in an arbitrary directory. Go to preferences|Lua options. This option is not available for Windows users as on Windows only admins are allowed to create links.\n  Pros: You do not clutter up your display with multiple windows. So there is no need to limit the number of selections.\n  Cons: If you want to work with the files you are one step behind the original data.\n  🔗Additional Software Required 🔗Limitations 🔗Author Kevin Ertel\nVolker Lenhardt\nBill Ferguson\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/openinexplorer/","tags":null,"title":"OpenInExplorer"},{"categories":null,"content":"The masks window\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/masks/","tags":null,"title":"darktable.gui.libs.masks"},{"categories":null,"content":"Allows access to all existing tags.\n🔗darktable.tags.# types.dt_lua_tag_t\nEach existing tag has a numeric entry in the tags table - use ipairs to iterate over them.\n🔗darktable.tags.create function( name : string ) Creates a new tag and return it. If the tag exists return the existing tag.\n name - string - The name of the new tag.  🔗darktable.tags.find function( name : string ) : types.dt_lua_tag_t Returns the tag object or nil if the tag doesn\u0026rsquo;t exist.\n name - string - The name of the tag to find. return - _ types.dt_lua_tag_t_ - The tag object or nil.  🔗darktable.tags.delete function( tag : types.dt_lua_tag_t ) Deletes the tag object, detaching it from all images.\n tag - types.dt_lua_tag_t - The tag to be deleted.  🔗darktable.tags.attach function( tag : types.dt_lua_tag_t, image : types.dt_lua_image_t ) Attach a tag to an image; the order of the parameters can be reversed.\n tag - types.dt_lua_tag_t - The tag to be attached. image - types.dt_lua_image_t - The image to attach the tag to.  🔗darktable.tags.detach function( tag : types.dt_lua_tag_t, image : types.dt_lua_image_t ) Detach a tag from an image; the order of the parameters can be reversed.\n tag - types.dt_lua_tag_t - The tag to be detached. image - types.dt_lua_image_t - The image to detach the tag from.  🔗darktable.tags.get_tags function( image : types.dt_lua_image_t ) : table of types.dt_lua_tag_t Gets all tags attached to an image.\n image - types.dt_lua_image_t - The image to get the tags from. return - table of types.dt_lua_tag_t - A table of tags that are attached to the image.  🔗darktable.tags.get_tagged_images function( tag : types.dt_lua_tag_t ) : table of types.dt_lua_image_t Gets all images with the attached tag.\n tag - types.dt_lua_tag_t - The tag to search images for. return - table of types.dt_lua_image_t - A table of images that have the tag attached.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.tags/","tags":null,"title":"darktable.tags"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to disk.\nAttributes:\n parent : types.dt_imageio_module_storage_t  🔗dt_imageio_module_storage_data_disk.filename string\nThe filename to export to.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_disk/","tags":null,"title":"dt_imageio_module_storage_data_disk"},{"categories":null,"content":"🔗Name 🔗Description guides for cropping passport photos based on documents from the Finnish police (https://www.poliisi.fi/instancedata/prime_product_julkaisu/intermin/embeds/poliisiwwwstructure/38462_Passikuvaohje_EN.pdf) describing passport photo dimensions of 47x36 mm and 500x653 px for digital biometric data stored in passports. They use ISO 19794-5 standard based on ICAO 9303 regulations which should also be compliant for all of Europe.\n🔗Usage  add the following line in the file $CONFIGDIR/luarc require \u0026ldquo;passport_guide\u0026rdquo; (optional) add the line: \u0026ldquo;plugins/darkroom/clipping/extra_aspect_ratios/passport 36x47mm=47:36\u0026rdquo; to $CONFIGDIR/darktablerc when using the cropping tool, select \u0026ldquo;passport\u0026rdquo; as guide and if you added the line in your luarc select \u0026ldquo;passport 36x47mm\u0026rdquo; as aspect  🔗Additional Software Required 🔗Limitations 🔗Author Kåre Hampf\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/passport_guide/","tags":null,"title":"passport_guide"},{"categories":null,"content":"The widget allowing modification of metadata fields on the current image\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/metadata/","tags":null,"title":"darktable.gui.libs.metadata"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to email.\nAttributes:\n parent : types.dt_imageio_module_storage_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_email/","tags":null,"title":"dt_imageio_module_storage_data_email"},{"categories":null,"content":"🔗Name pdf_slideshow.lua - generate a pdf slideshow\n🔗Description Generates a PDF slideshow (via Latex) containing all selected images one per slide.\n🔗Usage  start this script from script manager  This plugin will add a new exporter that will allow you to generate a pdf slideshow. The interface will let you add:\n a global title for the slideshow (prefix in all slide label) a delay for the transition between each slide  Each slide will contain a single picture with a label at the bottom with the format (all fields can be the empty string):\n\u0026lt;global title\u0026gt; / \u0026lt;image creator\u0026gt; / \u0026lt;image title\u0026gt;\n🔗Additional Software Required  a PDF-Viewer pdflatex (Latex)  🔗Limitations 🔗Author Pascal Obry\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/pdf_slideshow/","tags":null,"title":"pdf_slideshow"},{"categories":null,"content":"The widget displaying metadata about the current image\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.metadata_view.register_info function( name : string, callback : function ) Register a field in the image information module with a callback function to update the field\n name - string - The name displayed for the new information callback - function - The function providing the info  callback -\nfunction( image : types.dt_lua_image_t ) : string  image - types.dt_lua_image_t - The image to analyze return - string - The extra information to display  🔗darktable.gui.libs.metadata_view.destroy_info function( name : string ) Remove the named field from the image information module and it\u0026rsquo;s associated callback\n name - string - The name of the field, created by darktable.gui.libs.metadata_view.register_info, to remove  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/metadata_view/","tags":null,"title":"darktable.gui.libs.metadata_view"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to gallery.\nAttributes:\n parent : types.dt_imageio_module_storage_t  🔗dt_imageio_module_storage_data_gallery.filename string\nThe filename to export to.\nAttributes:\n write  🔗dt_imageio_module_storage_data_gallery.title string\nThe title to use for export.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_gallery/","tags":null,"title":"dt_imageio_module_storage_data_gallery"},{"categories":null,"content":"🔗Name photils.lua - auto tag images based on feature recognition\n🔗Description A darktable plugin that tries to predict keywords based on the selected image. This plugin uses photils-cli to handle this task. Photils-cli is an application that passes the image through a neural network, classifies it, and extracts the suggested tags. Everything happens offline without the need that your data are sent over the internet.\n🔗Usage  start this script from script manager Select an image Press \u0026ldquo;get tags\u0026rdquo; Select the tags you want from a list of suggestions Press \u0026ldquo;Attach .. Tags\u0026rdquo; to add the selected tags to your image  🔗Additional Software Required  photils-cli - https://github.com/scheckmedia/photils-cli at the moment only available for Linux and MacOS  🔗Limitations 🔗Website photils\n🔗Author Tobias Scheck\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/photils/","tags":null,"title":"photils"},{"categories":null,"content":"The icons describing the different iop groups\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/modulegroups/","tags":null,"title":"darktable.gui.libs.modulegroups"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to latex.\nAttributes:\n parent : types.dt_imageio_module_storage_t  🔗dt_imageio_module_storage_data_latex.filename string\nThe filename to export to.\nAttributes:\n write  🔗dt_imageio_module_storage_data_latex.title string\nThe title to use for export.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_latex/","tags":null,"title":"dt_imageio_module_storage_data_latex"},{"categories":null,"content":"🔗Name quicktag.lua - add shortcuts to speed up tagging\n🔗Description For faster attaching your favorite tags, the script adds shortcuts and the module \u0026ldquo;quicktag\u0026rdquo; in lighttable mode with a changeable number of buttons. A tag can be assigned to each button. If the tags do not exist in your database, they are added to the database the first time they are attached to an image.\nThe number of buttons/shortcuts can be changed in the lua preferences. Changes in the number require a restart of darktable.\n🔗Usage  set the number of quicktags between 2 and 10 in the preferences dialog and restart darktable if wanted set the shortcuts in the preferences dialog to add or change a quicktag, first select the old tag with the combobox \u0026ldquo;old quicktag\u0026rdquo;, enter a new tag in the \u0026ldquo;new quicktag\u0026rdquo; filed and press \u0026ldquo;set quicktag\u0026rdquo; use a shortcut or button to attach the tag to selected images  🔗Additional Software Required 🔗Limitations 🔗Author Christian Kanzian\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/quicktag/","tags":null,"title":"quicktag"},{"categories":null,"content":"The tools on the bottom line of the UI (overexposure)\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/module_toolbox/","tags":null,"title":"darktable.gui.libs.module_toolbox"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to piwigo.\nAttributes:\n parent : types.dt_imageio_module_storage_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_piwigo/","tags":null,"title":"dt_imageio_module_storage_data_piwigo"},{"categories":null,"content":"🔗Name rate_group.lua - rate groups of images\n🔗Description Provide shortcuts for rating or rejecting all images within a group; particularly useful for RAW+JPEG shooters employing a star rating workflow like the below:\nhttp://blog.chasejarvis.com/blog/2011/03/photo-editing-101/\n🔗Usage Assign a keyboard shortcut to each action via settings \u0026gt; shortcuts \u0026gt; lua\nI use the following shortcuts:\n Reject group: Ctrl+R Rate group 1: Ctrl+1 Rate group 2: Ctrl+2 Rate group 3: Ctrl+3 Rate group 4: Ctrl+4 Rate group 5: Ctrl+5 Rate group 0: Ctrl+0  🔗Additional Software Required 🔗Limitations 🔗Author Dom H - dom@hxy.io\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/rate_group/","tags":null,"title":"rate_group"},{"categories":null,"content":"The full image preview to allow navigation\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/navigation/","tags":null,"title":"darktable.gui.libs.navigation"},{"categories":null,"content":"dt_type\nA virtual type representing all storage types.\n🔗dt_imageio_module_storage_t.plugin_name string\nA unique name for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.name string\nA human readable name for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.width number\nThe currently selected width for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.height number\nThe currently selected height for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.recommended_width number The recommended width for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.recommended_height number\nThe recommended height for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.supports_format format : types.dt_imageio_module_format_t ) : boolean Checks if a format is supported by this storage.\n self - types.dt_imageio_module_storage_t - The storage type to check against. format - types.dt_imageio_module_format_t - The format type to check. return - boolean - True if the format is supported by the storage.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_t/","tags":null,"title":"dt_imageio_module_storage_t"},{"categories":null,"content":"🔗Name rename-tags.lua - rename tags\n🔗Description 🔗Usage  In lighttable there is a new entry: \u0026lsquo;rename tag\u0026rsquo; Enter old tag (this one gets deleted!) Enter new tag name  🔗Additional Software Required 🔗Limitations 🔗Author Sebastian Witt - se.witt@gmx.net\nBill Ferguson - wpferguson@gmail.com\n🔗Deprecation This functionality now exists in core darktable so this script will be removed when darktable 4.0 is released.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/","tags":null,"title":"rename_tags"},{"categories":null,"content":"The settings window in the print view\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/print_settings/","tags":null,"title":"darktable.gui.libs.print_settings"},{"categories":null,"content":"enum\nThe logical operators to apply between rulesAttributes:\nValues:\n DT_LIB_COLLECT_MODE_AND DT_LIB_COLLECT_MODE_OR DT_LIB_COLLECT_MODE_AND_NOT  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lib_collect_mode_t/","tags":null,"title":"dt_lib_collect_mode_t"},{"categories":null,"content":"🔗Name RL_out_sharp.lua - Richardson-Lucy output sharpening using GMic\n🔗Description This script provides a new target storage \u0026ldquo;RL output sharpen\u0026rdquo;. Images exported will be sharpened using GMic (RL deblur algorithm)\n🔗EXAMPLE set sigma = 0.7, iterations = 10, jpeg output quality = 95, to correct blur due to image resize for web usage\n🔗Usage  start this script from script manager in lua preferences, select the GMic cli executable from \u0026ldquo;export selected\u0026rdquo;, choose \u0026ldquo;RL output sharpen\u0026rdquo; configure output folder configure RL parameters with sliders configure temp files format and quality, jpg 8bpp (good quality) and tif 16bpp (best quality) are supported configure other export options (size, etc.) export, images will be first exported in the temp format, then sharpened sharpened images will be stored in jpg format in the output folder  🔗Additional Software Required GMic command line interface (CLI) https://gmic.eu/download.shtml\n🔗Limitations MAC compatibility not tested Although Darktable can handle file names containing spaces, GMic cli cannot, so if you want to use this script please make sure that your images do not have spaces in the file name and path\n🔗Author Marco Carrarini - marco.carrarini@gmail.com\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/rl_out_sharp/","tags":null,"title":"RL_out_sharp"},{"categories":null,"content":"The stars to set the rating of an image\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/ratings/","tags":null,"title":"darktable.gui.libs.ratings"},{"categories":null,"content":"dt_type\nA single rule for filtering a collection\n🔗dt_lib_collect_params_rule_t.mode types.dt_lib_collect_mode_t\nHow this rule is applied after the previous one. Unused for the first rule\nAttributes:\n write  🔗dt_lib_collect_params_rule_t.data string\nThe text segment of the rule. Exact content depends on the type of rule\nAttributes:\n write  🔗dt_lib_collect_params_rule_t.item types.dt_collection_properties_t\nThe item on which this rule filter. i.e the type of the rule\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lib_collect_params_rule_t/","tags":null,"title":"dt_lib_collect_params_rule_t"},{"categories":null,"content":"🔗Name select_untagged.lua - select all images that aren\u0026rsquo;t tagged\n🔗Description Enable selection of untagged images (darktable|* tags are ignored)\n🔗Usage 🔗Additional Software Required 🔗Limitations 🔗Author Jannis_V\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/select_untagged/","tags":null,"title":"select_untagged"},{"categories":null,"content":"The recent collection UI element\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/recentcollect/","tags":null,"title":"darktable.gui.libs.recentcollect"},{"categories":null,"content":"enum\nThe different lighttable layouts\nValues:\n DT_LIGHTTABLE_LAYOUT_FIRST DT_LIGHTTABLE_LAYOUT_ZOOMABLE DT_LIGHTTABLE_LAYOUT_FILEMANAGER DT_LIGHTTABLE_LAYOUT_CULLING DT_LIGHTTABLE_LAYOUT_CULLING_DYNAMIC DT_LIGHTTABLE_LAYOUT_PREVIEW DT_LIGHTTABLE_LAYOUT_LAST  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lighttable_layout_t/","tags":null,"title":"dt_lighttable_layout_t"},{"categories":null,"content":"🔗Name slideshowMusic.lua - play music during a slideshow\n🔗Description darktable script to play music during a Slideshow\n🔗Usage  start this script from script manager  🔗Additional Software Required You need rhythmbox-client installed to use this script\n🔗Limitations 🔗Author Tobias Jakobs\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/slideshowmusic/","tags":null,"title":"slideshowMusic"},{"categories":null,"content":"The buttons that allow quickly changing the selection\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.select.register_selection function( name : string label : string, callback : function, [tooltip : string] ) Add a new button and call a callback when it is clicked\n name - string - The name to use to refer to the select button label - string - The label to display on the button callback - function - The function to call when the button is pressed [tooltip] - string - The tooltip to use on the new button  callback -\nfunction( event : string, images : table oftypes.dt_lua_image_t ) : table oftypes.dt_lua_image_t The function to call when the button is pressed\n event - string - The name of the button that was pressed images - table of types.dt_lua_image_t - The images in the current collection. This is the same content asdarktable.collection return - table of types.dt_lua_image_t - The images to set the selection to  🔗darktable.gui.libs.select.destroy_selection function( name : string ) Remove a button created by darktable.gui.libs.select.register_selection.\n name - string - The name of the selection button to destroy  🔗darktable.gui.libs.select.selection_set_sensitive function( name : string sensitive : boolean ) Set the sensitivity of a button created by darktable.gui.libs.select.register_selection.\n name - string - The name of the selection button to change the sensitivty of sensitive - boolean - True to set the button sensitive, false to set it insensitive  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/select/","tags":null,"title":"darktable.gui.libs.select"},{"categories":null,"content":"enum\nThe alignment of a label\nValues:\n fill start end center baseline  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_align_t/","tags":null,"title":"dt_lua_align_t"},{"categories":null,"content":"🔗Name transfer_hierarchy.lua - move or copy image hierarchies from one location to another\n🔗Description Allows the moving or copying of images from one directory tree to another, while preserving the existing hierarchy.\n🔗Usage darktable\u0026rsquo;s native operations for moving and copying images in batches allow only one directory to be specified as the destination for each batch. Those wanting to move or copy images from a hierarchy of directories within darktable while preserving the directory structure, must take the laborious step of performing the operation one individual directory at a time.\nThis module allows the intact moving and copying of whole directory trees. It was designed for the specific use case of rapidly transferring images from a customary source (e.g., a staging directory on the local disk) to a customary destination (e.g., a directory on a NAS device).\n🔗Instructions for operation:   Select the set of images you want to copy.\n  Click the \u0026ldquo;calculate\u0026rdquo; button. This will calculate the lowest directory in the hierarchy that contains every selected file (i.e., the common prefix of all the images' pathnames), and write its path into the \u0026ldquo;existing root\u0026rdquo; text box.\n  If (a) you have specified the \u0026ldquo;customary source root\u0026rdquo; and \u0026ldquo;customary destination root\u0026rdquo; preferences, and (b) the selected images are all contained under the directory specified as the customary source root, then the \u0026ldquo;root of destination\u0026rdquo; text box will also be automatically filled out.\nFor example, suppose that you have specified \u0026lsquo;/home/user/Staging\u0026rsquo; as your customary source root and \u0026lsquo;/mnt/storage\u0026rsquo; as your customary destination root. If all selected images fell under the directory \u0026lsquo;/home/user/Staging/2020/Roll0001\u0026rsquo;, the \u0026ldquo;root of destination\u0026rdquo; would be automatically filled out with \u0026lsquo;/mnt/storage/2020/Roll0001\u0026rsquo;.\nBut if all selected images fall under a directory outside the specified customary source root (e.g., \u0026lsquo;/opt/other\u0026rsquo;), the \u0026ldquo;root of destination\u0026rdquo; text box must be filled out manually.\nIt is also possible to edit the \u0026ldquo;root of destination\u0026rdquo; further once it has been automatically filled out.\n  Click the \u0026ldquo;move\u0026rdquo; or \u0026ldquo;copy\u0026rdquo; button.\nBefore moving or copying any images, the module will first replicate the necessary directory hierarchy by creating all destination directories that do not already exist; should a directory creation attempt fail, the operation will be aborted, but any directories already created will not be removed.\nDuring the actual move/copy operation, the module transfers an image by taking its path and replacing the string in the \u0026ldquo;existing root\u0026rdquo; text box with that in the \u0026ldquo;root of destination\u0026rdquo; text box (e.g., \u0026lsquo;/home/user/Staging/2020/Roll0001/DSC_0001.jpg\u0026rsquo; would be transferred to \u0026lsquo;/mnt/storage/2020/Roll0001/DSC_0001.jpg\u0026rsquo;).\n  🔗Additional Software Required 🔗Limitations 🔗Author August Schwerdfeger - august@schwerdfeger.name\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/transfer_hierarchy/","tags":null,"title":"transfer_hierarchy"},{"categories":null,"content":"The session UI when tethering\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/session/","tags":null,"title":"darktable.gui.libs.session"},{"categories":null,"content":"dt_type\nA lua-managed entry in the backgroundjob lib\n🔗dt_lua_backgroundjob_t.percent number\nThe value of the progress bar, between 0 and 1. will return nil if there is no progress bar, will raise an error if read or written on an invalid job\nAttributes:\n write  🔗dt_lua_backgroundjob_t.valid boolean\nTrue if the job is displayed, set it to false to destroy the entry An invalid job cannot be made valid again\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_backgroundjob_t/","tags":null,"title":"dt_lua_backgroundjob_t"},{"categories":null,"content":"🔗Name video_ffmpeg.lua - create a timelapse video from selected images\n🔗Description This plugin will add the new export module \u0026ldquo;video ffmpeg\u0026rdquo;.\n🔗Usage  Go to Lighttable Select images you want to use as a video ffmpeg frames In image export module select \u0026ldquo;video ffmpeg\u0026rdquo; Configure you video settings Export  🔗Additional Software Required ffmpeg\n🔗Limitations This script has been tested under Linux only\n🔗Author Dominik Markiewicz\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/video_ffmpeg/","tags":null,"title":"video_ffmpeg"},{"categories":null,"content":"The UI element that manipulates snapshots in darkroom\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.snapshots.ratio number - The place in the screen where the line separating the snapshot is. Between 0 and 1\nAttributes:\n write  🔗darktable.gui.libs.snapshots.direction types.snapshot_direction_t - The direction of the snapshot overlay\nAttributes:\n write  🔗darktable.gui.libs.snapshots.# types.dt_lua_snapshot_t - Each snapshot appears with a numerical index; you can iterate over them with ipairs.\n🔗darktable.gui.libs.snapshots.selected types.dt_lua_snapshot_t - The currently selected snapshot\n🔗darktable.gui.libs.snapshots.take_snapshot function( ) Take a snapshot of the current image and add it to the UI The snapshot file will be generated at the next redraw of the main window\n🔗darktable.gui.libs.snapshots.clear_snapshots function( ) Delete all snapshots and remove them from the UI.\n🔗darktable.gui.libs.snapshots.max_snapshot types.dt_lua_snapshot_t - The maximum number of snapshots\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/snapshots/","tags":null,"title":"darktable.gui.libs.snapshots"},{"categories":null,"content":"dt_type\nA wrapper around a cairo drawing context. You probably shouldn\u0026rsquo;t use this after the callback that got it passed returned. For more details of the member functions have a look at the cairo documentation for the drawing context, transformations and paths.\n🔗dt_lua_cairo_t.save self:function( ) Save the state of the drawing context.\n self - types.dt_lua_cairo_t - The context to modify.  🔗types.dt_lua_cairo_t.restore self:function( ) Restore a previously saved state.\n self - types.dt_lua_cairo_t - The context to modify.  🔗dt_lua_cairo_t.move_to self:function( x : float, y : float ) Begin a new sub-path.\n self - types.dt_lua_cairo_t - The context to modify x - float - The x coordinate of the new position. y - float - The y coordinate of the new position.  🔗dt_lua_cairo_t.line_to self:function( x : float, y : float ) Add a line to the path.\n self - types.dt_lua_cairo_t - The context to modify. x - float - The x coordinate of the end of the new line. y - float - The y coordinate of the end of the new line.  🔗types.dt_lua_cairo_t.rectangle self:function( x : float, y : float, width : float, height : float ) Add a closed sub-path rectangle.\n self - types.dt_lua_cairo_t - The context to modify. x - float - The x coordinate of the top left corner of the rectangle. y - float - The y coordinate of the top left corner of the rectangle. width - float - The width of the rectangle. height - float - The height of the rectangle.  🔗dt_lua_cairo_t.arc self:function( x : float, y : float, radius : float, angle1 : float, angle2 : float ) Add a circular arc.\n self - types.dt_lua_cairo_t - The context to modify. x - float - The x position of the center of the arc. y - float - The y position of the center of the arc. radius - float - The radius of the arc. angle1 - float - The start angle, in radians. angle2 - float - The end angle, in radians.  🔗dt_lua_cairo_t.arc_negative self:function( x : float, y : float, radius : float, angle1 : float, angle2 : float ) Add a circular arc. It only differs in the direction from types.dt_lua_cairo_t.arc.\n self - types.dt_lua_cairo_t - The context to modify. x - float - The x position of the center of the arc. y - float - The y position of the center of the arc. radius - float - The radius of the arc. angle1 - float - The start angle, in radians. angle2 - float - The end angle, in radians.  🔗dt_lua_cairo_t.rotate self:function( angle : float ) Add a rotation to the transformation matrix.\n self - types.dt_lua_cairo_t - The context to modify. angle - float - The angle (in radians) by which the user-space axes will be rotated.  🔗dt_lua_cairo_t.scale self:function( x : float, y : float ) Add a scaling to the transformation matrix.\nself** - _types.dt_lua_cairo_t_ - The context to modify.\n x - float - The scale factor for the x dimension. y - float - The scale factor for the y dimension.  🔗dt_lua_cairo_t.translate self:function( x : float, y : float ) Add a translation to the transformation matrix.\n self - types.dt_lua_cairo_t - The context to modify. x - float - Amount to translate in the x direction y - float - Amount to translate in the y direction  🔗dt_lua_cairo_t.new_sub_path self:function( ) Begin a new sub-path.\n self - types.dt_lua_cairo_t - The context to modify.  🔗dt_lua_cairo_t.draw_line self:function( x_start : float, y_start : float, x_end : float, y_end : float ) Helper function to draw a line with a given start and end.\n self - types.dt_lua_cairo_t - The context to modify. x_start - float - The x coordinate of the start of the new line. y_start - float - The y coordinate of the start of the new line. x_end - float - The x coordinate of the end of the new line. y_end - float - The y coordinate of the end of the new line.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_cairo_t/","tags":null,"title":"dt_lua_cairo_t"},{"categories":null,"content":"The style selection menu\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/styles/","tags":null,"title":"darktable.gui.libs.styles"},{"categories":null,"content":"enum\nThe ellipsize mode of a label\nValues:\n none start middle end  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_ellipsize_mode_t/","tags":null,"title":"dt_lua_ellipsize_mode_t"},{"categories":null,"content":"The tag manipulation UI\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/tagging/","tags":null,"title":"darktable.gui.libs.tagging"},{"categories":null,"content":"dt_type\nA film in darktable; this represents a directory containing imported images.\nAttributes:\n has_tostring  🔗dt_lua_film_t.move_image see darktable.database.move_image\n🔗dt_lua_film_t.copy_image see darktable.database.copy_image\n🔗dt_lua_film_t.# types.dt_lua_image_t\nThe different images within the film.\n🔗dt_lua_film_t.id number A unique numeric id used by this film.\nAttributes:\n write  🔗dt_lua_film_t.path string\nThe path represented by this film.\nAttributes:\n write  🔗dt_lua_film_t.delete self:function( [force : boolean] ) Removes the film from the database.\n self - types.dt_lua_film_t - The film to remove. [force] - boolean - Force removal, even if the film is not empty.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_film_t/","tags":null,"title":"dt_lua_film_t"},{"categories":null,"content":"The labels allowing to switch view\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/viewswitcher/","tags":null,"title":"darktable.gui.libs.viewswitcher"},{"categories":null,"content":"dt_type\nImage objects represent an image in the database. This is slightly different from a file on disk since a file can have multiple developments. Note that this is the real image object; changing the value of a field will immediately change it in darktable and will be reflected on any copy of that image object you may have kept.\nAttributes:\n has_tostring  🔗dt_lua_image_t.attach_tag see darktable.tags.attach\n🔗dt_lua_image_t.detach_tag see darktable.tags.detach\n🔗dt_lua_image_t.get_tags see darktable.tags.get_tags\n🔗dt_lua_image_t.create_style see darktable.styles.create\n🔗dt_lua_image_t.apply_style see darktable.styles.apply\n🔗dt_lua_image_t.duplicate see darktable.database.duplicate\n🔗dt_lua_image_t.move see darktable.database.move_image\n🔗dt_lua_image_t.copy see darktable.database.copy_image\n🔗dt_lua_image_t.id number\nA unique id identifying the image in the database.\n🔗dt_lua_image_t.path string\nThe file the directory containing the image.\n🔗dt_lua_image_t.film types.dt_lua_film_t\nThe film object that contains this image.\n🔗dt_lua_image_t.filename string\nThe filename of the image.\n🔗dt_lua_image_t.sidecar string\nThe filename of the image\u0026rsquo;s sidecar file.\n🔗dt_lua_image_t.duplicate_index number\nIf there are multiple images based on a same file, each will have a unique number, starting from 0.\n🔗dt_lua_image_t.publisher string\nThe publisher field of the image.\nAttributes:\n write  🔗dt_lua_image_t.title string\nThe title field of the image.\nAttributes:\n write  🔗dt_lua_image_t.creator string\nThe creator field of the image.\nAttributes:\n write  🔗dt_lua_image_t.rights string\nThe rights field of the image.\nAttributes:\n write  🔗dt_lua_image_t.description string\nThe description field for the image.\nAttributes:\n write  🔗dt_lua_image_t.notes string\nThe notes field for the image.\nAttributes:\n write  🔗dt_lua_image_t.version_name string\nThe version_name field for the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_maker string\nThe maker exif data.\nAttributes:\n write  🔗dt_lua_image_t.exif_model string\nThe camera model used.\nAttributes:\n write  🔗dt_lua_image_t.exif_lens string\nThe id string of the lens used.\nAttributes:\n write  🔗dt_lua_image_t.exif_aperture number\nThe aperture saved in the exif data.\nAttributes:\n write  🔗dt_lua_image_t.exif_exposure number\nThe exposure time of the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_focal_length number\nThe focal length of the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_iso number\nThe iso used on the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_datetime_taken string\nThe date and time of the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_focus_distance number\nThe distance of the subject.\nAttributes:\n write  🔗dt_lua_image_t.exif_crop number\nThe exif crop data.\nAttributes:\n write  🔗dt_lua_image_t.latitude float or nil\nGPS latitude data of the image, nil if not set.\nAttributes:\n write  🔗dt_lua_image_t.longitude float or nil\nGPS longitude data of the image, nil if not set.\nAttributes:\n write  🔗dt_lua_image_t.elevation float or nil\nGPS altitude data of the image, nil if not set.\nAttributes:\n write  🔗dt_lua_image_t.is_raw boolean\nTrue if the image is a RAW file. WARNING: This is a flag that gets set the first time the image is opened, either by an edit or thumbnail generation. If images are imported using darktable.database.import(), then dt_lua_image_t.is_raw is not guaranteed to be correct.\n🔗dt_lua_image_t.is_ldr boolean\nTrue if the image is a ldr image.\n🔗dt_lua_image_t.is_hdr boolean\nTrue if the image is a hdr image.\n🔗dt_lua_image_t.is_altered boolean\nTrue if the image has been edited.\n🔗dt_lua_image_t.has_txt boolean\nTrue if the image has a txt sidecar file.\nAttributes:\n write  🔗dt_lua_image_t.width number\nThe width of the image.\n🔗dt_lua_image_t.height number\nThe height of the image.\n🔗dt_lua_image_t.rating number\nThe rating of the image (-1 for rejected).\nAttributes:\n write  🔗dt_lua_image_t.red boolean\nTrue if the image has the corresponding colorlabel.\nAttributes:\n write  🔗dt_lua_image_t.blue see types.dt_lua_image_t.red\n🔗dt_lua_image_t.green see types.dt_lua_image_t.red\n🔗dt_lua_image_t.yellow see types.dt_lua_image_t.red\n🔗dt_lua_image_t.purple see types.dt_lua_image_t.red\n🔗dt_lua_image_t.reset  self:function( ) Removes all processing from the image, resetting it back to its original state\n self - types.dt_lua_image_t - The image whose history will be deleted  🔗dt_lua_image_t.delete self:function( ) Removes an image from the database\n self - types.dt_lua_image_t - The image to remove  🔗dt_lua_image_t.group_with self:function( [image : types.dt_lua_image_t] ) Puts the first image in the same group as the second image. If no second image is provided the image will be in its own group.\n self - types.dt_lua_image_t - The image whose group must be changed. [image] - types.dt_lua_image_t - The image we want to group with.  🔗dt_lua_image_t.make_group_leader self:function( ) Makes the image the leader of its group.\n self - types.dt_lua_image_t - The image we want as the leader.  🔗dt_lua_image_t.get_group_members self:function( ) : table of types.dt_lua_image_t Returns a table containing all types.dt_lua_image_t of the group. The group leader is both at a numeric key and at the \u0026ldquo;leader\u0026rdquo; special key (so you probably want to use ipairs to iterate through that table).\n self - types.dt_lua_image_t - The image whose group we are querying. return - table of types.dt_lua_image_t - A table of image objects containing all images that are in the same group as the image.  🔗dt_lua_image_t.group_leader types.dt_lua_image_t\nThe image which is the leader of the group this image is a member of.\n🔗dt_lua_image_t.local_copy boolean\nTrue if the image has a copy in the local cache\nAttributes:\n write  🔗dt_lua_image_t.drop_cache self:function( ) drops the cached version of this image. This function should be called if an image is modified out of darktable to force darktable to regenerate the thumbnail. darktable will regenerate the thumbnail by itself when it is needed.\n self - types.dt_lua_image_t - The image whose cache must be dropped.  🔗dt_lua_image_t.generate_cache self.function( check_dirs : boolean start_size : integer end_size : integer )  self - types.dt_lua_image_t - The image whose cache is to be generated. check_dirs - boolean - check if the mipmap cache directories exist. Create them if necessary. start_size - integer - mipmap size to generate first end_size - integer - mipmap size to generate last  NOTES:\n  mipmap cache image sizes\n 0 - tiny 1 - 180 px 2 - 360 px 3 - 640 px 4 - 1920 px 5 - 2560 px 6 - 4096 px 7 - 5120 px 8 - full resolution    To generate a single size mipmap image set start_size and end_size to the same value\n  When generating multiple sizes put the largest size as the start size and the smallest as the end.\n  When different start and end sizes are specified, every size mipmap from start to end is generated.\n  When looping over a set of images and generating just one size, check for directories on the first image only.\n  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_image_t/","tags":null,"title":"dt_lua_image_t"},{"categories":null,"content":"The view_toolbox window\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/view_toolbox/","tags":null,"title":"darktable.gui.libs.view_toolbox"},{"categories":null,"content":"dt_type\nThe type of a UI lib\n🔗dt_lua_lib_t.id string\nA unit string identifying the lib\n🔗dt_lua_lib_t.name string\nThe translated title of the UI element\n🔗dt_lua_lib_t.version number\nThe version of the internal data of this lib\n🔗dt_lua_lib_t.visible boolean\nAllow to make a lib module completely invisible to the user. Note that if the module is invisible the user will have no way to restore it without lua\nAttributes:\n implicit_yield write  🔗dt_lua_lib_t.container types.dt_ui_container_t\nThe location of the lib in the darktable UI\n🔗dt_lua_lib_t.expandable boolean\nTrue if the lib can be expanded/retracted\n🔗dt_lua_lib_t.expanded boolean\nTrue if the lib is expanded\nAttributes:\n write  🔗dt_lua_lib_t.position number\nA value deciding the position of the lib within its container\n🔗dt_lua_lib_t.views table\nA table of all the views that display this widget\n🔗dt_lua_lib_t.reset self:function( ) A function to reset the lib to its default values This function will do nothing if the lib is not visible or can\u0026rsquo;t be reset\n self - types.dt_lua_lib_t - The lib to reset  🔗dt_lua_lib_t.on_screen boolean\nTrue if the lib is currently visible on the screen\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_lib_t/","tags":null,"title":"dt_lua_lib_t"},{"categories":null,"content":"enum\nA possible orientation for a widget\nValues:\n horizontal vertical  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_orientation_t/","tags":null,"title":"dt_lua_orientation_t"},{"categories":null,"content":"dt_type\nThe description of a snapshot in the snapshot lib\nAttributes:\nhas_tostring\n🔗dt_lua_snapshot_t.filename string\nThe filename of an image containing the snapshot\n🔗dt_lua_snapshot_t.select self:function( ) Activates this snapshot on the display. To deactivate all snapshot you need to call this function on the active snapshot\n self - types.dt_lua_snapshot_t - The snapshot to activate  🔗dt_lua_snapshot_t.name string\nThe name of the snapshot, as seen in the UI\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_snapshot_t/","tags":null,"title":"dt_lua_snapshot_t"},{"categories":null,"content":"dt_type\nA tag that can be attached to an image.\nAttributes:\nhas_tostring\n🔗dt_lua_tag_t.delete see darktable.tags.delete\n🔗dt_lua_tag_t.attach see darktable.tags.attach\n🔗dt_lua_tag_t.detach see darktable.tags.detach\n🔗dt_lua_tag_t.name string\nThe name of the tag.\n🔗dt_lua_tag_t.# types.dt_lua_image_t\nThe images that have that tag attached to them.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_tag_t/","tags":null,"title":"dt_lua_tag_t"},{"categories":null,"content":"dt_type\nA darktable view\n🔗dt_lua_view_t.id string\nA unique string identifying the view\n🔗dt_lua_view_t.name string\nThe name of the view\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_view_t/","tags":null,"title":"dt_lua_view_t"},{"categories":null,"content":"enum\nThe compression mode for PDF document\nValues:\n uncompressed deflate  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_pdf_stream_encoder_t/","tags":null,"title":"dt_pdf_stream_encoder_t"},{"categories":null,"content":"dt_type\nAn element that is part of a style.\nAttributes:\n has_tostring  🔗dt_style_item_t.name string\nThe name of the style item.\n🔗dt_style_item_t.num number\nThe position of the style item within its style.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_style_item_t/","tags":null,"title":"dt_style_item_t"},{"categories":null,"content":"dt_type A style that can be applied to an image. Attributes:\n has_tostring  🔗dt_style_t.delete see darktable.styles.delete\n🔗dt_style_t.duplicate see darktable.styles.duplicate\n🔗dt_style_t.apply see darktable.styles.apply\n🔗dt_style_t.export see darktable.styles.export\n🔗dt_style_t.name string\nThe name of the style.\n🔗dt_style_t.description string\nThe description of the style.\n🔗dt_style_t.# types.dt_style_item_t\nThe different items that make the style.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_style_t/","tags":null,"title":"dt_style_t"},{"categories":null,"content":"enum\nA place in the darktable UI where a lib can be placed\nValues:\n DT_UI_CONTAINER_PANEL_LEFT_TOP DT_UI_CONTAINER_PANEL_LEFT_CENTER DT_UI_CONTAINER_PANEL_LEFT_BOTTOM DT_UI_CONTAINER_PANEL_RIGHT_TOP DT_UI_CONTAINER_PANEL_RIGHT_CENTER DT_UI_CONTAINER_PANEL_RIGHT_BOTTOM DT_UI_CONTAINER_PANEL_TOP_LEFT DT_UI_CONTAINER_PANEL_TOP_CENTER DT_UI_CONTAINER_PANEL_TOP_RIGHT DT_UI_CONTAINER_PANEL_CENTER_TOP_LEFT DT_UI_CONTAINER_PANEL_CENTER_TOP_CENTER DT_UI_CONTAINER_PANEL_CENTER_TOP_RIGHT DT_UI_CONTAINER_PANEL_CENTER_BOTTOM_LEFT DT_UI_CONTAINER_PANEL_CENTER_BOTTOM_CENTER DT_UI_CONTAINER_PANEL_CENTER_BOTTOM_RIGHT DT_UI_CONTAINER_PANEL_BOTTOM  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_ui_container_t/","tags":null,"title":"dt_ui_container_t"},{"categories":null,"content":"enum\nThe different user interface panels\nValues:\n DT_UI_PANEL_TOP DT_UI_PANEL_CENTER_TOP DT_UI_PANEL_CENTER_BOTTOM DT_UI_PANEL_LEFT DT_UI_PANEL_RIGHT DT_UI_PANEL_BOTTOM DT_UI_PANEL_SIZE  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_ui_panel_t/","tags":null,"title":"dt_ui_panel_t"},{"categories":null,"content":"enum\na hint on the way to encode a webp image\nValues:\n hint_default hint_picture hint_photo hint_graphic  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/hint_t/","tags":null,"title":"hint_t"},{"categories":null,"content":"dt_type\nA container for widget in a horizontal or vertical list\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_box.__call see types.lua_widget.As a function\n🔗lua_box.extra registration parameters This widget has no extra registration parameters\n🔗lua_box.orientation types.dt_lua_orientation_t\nThe orientation of the box.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_box/","tags":null,"title":"lua_box"},{"categories":null,"content":"dt_type\nA clickable button\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_button.__call see types.lua_widget.As a function\n🔗lua_button.extra registration parameters This widget has no extra registration parameters\n🔗lua_button.label string\nThe label displayed on the button\nAttributes:\n write  🔗lua_button.ellipsize types.dt_lua_ellipsize_mode_t\nThe ellipsize mode of the button label\nAttributes:\n write  🔗lua_button.clicked_callback function( widget : types.lua_widget ) A function to call on button click\n widget - types.lua_widget - The widget that triggered the callback  Attributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_button/","tags":null,"title":"lua_button"},{"categories":null,"content":"dt_type\nA checkable button with a label next to it Attributes:\n has_tostring parent : types.lua_widget  🔗lua_check_button.__call see types.lua_widget.As a function\n🔗lua_check_button.extra registration parameters This widget has no extra registration parameters\n🔗lua_check_button.label string\nThe label displayed next to the button\nAttributes:\n write  🔗lua_check_button.value boolean\nIf the widget is checked or not\nAttributes:\n write  🔗lua_check_button.clicked_callback function( widget : types.lua_widget ) A function to call on button click\n widget - types.lua_widget - The widget that triggered the callback  Attributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_check_button/","tags":null,"title":"lua_check_button"},{"categories":null,"content":"dt_type\nA widget with multiple text entries in a menu. This widget can be set as editable at construction time. If it is editable the user can type a value and is not constrained by the values in the menu.\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_combobox.__call see types.lua_widget.As a function\n🔗lua_combobox.extra registration parameters This widget has no extra registration parameters\n🔗lua_combobox.value string\nThe text content of the selected entry, can be nil. You can set it to a number to select the corresponding entry from the menu. If the combobox is editable, you can set it to any string. You can set it to nil to deselect all entries.\nAttributes:\n write  🔗lua_combobox.selected integer\nThe index of the selected entry, or 0 if nothing is selected. You can set it to a number to select the corresponding entry from the menu, or to 0 to select nothing. You can set it to nil to deselect all entries.\nAttributes:\n write  🔗lua_combobox.# string\nThe various menu entries. You can add new entries by writing to the first element beyond the end. You can removes entries by setting them to nil.\nAttributes:\n write  🔗lua_combobox.changed_callback function( widget : types.lua_widget ) A function to call when the value field changes (character entered or value selected)\n widget - types.lua_widget - The widget that triggered the callback  Attributes:\n write  🔗lua_combobox.editable boolean\nTrue is the user is allowed to type a string in the combobox\nAttributes:\n write  🔗lua_combobox.label string\nThe label displayed on the combobox\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_combobox/","tags":null,"title":"lua_combobox"},{"categories":null,"content":"dt_type\nA widget containing other widgets\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_container.__call see types.lua_widget.As a function\n🔗lua_container.extra registration parameters This widget has no extra registration parameters\n🔗lua_container.# types.lua_widget\nThe widgets contained by the box. You can append widgets by adding them at the end of the list. You can remove widgets by setting them to nil.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_container/","tags":null,"title":"lua_container"},{"categories":null,"content":"dt_type\nA widget in which the user can input text\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_entry.__call see types.lua_widget.As a function\n🔗lua_entry.extra registration parameters This widget has no extra registration parameters\n🔗lua_entry.text string\nThe content of the entry\nAttributes:\n write  🔗lua_entry.placeholder string\nThe text to display when the entry is empty\nAttributes:\n write  🔗lua_entry.is_password boolean\nTrue if the text content should be hidden\nAttributes:\n write  🔗lua_entry.editable boolean\nFalse if the entry should be read-only\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_entry/","tags":null,"title":"lua_entry"},{"categories":null,"content":"dt_type\nA button that allows the user to select an existing file\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_file_chooser_button.__call see types.lua_widget.As a function\n🔗lua_file_chooser_button.extra registration parameters This widget has no extra registration parameters\n🔗lua_file_chooser_button.title string\nThe title of the window when choosing a file\nAttributes:\n write  🔗lua_file_chooser_button.value string\nThe currently selected file\nAttributes:\n write  🔗lua_file_chooser_button.changed_callback function( widget : types.lua_widget ) A function to call when the value field changes (character entered or value selected)\n widget - types.lua_widget - The widget that triggered the callback  Attributes:\n write  🔗lua_file_chooser_button.is_directory boolean\nTrue if the file chooser button only allows directories to be selected\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_file_chooser_button/","tags":null,"title":"lua_file_chooser_button"},{"categories":null,"content":"dt_type\nA label containing some text\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_label.__call see types.lua_widget.As a function\n🔗lua_label.extra registration parameters This widget has no extra registration parameters\n🔗lua_label.label string\nThe label displayed\nAttributes:\n write  🔗lua_label.selectable boolean\nTrue if the label content should be selectable\nAttributes:\n write  🔗lua_label.halign types.dt_lua_align_t\nThe horizontal alignment of the label\nAttributes:\n write  🔗lua_label.ellipsize types.dt_lua_ellipsize_mode_t\nThe ellipsize mode of the label\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_label/","tags":null,"title":"lua_label"},{"categories":null,"content":"enum The type of OS we darktable can run on\nValues :\n windows macos linux unix  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_os_type/","tags":null,"title":"lua_os_type"},{"categories":null,"content":"enum\nThe type of value to save in a preference\nValues:\n enum directory file string bool integer float lua  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_pref_type/","tags":null,"title":"lua_pref_type"},{"categories":null,"content":"dt_type\nA section label\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_section_label.__call see types.lua_widget.As a function\n🔗types.lua_section_label.extra registration parameters This widget has no extra registration parameters\n🔗lua_section_label.label string\nThe section name\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_section_label/","tags":null,"title":"lua_section_label"},{"categories":null,"content":"dt_type\nA widget providing a separation in the UI.\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_separator.__call see types.lua_widget.As a function\n🔗lua_separator.extra registration parameters This widget has no extra registration parameters\n🔗lua_separator.orientation string\nThe orientation of the separator.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_separator/","tags":null,"title":"lua_separator"},{"categories":null,"content":"dt_type\nA slider that can be set by the user\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_slider.__call see types.lua_widget.As a function\n🔗lua_slider.extra registration parameters This widget has no extra registration parameters\n🔗lua_slider.soft_min number\nThe soft minimum value for the slider, the slider can\u0026rsquo;t go beyond this point\nAttributes:\n write  🔗lua_slider.soft_max number\nThe soft maximum value for the slider, the slider can\u0026rsquo;t go beyond this point\nAttributes:\n write  🔗lua_slider.hard_min number\nThe hard minimum value for the slider, the user can\u0026rsquo;t manually enter a value beyond this point Attributes:\n write  🔗lua_slider.hard_max number\nThe hard maximum value for the slider, the user can\u0026rsquo;t manually enter a value beyond this point\nAttributes:\n write  🔗lua_slider.step number\nThe step width of the slider\nAttributes:\n write  🔗lua_slider.digits integer\nThe number of decimal digits shown on the slider\nAttributes:\n write  🔗lua_slider.value number\nThe current value of the slider\nAttributes:\n write  🔗lua_slider.label string\nThe label next to the slider\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_slider/","tags":null,"title":"lua_slider"},{"categories":null,"content":"dt_type\nA container that will only show one of its child at a time\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_stack.__call see types.lua_widget.As a function\n🔗lua_stack.extra registration parameters This widget has no extra registration parameters\n🔗lua_stack.active types.lua_widget or nil\nThe currently selected child, can be nil if the container has no child, can be set to one of the child widget or to an index in the child table\nAttributes:\n write  🔗lua_stack.h_size_fixed boolean\nTrue if horizontal size is fixed, false if stack can be resized horizontally.\nAttributes:\n write  🔗lua_stack.v_size_fixed boolean\nTrue if vertical size is fixed, false if stack can be resized vertically.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_stack/","tags":null,"title":"lua_stack"},{"categories":null,"content":"dt_type\nA multiline text input widget\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_text_view.__call see types.lua_widget.As a function\n🔗lua_text_view.extra registration parameters This widget has no extra registration parameters\n🔗lua_text_view.text string\nThe text in the widget\nAttributes:\n write  🔗lua_text_view.editable boolean\nFalse if the entry should be read-only\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_text_view/","tags":null,"title":"lua_text_view"},{"categories":null,"content":"dt_type\nCommon parent type for all lua-handled widgets\nAttributes:\n has_tostring  🔗lua_widget.extra registration parameters This widget has no extra registration parameters\n🔗lua_widget.name string or nil\nName assigned to the widget for CSS styling purposes.\nAttributes:\n write  🔗lua_widget.sensitive boolean\nSet if the widget is enabled/disabled\nAttributes:\n write  🔗lua_widget.tooltip string or nil\nTooltip to display for the widget\nAttributes:\n write  🔗lua_widget.visible boolean or nil\nHide or show widget. Default is show.\nAttributes:\n write  🔗lua_widget.reset_callback function( widget : types.lua_widget ) A function to call when the widget needs to reset itself. Note that some widgets have a default implementation that can be overridden, (containers in particular will recursively reset their children). If you replace that default implementation you need to reimplement that functionality or call the original function within your callback.\nAttributes:\n  write\n  widget - types.lua_widget - The widget that triggered the callback\n  🔗lua_widget.As a function function( attributes : table ) : types.lua_widget Using a lua widget as a function Allows to set multiple attributes of that widget at once. This is mainly used to create UI elements in a more readable way.\nFor example:\nlocal widget = dt.new_widget(\u0026quot;button\u0026quot;){ label =\u0026quot;my label\u0026quot;, clicked_callback = function() print \u0026quot;hello world\u0026quot; end }  attributes - table - A table of attributes =\u0026gt; value to set return - types.lua_widget - The object called itself, to allow chaining  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_widget/","tags":null,"title":"lua_widget"},{"categories":null,"content":"enum\nWhich part of the main window is occupied by a snapshot\nValues:\n left right top bottom  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/snapshot_direction_t/","tags":null,"title":"snapshot_direction_t"},{"categories":null,"content":"","date":"0001-01-01T00:00:00Z","href":"/luadocs/search/","tags":null,"title":"Search"}]
\ No newline at end of file
+[{"categories":null,"content":"This section documents types that are specific to darktable\u0026rsquo;s Lua API.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/overview/","tags":null,"title":"overview"},{"categories":null,"content":"enum\nThe export mode to use for PDF document\nValues:\n normal draft debug  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/_pdf_mode_t/","tags":null,"title":"_pdf_mode_t"},{"categories":null,"content":"🔗Name api_version.lua - show the Lua API version\n🔗Description darktable script to show the Lua API version in the preferences\n🔗Usage  start this script from script manager. darktable must be running in lua debug mode in a terminal to see the output.  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/api_version/","tags":null,"title":"api_version"},{"categories":null,"content":"🔗Name AutoGrouper.lua - automatically group images based on time\n🔗Description This plugin groups images based on the time they were shot. Images shot close together in time are grouped together. The interval of time to separate groups is configurable.\n🔗Usage Start the module using script manager.\nSet a gap amount, in seconds, which will be used to determine when images should no longer be added to a group. If an image is more then the specified amount of time from the last image in the group it will not be added. Images without timestamps in exif data will be ignored.\nThere are two buttons. One allows the grouping to be performed only on the currently selected images, the other button performs grouping on the entire active collection\n🔗Additional Software Required 🔗Limitations 🔗Author Kevin Ertel\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/autogrouper/","tags":null,"title":"AutoGrouper"},{"categories":null,"content":"🔗Name check_for_updates.lua - automatically check for updates\n🔗Description a simple script that will automatically look for newer releases on github and inform when there is something. it will only check on startup and only once a week.\n🔗Usage  install luasec and cjson for Lua 5.3 on your system. Luarocks is a good source for lua packages. start this script from script manager restart darktable  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/check_for_updates/","tags":null,"title":"check_for_updates"},{"categories":null,"content":"This subtable contains function and data to manipulate the darktable user interface with Lua. Most of these function won\u0026rsquo;t do anything if the GUI is not enabled (i.e you are using the command line version darktable-cli instead of darktable).\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/overview/","tags":null,"title":"darktable.gui overview"},{"categories":null,"content":"This table allows referencing all lib objects. lib objects are the graphical blocks within each view. To quickly figure out which lib is which, you can use the following code, which will make a given lib blink.\nlocal dt = require \u0026quot;darktable\u0026quot; local tested_module=\u0026quot;global_toolbox\u0026quot; dt.gui.libs[tested_module].visible=false dt.control.sleep(2000) while true do dt.gui.libs[tested_module].visible = not dt.gui.libs[tested_module].visible dt.control.sleep(2000) end ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/overview/","tags":null,"title":"darktable.gui.libs overview"},{"categories":null,"content":"The different views in darktable\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/overview/","tags":null,"title":"darktable.gui.views overview"},{"categories":null,"content":"🔗NAME dtutils.debug\n🔗SYNOPSIS debugging helpers used in developing darktable lua scripts\n🔗USAGE require \u0026quot;lib/dtutils.debug\u0026quot; 🔗DESCRIPTION dtutils.debug provides an interface to the darktable debugging routines.\n🔗RETURN VALUE dd - library - the darktable lua debugging helpers\n🔗FUNCTIONS 🔗dprint pass a variable to darktable.debug.dump and print the results to stdout\n🔗new_tracepoint create a function returning a tracepoint\n🔗terse_dump set darktable.debug.known to shorten all image dumps to a single line\n🔗tracepoint print out a tracepoint and dump the arguments\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗NAME details\n🔗SYNOPSIS common darktable lua file functions\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; 🔗DESCRIPTION The dtutils.file library provides common file manipulation functions used in constructing darktable lua scripts\n🔗RETURN VALUE df - library - the file functions\n🔗FUNCTIONS 🔗check_if_bin_exists check if an executable exists\n🔗check_if_file_exists check if a file or path exist\n🔗chop_filetype remove a filetype from a filename\n🔗create_unique_filename create a unique filename from the supplied argment\n🔗executable_path_widget create a widget to get executable path preferences\n🔗file_copy copy a file to another name/location\n🔗file_move move a file from one directory to another\n🔗filename_increment add a two digit increment to a filename\n🔗get_basename get the filename without the path or extension\n🔗get_executable_path_preference return the path to an executable from a preference\n🔗get_filename get the filename and extension from a file path\n🔗get_filetype get the filetype from a filename\n🔗get_path get the path from a file path\n🔗mkdir create the directory(ies) if they do not already exists\n🔗rmdir recursively remove a directory\n🔗sanitize_filename make a filename safe to pass as an argument\n🔗set_executable_path_preference set a preference for the path to an executable\n🔗split_filepath split a filepath into parts\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗NAME dtutils.log\n🔗SYNOPSIS darktable lua logging library\n🔗USAGE local log = require \u0026quot;lib/dtutils.log\u0026quot; 🔗DESCRIPTION log provides a multi-level logging solution for use with the darktable lua scripts. With this library you can leave log messages scattered through out your code and only turn them on as necessary.\n🔗RETURN VALUE log - library - the darktable lua logging functions\n🔗FUNCTIONS 🔗caller get the name and line number of the calling routine\n🔗engine get and set the output engine\n🔗log_level get or set the log level\n🔗msg print a log message\n🔗EXAMPLE local log = require \u0026quot;lib/dtutils.log\u0026quot; local cur_level = log.log_level() log.log_level(log.warn) print out warning, error and success messages as code is running\nlog.log_level(debug) print out debugging messages too because this isnt working\nlog.log_level(info) I want to make sure this is working ok\nlog.log_level(cur_level) reset the logging level back to normal\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗DTUTILS.STRING 🔗NAME dtutils.string\n🔗SYNOPSIS a library of string utilities for use in darktable lua scripts\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; 🔗DESCRIPTION This library contains string manipulation routines to aid in building darktable lua scripts.\n🔗RETURN VALUE ds - library - the darktable lua string library\n🔗FUNCTIONS 🔗escape_xml_characters escape characters for xml documents\n🔗is_not_sanitized check if a string has been sanitized\n🔗sanitize surround a string in quotes making it safe to pass as an argument\n🔗sanitize_lua escape lua \u0026lsquo;magic\u0026rsquo; characters from a pattern string\n🔗strip_accents strip accents from characters\n🔗urlencode encode a string in a websafe manner\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗DTUTILS.SYSTEM 🔗NAME dtutils.system\n🔗SYNOPSIS a library of system utilities for use in darktable lua scripts\n🔗USAGE local dtsys = require \u0026quot;lib/dtutils.system\u0026quot; 🔗DESCRIPTION This library contains routines for interfacing to the operating system from darktable lua scripts.\n🔗RETURN VALUE dtsys - library - the darktable lua system library\n🔗FUNCTIONS 🔗external_command pass a command to the operating system for execution and return the result\n🔗launch_default_app open file in default application\n🔗windows_command pass a command to the windows operating system for execution and return the result\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.system/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗NAME dtutils\n🔗SYNOPSIS A Darktable lua utilities library\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; 🔗DESCRIPTION dtutils provides a common library of functions used to build lua scripts.\n🔗RETURN VALUE du- library - the library of functions\n🔗FUNCTIONS 🔗check_min_api_version check the minimum required api version against the current api version\n🔗check_os check that the operating system is supported\n🔗join join a table of strings with a specified separator\n🔗prequire a protected lua require\n🔗spairs an iterator that provides sorted pairs from a table\n🔗split split a string on a specified separator\n🔗SEE ALSO dtutils.debug, dtutils.file, dtutils.log, dtutils.string, dtutils.system\n🔗LICENSE This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.\n🔗COPYRIGHT Copyright (C) 2016 Bill Ferguson wpferguson@gmail.com.\nCopyright (C) 2016 Tobias Jakobs\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/details/","tags":null,"title":"details"},{"categories":null,"content":"🔗Name executable_manager.lua - a tool for managing external executables used by darktable lua scripts\n🔗Description executable_manager is a tool for managing the executable preferences stored in the darktablerc file. On startup the darktablerc file is scanned and a widget is built for each executable path. The user can select the executable from a drop down list and then modify the settings as desired.\nAny changes made using executable_manager won\u0026rsquo;t be saved in the darktablerc file until darktable exits, but the preference is updated when the change is made so scripts will pick up the changes without restarting darktable.\n🔗Usage  start this script from script manager  🔗Additional Software Required None\n🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/executable_manager/","tags":null,"title":"executable_manager"},{"categories":null,"content":"🔗Current API The Lua API version used in darktable 3.8.0 is 8.0.0.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/version/","tags":null,"title":"Lua API Version"},{"categories":null,"content":"The darktable library is the main entry point for all access to the darktable internals. To access the darktable specific functions you must load the darktable environment:\ndarktable = require \u0026quot;darktable\u0026quot;\nAll functions and data are accessed through the darktable module.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/overview/","tags":null,"title":"overview"},{"categories":null,"content":"This section documents events that can be used to trigger Lua callbacks.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/overview/","tags":null,"title":"overview"},{"categories":null,"content":"darktable can be customized and extended using the Lua programming language. The lua-scripts repository contains the collected efforts of the darktable developers, maintainers, contributors and community.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/overview/","tags":null,"title":"overview"},{"categories":null,"content":"darktable can be customized and extended using the Lua programming language. The lua-scripts repository contains the collected efforts of the darktable developers, maintainers, contributors and community. The following sections list the scripts contained in the repository, whether they can be run by themselves (Standalone - Yes) or depend on other scripts (Standalone - No), what operating systems they are known to work on (L - Linux, M - MacOS, W - Windows), and their purpose.\n🔗Official Scripts These scripts are written primarily by the darktable developers and maintained by the authors and/or repository maintainers. They are located in the official/ directory.\n   Name Standalone Op/Sys Purpose     check_for_updates Yes LMW Check for updates to darktable   copy_paste_metadata Yes LMW Copy and paste metadata, tags, ratings, and color labels between images   delete_long_tags Yes LMW Delete all tags longer than a specified length   delete_unused_tags Yes LMW Delete tags that have no associated images   enfuse No L Exposure blend several images (HDR)   generate_image_txt No L Generate txt sidecar files to be overlaid on zoomed images   image_path_in_ui Yes LMW Plugin to display selected image path   import_filter_manager Yes LMW Manager for import filters   import_filters No LMW Two import filters for use with import_filter_manager   save_selection Yes LMW Provide save and restore from multiple selection buffers   selection_to_pdf No L Generate a PDF file from the selected images    🔗Contributed Scripts These scripts are contributed by users. They are meant to have an \u0026ldquo;owner\u0026rdquo;, i.e. the author, who maintains them. Over time the community has helped maintain these scripts, as well as the authors. They are located in the contrib/ directory.\n   Name Standalone Op/Sys Purpose     AutoGrouper Yes LMW Group images together by time   autostyle Yes LMW Automatically apply styles on import   clear_GPS Yes LMW Reset GPS information for selected images   CollectHelper Yes LMW Add buttons to selected images module to manipulate the collection   copy_attach_detach_tags Yes LMW Copy and paste tags from/to images   cr2hdr Yes L Process image created with Magic Lantern Dual ISO   enfuseAdvanced No LMW Merge multiple images into Dynamic Range Increase (DRI) or Depth From Focus (DFF) images   exportLUT Yes LMW Create a LUT from a style and export it   ext_editor No LW Export pictures to collection and edit them with up to nine user-defined external editors   face_recognition No LM Identify and tag images using facial recognition   fujifilm_ratings No LM Support importing Fujifilm ratings   geoJSON_export No L Create a geo JSON script with thumbnails for use in \u0026hellip;   geoToolbox No LMW A toolbox of geo functions   gimp No LMW Open an image in GIMP for editing and return the result   gpx_export No LMW Export a GPX track file from selected images GPS data   HDRMerge No LMW Combine the selected images into an HDR DNG and return the result   hugin No LMW Combine selected images into a panorama and return the result   image_stack No LMW Combine a stack of images to remove noise or transient objects   image_time Yes LMW Adjust the EXIF image time   kml_export No L Export photos with a KML file for usage in Google Earth   LabelsToTags Yes LMW Apply tags based on color labels and ratings   OpenInExplorer No LMW Open the selected images in the system file manager   passport_guide Yes LMW Add passport cropping guide to darkroom crop tool   pdf_slideshow No LM Export images to a PDF slideshow   photils No LM Automatic tag suggestions for your images   quicktag.md Yes LMW Create shortcuts for quickly applying tags   rate_group Yes LMW Apply or remove a star rating from grouped images   rename-tags Yes LMW Change a tag name   RL_out_sharp No LW Output sharpening using GMic (Richardson-Lucy algorithm)   select_untagged Yes LMW Enable selection of untagged images   slideshowMusic No L Play music during a slideshow   transfer_hierarchy Yes LMW Image move/copy preserving directory hierarchy   video_ffmpeg No LMW Export video from darktable    🔗Example Scripts These scripts provide examples of how to use specific portions of the API. They run, but are meant for demonstration purposes only. They are located in the examples/ directory.\n   Name Standalone Op/Sys Purpose     api_version Yes LMW Print the current API version   darkroom_demo Yes LMW Demonstrate changing images in darkoom   gettextExample Yes LM How to use translation   hello_world Yes LMW Prints hello world when darktable starts   lighttable_demo Yes LMW Demonstrate controlling lighttable mode, zoom, sorting and filtering   moduleExample Yes LMW How to create a lighttable module   multi_os No LMW How to create a cross platform script that calls an external executable   panels_demo Yes LMW Demonstrate hiding and showing darktable panels   preferenceExamples Yes LMW How to use preferences in a script   printExamples Yes LMW How to use various print functions from a script   running_os Yes LMW Print out the running operating system    🔗Tools Tool scripts perform functions relating to the repository, such as generating documentation. They are located in the tools/ directory.\n   Name Standalone Op/Sys Purpose     executable_manager Yes LMW Manage the external executables used by the lua scripts   gen_i18n_mo No LMW Generate compiled translation files (.mo) from source files (.po)   get_lib_manpages No LM Retrieve the library documentation and output it in man page and PDF format   get_libdoc No LMW Retrieve the library documentation and output it as text   script_manager No LMW Manage (install, update, enable, disable) the lua scripts    ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/overview/","tags":null,"title":"overview"},{"categories":null,"content":"event\nThis event is triggered from darkroom view whenever an image\u0026rsquo;s history has changed and another image is being loaded or darkroom view is being changed to another view.\n🔗darkroom-image-history-changed.callback function( event : string, image : types.dt_lua_image_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The image loaded into darkroom view  🔗darkroom-image-history-changed.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/darkroom-image-history-changed/","tags":null,"title":"darkroom-image-history-changed"},{"categories":null,"content":"event\nThis event is triggered whenever an image is loaded in darkroom view\n🔗darkroom-image-loaded.callback function( event : string, image : types.dt_lua_image_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The image loaded into darkroom view  🔗darkroom-image-loaded.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/darkroom-image-loaded/","tags":null,"title":"darkroom-image-loaded"},{"categories":null,"content":"function( path : string, instance : integer, element : string, effect : string, speed : integer ) : string Will perform the specified effect on the path, instance, and element of an action, or return the status.\n path - string - The full path of an action, i.e. 'lib/filter/view'. instance - integer - The instance of an image processing module to execute action on\u0026quot;. element - string - The element of an action, for example \u0026lsquo;selection\u0026rsquo;, or leave empty for default\u0026quot;. effect - string - The effect of an action, for example \u0026lsquo;next\u0026rsquo;, or leave empty for default\u0026quot;. speed - integer - 1 causes the effect to be performed, 0 or NaN returns the current status. return - string - The current status of the action.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/action/","tags":null,"title":"darktable.gui.action"},{"categories":null,"content":"enum\nThe different page types for PDF export\nValues :\n all single contact  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/_pdf_pages_t/","tags":null,"title":"_pdf_pages_t"},{"categories":null,"content":"🔗Name autostyle.lua - automatically apply a given style when an exif tag is present in the image file\n🔗Description Automatically apply a given style when an exif tag is present in the file. This tags are checked with exiftool, in order to be able to match very exotic tags. This was written to be able to apply a style to compensate for Auto-DR from Fujifilm cameras.\n🔗Usage   Set the exif configuration string in your lua configuration. For instance, AutoDynamicRange=200%=\u0026gt;DR200 means that I automatically want to apply my DR200 style on all images where exiftool returns \u0026ldquo;200%\u0026rdquo;\u0026quot; for the AutoDynamicRange tag\n  If you want to be able to apply it to already imported images, define a shortcut (lua shortcuts). If the history stack is removed from the image, autostyle won\u0026rsquo;t be applied again. This shortcut useful when that happens.\n  Import your images, or use the shortcut on already imported images\n  To determine which tag you want, list all tags with exiftool: exiftool -j XE021351.RAF, and find the one you want to use. You can check tags with\n\u0026gt; exiftool -AutoDynamicRange XE021351.RAF Auto Dynamic Range : 200%   🔗Additional Software Required  exiftool  🔗Limitations 🔗Author Marc Cousin - cousinmarc@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/autostyle/","tags":null,"title":"autostyle"},{"categories":null,"content":"🔗NAME caller\n🔗SYNOPSIS get the name and line number of the calling routine\n🔗USAGE local log = require \u0026quot;lib/dtutils.log\u0026quot; result = log.caller(level) level - number - the number of stack levels to go down to retrieve the caller routine information\n🔗DESCRIPTION caller gets the name and line number of the calling routine and returns it\n🔗RETURN VALUE result - string - the name and line number of the calling function or \u0026lsquo;callback: ' if the attempt to get the caller returns nil\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/caller/","tags":null,"title":"caller"},{"categories":null,"content":"🔗NAME check_if_bin_exists\n🔗SYNOPSIS check if an executable exists\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.check_if_bin_exists(bin) bin - string - the binary to check for\n🔗DESCRIPTION check_if_bin_exists checks to see if the specified binary exists. check_if_bin_exists looks for an executable in the following order:\n  If an executable preference is registered, then it\u0026rsquo;s checked to make sure it\u0026rsquo;s a file, exists, and is executable. If it passes all these tests it is returned to the caller. On non-windows operating systems a windows binary can be specified and the wine installation will be checked for the executable.\n  If an executable preference doesn\u0026rsquo;t exist or a test fails then an attempt is made to find the file in an operating system specific manner:\n unix or linux  the user\u0026rsquo;s path is checked for a matching binrary using the which command   macos  first the user\u0026rsquo;s path is checked for a matching binrary using the which command if the executable isn\u0026rsquo;t found a search of the /Applications directory is performed   windows  the user\u0026rsquo;s path is checked using the where command if the executable isn\u0026rsquo;t found, then C:\\Program Files is searched for the executable if the executable isn\u0026rsquo;t found, then C:\\Program Files (x86) is searched      🔗RETURN VALUE result - string - the sanitized path of the binary, false if not found\n🔗LIMITATIONS   it still can\u0026rsquo;t find GIMP on windows. GIMP on windows is installed in C:\\Program Files\\GIMP 2\\bin\\gimp-2.10.exe, if you use the installer from www.gimp.org. When check_if_bin_exists searches for GIMP it looks for gimp.exe. If the search was for gimp*exe then things like gimptool, gimp-debug-tool, gimp-console, etc. are found. Depending on who packaged gimp,there is an executable called gimp.exe which satisfies the search but is a GIMP launcher that exits immediately so the script returns and the image is not edited. Therefore, if you are a windows user, then you need to specify the location of the GIMP executable either from the Edit with GIMP script or using executable manager.\n  flickering windows - on windows every command must run in a window, so every time a script uses a system command a window is opened, the command is run, and the window is closed checking for a binary needs multiple system commands to find the file and then check it which causes \u0026ldquo;flickering windows\u0026rdquo;. If the flickering windows is too disturbing a lua preference is available in the settings to use the old check_if_bin_exists(). The old check_if_bin_exists() still causes flickering windows but it\u0026rsquo;s much less. The downside is that no searching is performed so the user has to specify the location of all executables.\n  🔗CHANGELOG 20201225 - Added search capability and file checking to ensure it\u0026rsquo;s an executable - Merry Christmas\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/","tags":null,"title":"check_if_bin_exists"},{"categories":null,"content":"🔗NAME check_min_api_version\n🔗SYNOPSIS check the minimum required application programming interface (API) version against the current API version\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local result = du.check_min_api_version(min_api, script_name) min_api - string - the API version that the application was written for (example: \u0026ldquo;5.0.0\u0026rdquo;)\nscript_name - string - the name of the script\n🔗DESCRIPTION check_min_api_version compares the minimum API required for the application to run against the current API version. The minimum API version is typically the API version that was current when the application was created. If the minimum API version is not met, then an error message is printed saying the script_name failed to load, then an error is thrown causing the program to stop executing.\nThis function is intended to replace darktable.configuration.check_version(). The application code won\u0026rsquo;t have to be updated each time the API changes because this only checks the minimum version required.\n🔗RETURN VALUE result - boolean - true if the minimum API version is available, false if not.\n🔗LIMITATIONS When using the default handler on a script being executed from the luarc file, the error thrown will stop the luarc file from executing any remaining statements. This limitation does not apply to script_manger.\n🔗EXAMPLE check_min_api_version(\u0026quot;5.0.0\u0026quot;) does nothing if the API is greater than or equal to 5.0.0 otherwise an error message is printed and an error is thrown stopping execution of the script.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/check_min_api_version/","tags":null,"title":"check_min_api_version"},{"categories":null,"content":"🔗Name copy_paste_metadata.lua - copy and paste metadata between images\n🔗Description This script adds keyboard shortcuts and buttons to copy/paste metadata between images.\n🔗Usage  start this script from script manager it adds buttons to the selected images module it adds two keyboard shortcuts  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/copy_paste_metadata/","tags":null,"title":"copy_paste_metadata"},{"categories":null,"content":"🔗Name darkroom_demo - an example script demonstrating how to control image display in darkroom mode\n🔗Description darkroom_demo is an example script showing how to control the currently displayed image in darkroom mode using lua.\n🔗Usage  start this script from script manager  🔗Additional Software Required None\n🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/darkroom_demo/","tags":null,"title":"darkroom_demo"},{"categories":null,"content":"Allows to access the currently worked on images, i.e the ones selected by the collection lib. Filtering (rating etc) does not change that collection.\n🔗darktable.collection.# types.dt_lua_image_t\nEach image in the collection appears with a numerical index; you can iterate them using ipairs.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.collection/","tags":null,"title":"darktable.collection"},{"categories":null,"content":"\ntable\nA table of types.dt_lua_image_t on which the user expects UI actions to happen. It is based on both the hovered image and the selection and is consistent with the way darktable works. It is recommended to use this table to implement Lua actions rather than darktable.gui.hovered or darktable.gui.selection to be consistent with darktable\u0026rsquo;s GUI.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/action_images/","tags":null,"title":"darktable.gui.action_images"},{"categories":null,"content":"The window displaying the currently running jobs\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/backgroundjobs/","tags":null,"title":"darktable.gui.libs.backgroundjobs"},{"categories":null,"content":"The darkroom view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  🔗darktable.gui.views.darkroom.display_image function( [image : types.dt_lua_image_t] ) : types.dt_lua_image_t Display an image in darkroom view.\n **[image] - types.dt_lua_image_t - The image to be displayed. If the image is not given, nothing will be changed. return - types.dt_lua_image_t - The image currently displayed.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/darkroom/","tags":null,"title":"darktable.gui.views.darkroom"},{"categories":null,"content":"🔗NAME dprint\n🔗SYNOPSIS pass a variable to darktable.debug.dump and print the results to stdout\n🔗USAGE local dd = require \u0026quot;lib/dtutils.debug\u0026quot; dd.dprint(var) var - variable - any variable that you want to see the contents of\n🔗DESCRIPTION dprint is a wrapper around darktable.debug.dump, will directly print to stdout, same calling convention\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/dprint/","tags":null,"title":"dprint"},{"categories":null,"content":"🔗NAME escape_xml_characters\n🔗SYNOPSIS escape characters for xml documents\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.escape_xml_characters(str) str - string - the string that needs escaped\n🔗DESCRIPTION escape_xml_characters provides the escape sequences for\n\u0026quot;\u0026amp;\u0026quot;, '\u0026quot;', \u0026quot;'\u0026quot;, \u0026quot;\u0026lt;\u0026quot;, and \u0026quot;\u0026gt;\u0026quot; with the corresponding\n\u0026quot;\u0026amp;amp;\u0026quot;,\u0026quot;\u0026amp;quot;\u0026quot;, \u0026quot;\u0026amp;apos;\u0026quot;, \u0026quot;\u0026amp;lt;\u0026quot;, and \u0026quot;\u0026amp;gt;\u0026quot; .\n🔗RETURN VALUE result - string - the string containing escapes for the xml characters\n🔗REFERENCE https://stackoverflow.com/questions/1091945/what-characters-do-i-need-to-escape-in-xml-documents\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/escape_xml_characters/","tags":null,"title":"escape_xml_characters"},{"categories":null,"content":"event\nThis event is triggered when darktable exits, it allows lua scripts to do cleanup jobs\n🔗events.exit.callback function( ) 🔗events.exit.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/exit/","tags":null,"title":"exit"},{"categories":null,"content":"🔗NAME external_command\n🔗SYNOPSIS pass a command to the operating system for execution and return the result\n🔗USAGE local dsys = require \u0026quot;lib/dtutils.system\u0026quot; local result = dsys.external_command(command) command - string - a string containing the command and arguments to be passed to the operating system for execution.\n🔗DESCRIPTION external_command passes a command to the operating system for execution and returns the results.\n🔗RETURN VALUE result - number = the return value signalling success or failure.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.system/external_command/","tags":null,"title":"external_command"},{"categories":null,"content":"🔗Name gen_i18n_mo - generate translation files from the source and place them in the appropriate locale directory\n🔗Description gen_i18n_mo finds all the .po files scattered throughout the script tree, compiles them into .mo files and places them in the correct locale directory for use by the gettext tools.\n🔗Usage  start this script from script manager. Stop the script after it runs or it will regenerate the translation files each time darktable starts.  🔗Additional Software Required 🔗Limitations 🔗Author 🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/gen_i18n_mo/","tags":null,"title":"gen_i18n_mo"},{"categories":null,"content":"🔗Download and Install The recommended method of installation is using git to clone the repository. This ensures that all dependencies on other scripts are met as well as providing an easy update path.\n🔗snap packages The snap version of darktable comes with lua included starting with version 2.4.3snap2.\nEnsure git is installed on your system. If it isn\u0026rsquo;t, use the package manager to install it. Then open a terminal and:\ncd ~/snap/darktable/current git clone https://github.com/darktable-org/lua-scripts.git lua  🔗flatpak packages Flatpak packages now use the internal lua interpreter.\nEnsure git is installed on your system. If it isn\u0026rsquo;t, use the package manager to install it. Then open a terminal and:\ncd ~/.var/app/org.darktable.Darktable/config/darktable git clone https://github.com/darktable-org/lua-scripts.git lua  🔗appimage packages These packages run in their own environment and don\u0026rsquo;t have access to a lua interpreter, therefore the scripts can\u0026rsquo;t run. The packagers could enable the internal interpreter, or allow the package to link the interpreter from the operating system, or bundle a copy of lua with the package. If you use one of these packages and wish to use the lua scripts, please contact the package maintainer and suggest the above fixes.\n🔗Linux and MacOS Ensure git is installed on your system. If it isn\u0026rsquo;t, use the package manager to install it. Then open a terminal and:\ncd ~/.config/darktable/ git clone https://github.com/darktable-org/lua-scripts.git lua  🔗Windows Ensure git is installed on your system. Git can be obtained from https://gitforwindows.org/, as well as other places. If you use the gitforwindows.org distribution, install the Git Bash Shell also as it will aid in debugging the scripts if necessary. Then open a command prompt and run:\ncd %LOCALAPPDATA%\\darktable git clone https://github.com/darktable-org/lua-scripts.git lua  If you don\u0026rsquo;t have %LOCALAPPDATA%\\darktable you have to start dartable at least once, because the directory is created at the first start of darktable.\n🔗Enabling When darktable starts it looks for a file name ~/.config/darktable/luarc (%LOCALAPPDATA%\\darktable\\luarc for windows) and reads it to see which scripts to include. The file is a plain text file with entries of the form require \u0026quot;\u0026lt;directory\u0026gt;/\u0026lt;name\u0026gt;\u0026quot; where directory is the directory containing the scripts, from the above list, and name is the name from the above list. To include GIMP the line would be require \u0026quot;contrib/gimp\u0026quot;.\nThe recommended way to enable and disable specific scripts is using the script manager module. To use script manager do the following:\n🔗Linux or MacOS echo 'require \u0026quot;tools/script_manager\u0026quot;' \u0026gt; ~/.config/darktable/luarc  🔗Windows echo \u0026quot;require 'tools/script_manager'\u0026quot; \u0026gt; %LOCALAPPDATA%\\darktable\\luarc  🔗Snap echo 'require \u0026quot;tools/script_manager\u0026quot;' \u0026gt; ~/snap/darktable/current/luarc  🔗Flatpak echo require \u0026quot;tools/script_manager\u0026quot;' \u0026gt; ~/.var/app/org.darktable.Darktable/config/darktable/luarc  You can also create or add lines to the luarc file from the command line:\necho 'require \u0026quot;contrib/gimp\u0026quot;' \u0026gt; ~/.config/darktable/luarc to create the file with a gimp entry\nor echo 'require \u0026quot;contrib/hugin\u0026quot;' \u0026gt;\u0026gt; ~/.config/darktable/luarc to add an entry for hugin.\nOn windows from a command prompt:\necho require \u0026quot;contrib/gimp\u0026quot; \u0026gt; %LOCALAPPDATA%\\darktable\\luarc to create the file with a gimp entry\nor echo require \u0026quot;contrib/hugin\u0026quot; \u0026gt;\u0026gt; %LOCALAPPDATA%\\darktable\\luarc to add an entry for hugin.\n🔗Disabling To disable a script open the luarc file in your text editor and insert -- at the start of the line containing the script you wish to disable, then save the file.\n🔗Updating To update the script repository, open a terminal or command prompt and do the following:\n🔗Snap cd ~/snap/darktable/current/lua git pull  🔗Flatpak cd ~/.var/app/org.darktable.Darktable/config/darktable/lua git pull  🔗Linux and MacOS cd ~/.config/darktable/lua/ git pull  🔗Windows cd %LOCALAPPDATA%\\darktable\\lua git pull  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/installation/","tags":null,"title":"installation"},{"categories":null,"content":"🔗NAME check_if_file_exists\n🔗SYNOPSIS check if a file or path exist\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.check_if_file_exists(filepath) filepath - string - a file or path to check\n🔗DESCRIPTION check_if_file_exists checks to see if a file or path exists.\n🔗RETURN VALUE result - boolean - true if the file or path exists, false if it doesn\u0026rsquo;t.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/check_if_file_exists/","tags":null,"title":"check_if_file_exists"},{"categories":null,"content":"🔗NAME check_os\n🔗SYNOPSIS check that the operating system is supported\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local result = du.check_os(operating_systems) operating_systems - table - a table of operating system names such as {\u0026ldquo;windows\u0026rdquo;,\u0026ldquo;linux\u0026rdquo;,\u0026ldquo;macos\u0026rdquo;,\u0026ldquo;unix\u0026rdquo;}\n🔗DESCRIPTION check_os checks a supplied table of operating systems against the operating system the script is running on and returns true if the OS is in the list, otherwise false\n🔗RETURN VALUE result - boolean - true if the operating system is supported, false if not.\n🔗EXAMPLE local du = require \u0026quot;lib/dtutils\u0026quot; if du.check_os({\u0026quot;windows\u0026quot;}) then -- run the script else dt.print(\u0026quot;Script \u0026lt;script name\u0026gt; only runs on windows\u0026quot;) return end ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/check_os/","tags":null,"title":"check_os"},{"categories":null,"content":"🔗Name clear_GPS.lua - clear_GPS - clear GPS data from selected image(s)\n🔗Description This shortcut removes the GPS coordinate data from the selected images.\n🔗Usage  start the script from script manager select an image or images click the shortcut, or the button in selected images to clear GPS data  🔗Additional Software Required 🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/clear_gps/","tags":null,"title":"clear_GPS"},{"categories":null,"content":"enum\nType of compression for webp\nValues:\n webp_lossy webp_lossless  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/comp_type_t/","tags":null,"title":"comp_type_t"},{"categories":null,"content":"table\nThis table includes values that describe details of the configuration of darktable.\n🔗darktable.configuration.version string\nThe version number of darktable.\n🔗darktable.configuration.has_gui boolean\nTrue if darktable has a GUI (launched through the main darktable command, not darktable-cli).\n🔗darktable.configuration.verbose boolean\nTrue if the Lua logdomain is enabled.\n🔗darktable.configuration.tmp_dir string\nThe name of the directory where darktable will store temporary files.\n🔗darktable.configuration.config_dir string\nThe name of the directory where darktable will find its global configuration objects (modules).\n🔗darktable.configuration.cache_dir string\nThe name of the directory where darktable will store its mipmaps.\n🔗darktable.configuration.api_version_major number\nThe major version number of the lua API.\n🔗darktable.configuration.api_version_minor number\nThe minor version number of the lua API.\n🔗darktable.configuration.api_version_patch number\nThe patch version number of the lua API.\n🔗darktable.configuration.api_version_suffix string\nThe version suffix of the lua API.\n🔗darktable.configuration.api_version_string string\nThe version description of the lua API. This is a string compatible with the semantic versioning convention\n🔗darktable.configuration.running_os string\nThe name of the Operating system darktable is currently running on\n🔗darktable.configuration.check_version function( module_name : string, ... : table... ) Check that a module is compatible with the running version of darktable Add the following line at the top of your module : darktable.configuration.check(...,{M,m,p},{M2,m2,p2}) To document that your module has been tested with API version M.m.p and M2.m2.p2. This will raise an error if the user is running a released version of DT and a warning if he is running a development version (the \u0026hellip; here will automatically expand to your module name if used at the top of your script).\n module_name - string - The name of the module to report on error \u0026hellip; - table - Tables of API versions that are known to work with the script  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.configuration/","tags":null,"title":"darktable.configuration"},{"categories":null,"content":"function( text : string, [percentage : boolean], [cancel_callback : function] ) : types.dt_lua_backgroundjob_t Create a new progress_bar displayed in darktable.gui.libs.backgroundjobs\n  text - string - The text to display in the job entry\n  [percentage] - boolean - Should a progress bar be displayed\n  [cancel_callback] - function - A function called when the cancel button for that job is pressed. Note: the job won\u0026rsquo;t be destroyed automatically. You need to set types.dt_lua_backgroundjob_t.valid to false for that.\n  return - types.dt_lua_backgroundjob_t - The newly created job object\n  🔗cancel_callback function( job : types.dt_lua_backgroundjob_t )  job - types.dt_lua_backgroundjob_t - The job that is being cancelled  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/create_job/","tags":null,"title":"darktable.gui.create_job"},{"categories":null,"content":"The camera selection UI\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/camera/","tags":null,"title":"darktable.gui.libs.camera"},{"categories":null,"content":"The lighttable view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  🔗darktable.gui.views.lighttable.is_image_visible function( image : types.dt_lua_image_t ) : types.dt_lua_image_t Check if the image is visible in lighttable view. The lighttable must be in file manager or zoomable mode.\n image - types.dt_lua_image_t - The image to be checked. return - boolean - True if the image is displayed. False if the image is partially displayed or not displayed.  🔗darktable.gui.views.lighttable.set_image_visible function( image : types.dt_lua_image_t ) : types.dt_lua_image_t Set the image visible in lighttable view. The lighttable must be in file manager or zoomable mode.\n image - types.dt_lua_image_t - The image to set visible. return - int - An error is returned if no image is specified.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/lighttable/","tags":null,"title":"darktable.gui.views.lighttable"},{"categories":null,"content":"🔗Name delete_long_tags.lua - delete all tags longer than a set length\n🔗Description A simple script that will automatically delete all tags longer than a set length\n🔗Usage  start this script from script manager set the the maximum length in darktable\u0026rsquo;s preference restart darktable  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/delete_long_tags/","tags":null,"title":"delete_long_tags"},{"categories":null,"content":"🔗NAME engine\n🔗SYNOPSIS get and set the output engine\n🔗USAGE local log = require \u0026quot;lib/dtutils.log\u0026quot; result = log.engine(level, ...) level - table - the log level to get or set the engine for, one of log.debug, log.info, log.warn, log.error log.success, log.always, log.screen, log.critical\n\u0026hellip; - function - the output function, one of dt.print, dt.print_error, dt.print_log, print if not function is included, the current engine is returned for the specified log level\n🔗DESCRIPTION engine returns the output engine for the specified log level if a second argument is not supplied. If a function is supplied as the second argment, then the output engine for the specified log level is set to that.\n🔗RETURN VALUE result - function - the current output engine\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/engine/","tags":null,"title":"engine"},{"categories":null,"content":"🔗Name get_lib_manpages.lua - retrieve the included library documentation and output it as man pages\n🔗Description This script retrieves the included documentation in the script libaries and outputs them to the system temporary directory as man pages. Stop this script after it runs otherwise it will regenerate the pages each time it runs.\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author 🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/get_lib_manpages/","tags":null,"title":"get_lib_manpages"},{"categories":null,"content":"🔗Name gettextExample.lua - darktable script to show how translations works\n🔗Description To create the .po file run: xgettext -l lua gettextExample.lua\nxgettext is not a lua tool, it knows (almost) nothing about Lua, and not enough to do a proper parsing. It takes a text file (In our case a Lua file) and recognises a few (language dependant) keyword in there. It matches those keywords with internal description on how functions are called and creates the .po file accordingly. (For example, it knows that the first argument of gettext() is the translated string, but that it\u0026rsquo;s the second argument for dgettext) This is important because it means that if you use some neat Lua tricks (like renaming functions) xgettext won\u0026rsquo;t recognize those calls and won\u0026rsquo;t extract the string to the .po file. So, this is why we create a local variagle gettext = dt.gettext, so xgettext recognises gettext.gettext as a function but not dt.gettext.gettext\nTo create a .mo file run: msgfmt -v gettextExample.po -o gettextExample.mo\n🔗Usage  start this script from script manager copy the gettextExample.mo to .config/darktable/lua/de_DE/LC_MESSAGES  You need to start darktable with the Lua debug option: darktable -d lua $LANG must set to: de_DE\nThe script run on darktable startup and should output this three lines:\nLUA ERROR Hello World! LUA ERROR Bild LUA ERROR Hallo Welt! 🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/gettextexample/","tags":null,"title":"gettextExample"},{"categories":null,"content":"event\nThis event is triggered after the user toggled the grouping button.\n🔗global_toolbox-grouping_toggle.callback function( toggle : boolean )  toggle - boolean - the new grouping status.  🔗global_toolbox-grouping_toggle.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/global_toolbox-grouping_toggle/","tags":null,"title":"global_toolbox-grouping_toggle"},{"categories":null,"content":"🔗NAME is_not_sanitized\n🔗SYNOPSIS Check if a string has been sanitized\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.is_not_sanitized(str) str - string - the string that needs to be made safe\n🔗DESCRIPTION is_not_sanitized checks a string to see if it has been made safe use passing as an argument in a system command.\n🔗RETURN VALUE result - boolean - true if the string is not sanitized otherwise false\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/is_not_sanitized/","tags":null,"title":"is_not_sanitized"},{"categories":null,"content":"🔗NAME launch_default_app\n🔗SYNOPSIS open file in default application\n🔗USAGE local dsys = require \u0026quot;lib/dtutils.file\u0026quot; result = dsys.launch_default_app(path) path - string - a file path\n🔗DESCRIPTION launch_default_app allows opening a file in the application that is assigned as default for that filetype in the users\u0026rsquo;s system\n🔗RETURN VALUE result - number - the return value signalling success or failure.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.system/launch_default_app/","tags":null,"title":"launch_default_app"},{"categories":null,"content":"🔗NAME new_tracepoint\n🔗SYNOPSIS create a function returning a tracepoint\n🔗USAGE local dd = require \u0026quot;lib/dtutils.debug\u0026quot; local result = dd.new_tracepoint(name, ...) name - string - the name of the tracepoint to print out\n\u0026hellip; - arguments - variables to dump the contents of\n🔗DESCRIPTION new_tracepoint returns a tracepoint function with the given name. This is mainly used to debug callbacks.\n🔗RETURN VALUE result - function - a function that returns the result of a tracepoint\n🔗EXAMPLE register_event(event, dd.new_tracepoint(\u0026quot;hit callback\u0026quot;)) will print the following each time the callback is called\n**** hit callback **** \u0026lt;all the callback's parameters dumped\u0026gt; ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/new_tracepoint/","tags":null,"title":"new_tracepoint"},{"categories":null,"content":"Running darktable with Lua debugging enabled provides more information about what is occurring within the scripts.\n🔗Snap Open a terminal and start darktable with the command snap run darktable -d lua. This provides debugging information to give you insight into what is happening.\n🔗Linux Open a terminal and start darktable with the command darktable -d lua. This provides debugging information to give you insight into what is happening.\n🔗MacOS Open a terminal and start darktable with the command /Applications/darktable.app/Contents/MacOS/darktable -d lua. This provides debugging information to give you insight into what is happening.\n🔗Windows Open a command prompt. Start darktable with the command \u0026ldquo;C:\\Program Files\\darktable\\bin\\darktable\u0026rdquo; -d lua \u0026gt; log.txt. This provides debugging information to give you insight into what is happening.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/troubleshooting/","tags":null,"title":"troubleshooting"},{"categories":null,"content":"🔗NAME deprecated\n🔗SYNOPSIS warn that a script is deprecated\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; du.deprecated(script_name, deprecation_time) script_name - string - the name of the script, i.e. \u0026ldquo;contrib/clear_GPS\u0026rdquo;\ndeprecation_time - string - when the script will be removed, i.e. \u0026ldquo;darktable release 4.0\u0026rdquo;\n🔗DESCRIPTION deprecated gives users a warning that a script is outdated or no longer useful and will be removed at the specified time\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/deprecated/","tags":null,"title":"deprecated"},{"categories":null,"content":"🔗NAME find_image_by_id\n🔗SYNOPSIS look up an image by ID in the database\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local img = du.find_image_by_id(imgid) imgid - int - the image ID to retrieve\n🔗DESCRIPTION find_image_by_id looks up an image by ID in the database.\n🔗RETURN VALUE img - dt_lua_image_t - image with the given ID if found, nil if not\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/find_image_by_id/","tags":null,"title":"find_image_by_id"},{"categories":null,"content":"🔗NAME chop_filetype\n🔗SYNOPSIS remove a filetype from a filename\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.chop_filetype(path) path - string - a filename with or without a path\n🔗DESCRIPTION chop_filetype removes the filetype from the filename.\n🔗RETURN VALUE result - string - the path and filename without the filetype\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/chop_filetype/","tags":null,"title":"chop_filetype"},{"categories":null,"content":"🔗Name CollectHelper.lua - add buttons to help with collections\n🔗Description This plugin adds the button(s) to the \u0026ldquo;Selected Images\u0026rdquo; module:\n Return to Previous Collection Collect on image\u0026rsquo;s Folder Collect on image\u0026rsquo;s Color Label(s) Collect on All (AND)  It also adds 3 preferences to the lua options dialog box which allow the user to activate/deactivate the 3 \u0026ldquo;Collect on\u0026rdquo; buttons.\nButton Behavior:\n Return to Previous Collection - Will reset the collect parameters to the previously active settings Collect on image\u0026rsquo;s Folder - Will change the collect parameters to be \u0026ldquo;Folder\u0026rdquo; with a value of the selected image\u0026rsquo;s folder location Collect on image\u0026rsquo;s Color Label(s) - Will change the collect parameter to be \u0026ldquo;Color\u0026rdquo; with a value of the selected images color labels, will apply multiple parameters with AND logic if multiple exist Collect on All (AND) - Will collect on all parameters activated by the preferences dialog, as such this button is redundant if you only have one of the two other options enabled  🔗Usage   start CollectHelper with script manager.\n  Select the photo you wish to change you collection based on. In the \u0026ldquo;Selected Images\u0026rdquo; module click on \u0026ldquo;Collect on this Image\u0026rdquo;\n  🔗Additional Software Required 🔗Limitations 🔗Author Kevin Ertel\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/collecthelper/","tags":null,"title":"CollectHelper"},{"categories":null,"content":"This table contain function to manipulate the control flow of lua programs. It provides ways to do background jobs and other related functions\n🔗darktable.control.ending boolean\nTRUE when darktable is terminating Use this variable to detect when you should finish long running jobs\n🔗darktable.control.dispatch function( function : function, ... : anything ) Runs a function in the background. This function will be run at a later point, after luarc has finished running. If you do a loop in such a function, please check darktable.control.ending in your loop to finish the function when darktable exits\n function - function - The call to dispatch \u0026hellip; - anything - extra parameters to pass to the function  🔗darktable.control.sleep function( delay : int ) Suspends execution while not blocking darktable\n delay - int - The delay in millisecond to sleep  🔗darktable.control.execute function( command : string ) : int Run a command in a shell while not blocking darktable\n command - string - The command to run, as in \u0026lsquo;sh -c\u0026rsquo; return - int - The result of the system call  🔗darktable.control.read function( file : file ) Block until a file is readable while not blocking darktable This function is not available on Windows builds\n file - file - The file object to wait for  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.control/","tags":null,"title":"darktable.control"},{"categories":null,"content":"function( [view : types.dt_lua_view_t] ) : types.dt_lua_view_t Get or change the current view.\n [view] - _types.dt_lua_view_t_ - The view to switch to. If empty the current view is unchanged return - _types.dt_lua_view_t_ - the current view  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/current_view/","tags":null,"title":"darktable.gui.current_view"},{"categories":null,"content":"The collection UI element that allows to filter images by collection\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.collect.filter function( [rules : array of types.dt_lib_collect_params_rule_t] ) : array oftypes.dt_lib_collect_params_rule_t Get or change the list of visible images\nAttributes:\n  implicit_yield\n  [rules] - array of types.dt_lib_collect_params_rule_t - A table of rules describing the filter. These rules will be applied after this call\n  return - array of types.dt_lib_collect_params_rule_t - The rules that were applied before this call.\n  🔗darktable.gui.libs.collect.new_rule function( ) : types.dt_lib_collect_params_rule_t Returns a newly created rule object\n return - types.dt_lib_collect_params_rule_t - The newly created rule  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/collect/","tags":null,"title":"darktable.gui.libs.collect"},{"categories":null,"content":"The map view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  🔗darktable.gui.views.map.latitude  number - The latitude of the center of the map  Attributes:\n write  🔗darktable.gui.views.map.longitude  number - The longitude of the center of the map  Attributes:\n write  🔗darktable.gui.views.map.zoom  number - The current zoom level of the map  Attributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/map/","tags":null,"title":"darktable.gui.views.map"},{"categories":null,"content":"🔗Name delete_unused_tags.lua - automatically delete all tags that are not attached to any images\n🔗Description A simple script that will automatically delete all tags that are not attached to any images\n🔗Usage  start this script from script manager restart darktable  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/delete_unused_tags/","tags":null,"title":"delete_unused_tags"},{"categories":null,"content":"enum\nThe different elements on which a collection can be filtered\nValues:\n DT_COLLECTION_FILTER_ALL DT_COLLECTION_FILTER_STAR_NO DT_COLLECTION_FILTER_STAR_1 DT_COLLECTION_FILTER_STAR_2 DT_COLLECTION_FILTER_STAR_3 DT_COLLECTION_FILTER_STAR_4 DT_COLLECTION_FILTER_STAR_5 DT_COLLECTION_FILTER_REJECT DT_COLLECTION_FILTER_NOT_REJECT  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_filter_t/","tags":null,"title":"dt_collection_filter_t"},{"categories":null,"content":"🔗Name get_libdoc.lua - retrieve the included library documentation and output it as text\n🔗Description 🔗Usage  start this script from script manager. Disable it after it finishes or it will generate the pages every time darktable runs.  🔗Additional Software Required 🔗Limitations 🔗Author 🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/get_libdoc/","tags":null,"title":"get_libdoc"},{"categories":null,"content":"event\nThis event is triggered after the user toggled the overlay button.\n🔗global_toolbox-overlay_toggle.callback function( toggle : boolean )  toggle - boolean - the new overlay status.  🔗global_toolbox-overlay_toggle.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/global_toolbox-overlay_toggle/","tags":null,"title":"global_toolbox-overlay_toggle"},{"categories":null,"content":"🔗Name hello_world.lua - a simple lua script\n🔗Description prints \u0026ldquo;hello world when DT starts\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/hello_world/","tags":null,"title":"hello_world"},{"categories":null,"content":"🔗NAME join\n🔗SYNOPSIS join a table of strings with a specified separator\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local result = du.join(tabl, pat) tabl - table - a table of strings\npat - string - a separator\n🔗DESCRIPTION join assembles a table of strings into a string with the specified pattern in between each string\n🔗RETURN VALUE result - string - the joined string on success, or an empty string on failure\n🔗EXAMPLE join({a, \u0026quot;long\u0026quot;, \u0026quot;path\u0026quot;, \u0026quot;name\u0026quot;, \u0026quot;to\u0026quot;, a, \u0026quot;file.txt\u0026quot;}, \u0026quot; \u0026quot;) would return the string \u0026ldquo;a long path name to a file.txt\u0026rdquo;\n🔗REFERENCE http://lua-users.org/wiki/SplitJoin\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/join/","tags":null,"title":"join"},{"categories":null,"content":"🔗NAME log_level\n🔗SYNOPSIS get or set the log level\n🔗USAGE local log = require \u0026quot;lib/log\u0026quot; local result = log.log_level(...) \u0026hellip; - arguments - if none is supplied, then the current log level is returned as one of: log.debug, log.info, log.warn, log.error, log.success. If one of log.debug, log.info, log.warn, log.error, or log.success is supplied as the argument then the log level is set to that value. All log levels greater than or equal in value will be enabled. Any levels of lesser value will be disabled.\n🔗DESCRIPTION log_level gets and sets the logging level. When called with no arguments the current log level is returned as one of log.debug, log.info, log.warn, log.error, or log.success. When called with one of log.debug, log.info, log.warn, log.error or log.success then the log level is set. When setting the log level all levels equal or greater are enabled and any of lesser value are disabled. See the example.\n🔗RETURN VALUE result - log level - one of log.debug, log.info, log.warn, log.error or log.success\n🔗EXAMPLE Assume that the current log level is log.error. Calling\nlog.log_level() will return log.error. Calling\nlog.log_level(log.info) will leave log.debug disabled, and enable log.info, log.warn, log.error and log.success. log.info will be returned as the log_level.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/log_level/","tags":null,"title":"log_level"},{"categories":null,"content":"🔗NAME sanitize\n🔗SYNOPSIS surround a string in quotes making it safe to pass as an argument\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.sanitize(str) str - string - the string that needs to be made safe\n🔗DESCRIPTION sanitize converts a string into a version suitable for use passing as an argument in a system command.\n🔗RETURN VALUE result - string - a websafe string\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/sanitize/","tags":null,"title":"sanitize"},{"categories":null,"content":"🔗NAME terse_dump\n🔗SYNOPSIS set darktable.debug.known to shorten all image dumps to a single line\n🔗USAGE local dd = require \u0026quot;lib/dtutils.debug\u0026quot; dd.terse_dump() 🔗DESCRIPTION terse_dump sets darktable.debug.known to shorten all images to a single line. If you don\u0026rsquo;t need to debug the content of images, this will avoid them flooding your logs.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/terse_dump/","tags":null,"title":"terse_dump"},{"categories":null,"content":"🔗NAME windows_command\n🔗SYNOPSIS pass a command to the windows operating system for execution and return the result\n🔗USAGE local dsys = require \u0026quot;lib/dtutils.system\u0026quot; local result = dsys.windows_command(command) command - string - a string containing the command and arguments to be passed to the operating system for execution.\n🔗DESCRIPTION The normal method of executing an operating system command is using dt.control.execute(), but that doesn\u0026rsquo;t work with Windows when more than one item in the command is quoted. In order to ensure command execution on Windows we create a batch file in the temporary directory, put the command in it, execute the batch file, then return the result.\n🔗RETURN VALUE result - number - the return value signalling success or failure.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.system/windows_command/","tags":null,"title":"windows_command"},{"categories":null,"content":"This section documents various attributes used throughout the documentation.\n🔗write This object is a variable that can be written to.\n🔗has_tostring This object has a specific reimplementation of the \u0026ldquo;tostring\u0026rdquo; method that allows pretty-printing it.\n🔗implicit_yield This call will release the Lua lock while executing, thus allowing other Lua callbacks to run.\n🔗parent This object inherits some methods from another object. You can call the methods from the parent on the child object\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/attributes/","tags":null,"title":"attributes"},{"categories":null,"content":"🔗Name copy_attach_detach_tags.lua - tools to manipulate image tags\n🔗Description This script that will create four shortcuts and add a module in lighttable mode to copy, paste, replace and remove tags from images.\n🔗Usage  set the shortcuts for copy, attach and detach in the preferences dialog \u0026lt;your shortcut1\u0026gt; copy will create a list of tags from all selected images \u0026lt;your shortcut2\u0026gt; paste copied tags to selected images, whereby darktable internal tags starting with \u0026lsquo;darktable|\u0026rsquo; will not be touched \u0026lt;your shortcut3\u0026gt; removes all except darktable internal tags from selected images \u0026lt;your shortcut4\u0026gt; replaces all tags except darktable internals A module reset will empty the clipboard  🔗Additional Software Required 🔗Limitations 🔗Author Christian Kanzian\nHolger Klemm\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags/","tags":null,"title":"copy_attach_detach_tags"},{"categories":null,"content":"🔗NAME create_unique_filename\n🔗SYNOPSIS create a unique filename from the supplied argument\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.create_unique_filename(filepath) filepath - string - the path and filename requested\n🔗DESCRIPTION create_unique_filename takes a requested filepath and checks to see if it exists. If if doesn\u0026rsquo;t then it\u0026rsquo;s returned intact. If it already exists, then a two digit increment is added to the filename and it is tested again. The increment keeps increasing until either a unique filename is found or there have been 100 attempts.\n🔗RETURN VALUE result - string - the incremented filename\n🔗LIMITATIONS create_unique_filename will only attempt 100 increments.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/create_unique_filename/","tags":null,"title":"create_unique_filename"},{"categories":null,"content":"Allows access to the database of images. Note that duplicate images (images with the same RAW but different XMP) will appear multiple times with different duplicate indexes. Also note that all images are here. This table is not influenced by any GUI filtering (collections, stars etc\u0026hellip;).\n🔗darktable.database.# types.dt_lua_image_t\nEach image in the database appears with a numerical index; you can iterate over them using ipairs.\n🔗darktable.database.duplicate function( image : types.dt_lua_image_t ) : types.dt_lua_image_t Creates a duplicate of an image and returns it.\n image - types.dt_lua_image_t - the image to duplicate return - types.dt_lua_image_t - The new image object.  🔗darktable.database.import function( location : string ) : types.dt_lua_image_t Imports new images into the database.\n location - string - The filename or directory to import images from. NOTE: If the images are set to be imported recursively in preferences only the toplevel film is returned (the one whose path was given as a parameter). NOTE 2: If the parameter is a directory the call is nonblocking; the film object will not have the newly imported images yet. Use a post-import-film filtering on that film to react when images are actually imported. return - types.dt_lua_image_t - The created image if an image is imported or the toplevel film object if a film was imported.  🔗darktable.database.get_image function( image_id : int, ) : types.dt_lua_image_t Get an image, specified by image_id, from the database.\n image_id - int - The id number of the image to get return - types.dt_lua_image_t - The image object if found, otherwise nil  🔗darktable.database.move_image function( image : types.dt_lua_image_t, film : types.dt_lua_film_t, [newname : string] ) Physically moves an image (and all its duplicates) to another film, and/or renames the image file. This will move the image file, the related XMP and all XMP for the duplicates to the directory of the new film and rename them as specified. Note that the order of the two required parameters is not relevant.\n image - types.dt_lua_image_t - The image to move film - types.dt_lua_image_t - The film to move to. To rename a file within the same film, set this to the image\u0026rsquo;s current film. [newname] - string - (Optional) If provided, rename the file with this new name. Must not contain any path separator characters.  🔗darktable.database.copy_image function( image : types.dt_lua_image_t, film : types.dt_lua_film_t, [newname : string] ) : types.dt_lua_image_t Physically copies an image to another film. This will copy the image file and the related XMP to the directory of the new film and rename them as specified. If there is already a file with the same name as the image file, it will create a duplicate from that file instead. Note that the order of the two required parameters is not relevant.\n image - types.dt_lua_image_t - The image to copy film - types.dt_lua_image_t - The film to copy to. To make a copy of a file within the same film, set this to the image\u0026rsquo;s current film. [newname] - string - (Optional) If provided, give the copy this new filename. Must not contain any path separator characters. return - types.dt_lua_image_t - The new image  🔗darktable.database.delete see types.dt_lua_image_t.delete\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.database/","tags":null,"title":"darktable.database"},{"categories":null,"content":"types.dt_lua_image_t\nThe image under the cursor or nil if no image is hovered.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/hovered/","tags":null,"title":"darktable.gui.hovered"},{"categories":null,"content":"The color buttons that allow to set labels on an image\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/colorlabels/","tags":null,"title":"darktable.gui.libs.colorlabels"},{"categories":null,"content":"The print view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/print/","tags":null,"title":"darktable.gui.views.print"},{"categories":null,"content":"enum\nThe different elements on which a collection can be filtered\nValues:\n DT_COLLECTION_PROP_FILMROLL DT_COLLECTION_PROP_FOLDERS DT_COLLECTION_PROP_CAMERA DT_COLLECTION_PROP_TAG DT_COLLECTION_PROP_DAY DT_COLLECTION_PROP_TIME DT_COLLECTION_PROP_IMPORT_TIMESTAMP DT_COLLECTION_PROP_CHANGE_TIMESTAMP DT_COLLECTION_PROP_EXPORT_TIMESTAMP DT_COLLECTION_PROP_PRINT_TIMESTAMP DT_COLLECTION_PROP_HISTORY DT_COLLECTION_PROP_COLORLABEL DT_COLLECTION_PROP_TITLE DT_COLLECTION_PROP_DESCRIPTION DT_COLLECTION_PROP_CREATOR DT_COLLECTION_PROP_PUBLISHER DT_COLLECTION_PROP_RIGHTS DT_COLLECTION_PROP_LENS DT_COLLECTION_PROP_FOCAL_LENGTH DT_COLLECTION_PROP_ISO DT_COLLECTION_PROP_APERTURE DT_COLLECTION_PROP_FILENAME DT_COLLECTION_PROP_GEOTAGGING  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_properties_t/","tags":null,"title":"dt_collection_properties_t"},{"categories":null,"content":"🔗Name enfuse.lua - merge the selected images into one tonemapped image and import the result\n🔗Description This script uses enfuse to merge the selected images into one tonemapped image and imports the result. It only works on ldr images (like, JPEG).\n🔗Usage  start this script from script manager it creates a new lighttable module  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/enfuse/","tags":null,"title":"enfuse"},{"categories":null,"content":"event\nThis event is called each time an image is exported, once for each image after the image has been processed to an image format but before the storage has moved the image to its final destination. The call is blocking.\n🔗intermediate-export-image.callback function( event : string, image : types.dt_lua_image_t, filename : string, format : types.dt_imageio_module_format_t, storage : types.dt_imageio_module_storage_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The image object that has been exported. filename - string - The name of the file that is the result of the image being processed. format - types.dt_imageio_module_format_t - The format used to export the image. storage - types.dt_imageio_module_storage_t - The storage used to export the image (can be nil).  🔗intermediate-export-image.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/intermediate-export-image/","tags":null,"title":"intermediate-export-image"},{"categories":null,"content":"🔗Name lighttable_demo.lua - an example script demonstrating how to control lighttable display modes\n🔗Description lighttable_demo is an example script showing how to control lighttable layout, sorting, and filtering from a lua script. If the selected directory has different ratings, color labels, etc, then the sorting and filtering display is a little clearer.\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/lighttable_demo/","tags":null,"title":"lighttable_demo"},{"categories":null,"content":"🔗NAME msg\n🔗SYNOPSIS print a log message\n🔗USAGE local log = require \u0026quot;lib/log\u0026quot; log.msg(level, ...) level - table - the type of message, one of:\n log.debug - debugging messages log.info - informational messages log.warn - warning messages log.error - error messages log.success - success messages log.always - an internal message for debugging log.screen - output 1 line of text to the screen log.critical - print a critical message to the console  \u0026hellip; - string(s) - the message to print, which could be a comma separated set of strings\n🔗DESCRIPTION msg checks the level to see if it is enabled, then prints the level type and message if it is. Messages are output using the engine configured in each log level.\n🔗LIMITATIONS If you use log.msg in a callback, the name of the calling routine can\u0026rsquo;t be determined. A solution is to include some means of reference such as the name of the callback as an argument, i.e.\nlog.msg(log.debug, \u0026quot;libPlugin.format_combobox:\u0026quot;, \u0026quot;value is \u0026quot; .. self.value) which would result in\nDEBUG: callback: libPlugin.format_combobox: value is JPEG ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.log/msg/","tags":null,"title":"msg"},{"categories":null,"content":"🔗NAME prequire\n🔗SYNOPSIS a protected lua require\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local status, lib = du.prequire(req_name) req_name - string - the filename of the lua code to load without the \u0026ldquo;.lua\u0026rdquo; filetype\n🔗DESCRIPTION prequire is a protected require that can survive an error in the code being loaded without bringing down the calling routine.\n🔗RETURN VALUE status - boolean - true on success lib - if status is true, then the code, otherwise an error message\n🔗EXAMPLE local status, lib = prequire(\u0026quot;lib/dtutils.file\u0026quot;) which would load lib/dtutils/file.lua which would return a status of true and the reference to the library.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/prequire/","tags":null,"title":"prequire"},{"categories":null,"content":"🔗NAME sanitize_lua\n🔗SYNOPSIS escape lua \u0026lsquo;magic\u0026rsquo; characters from a pattern string\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.sanitize_lua(str) str - string - the string that needs to be made safe\n🔗DESCRIPTION sanitize_lua escapes lua \u0026lsquo;magic\u0026rsquo; characters so that a string may be used in lua string/patten matching.\n🔗RETURN VALUE result - string - a lua pattern safe string\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/sanitize_lua/","tags":null,"title":"sanitize_lua"},{"categories":null,"content":"🔗Name script_manager.lua - a tool for managing the darktable lua scripts\n🔗Description script_manager is designed to be called from the users luarc file and used to manage the lua scripts.\nOn startup script_manager scans the lua scripts directory to see what scripts are present. Scripts are sorted by \u0026lsquo;category\u0026rsquo; based on what sub-directory they are in. With no additional script repositories iinstalled, the categories are contrib, examples, official and tools. When a category is selected the buttons show the script name and whether the script is started or stopped. The button is a toggle, so if the script is stopped click the button to start it and vice versa.\n🔗Features   the number of script buttons shown can be changed to any number between 5 and 20. The default is 10 buttons. This can be changed in the configuration action.\n  additional repositories of scripts may be installed from the install/update action.\n  installed scripts can be updated from the install/update action. This includes extra repositories that have been installed.\n  the lua scripts can be disabled if desired from the install/update action.\n  script_manager is automatically installed and enabled when the lua scripts are installed by the darktable scripts_installer.\n  🔗Usage   start/stop scripts -\n The top part of the window has the category selector. The category corresponds to the directory that the scripts are in. Currently the categories are contrib for community contributed scripts, examples for example scripts, official for developer contributed scripts, and tools containing tools for managing the lua scripts. The lower part of the window contains the paged interface for the scripts contained in the selected category. There are arrow buttons for navigating the pages and an indicator showing what the current page is and how many pages of scripts there are for the current category. The number of buttons defaults to 10, but is configurable anywhere between 5 and 20 depending on how much screen real estate you want to use. The scripts are sorted alphabetically. The button shows the name of the script and it\u0026rsquo;s current status, started or stopped. Clicking the script button toggles the script from started to stopped and back again.    configure - this window allows changing the number of buttons used to display scripts. Move the slider to select the number of buttons, click the change number of buttons button and the number of buttons will change and the action will change back to the start/stop scripts window.\n  install/update scripts - This window allows installing additional script repositories and updating installed repositories.\n  update - select the scripts to update from the scripts to update dropdown. Click the update scripts button to do the update.\n  install - additional script repositories can be added to your lua scripts. To add another repository fill in the URL to download additional scripts from and then fill in the new category to place scripts in. Click the install additional scripts button and the category (directory) is created and a git clone is performed to retrieve the git repository. EXAMPLE: fill in URL to download additional scripts from with https://github.com/wpferguson/extra-dt-lua-scripts.git and the new category to place scripts in with wpferguson. Click the button to install the scripts. The scripts are retrieved and added to the user interface and the window changes to the newly installed script category.\n  disable scripts - the lua scripts are installed by the darktable scripts installer. If you install them and later decide you no longer want them cluttering up your user interface, this option can disable them and stop them from starting. Once they are disabled, the way to enable them again is to rename a file using the terminal and command line. To disable the scritps first click the checkbox to enable the Disable Scripts button. This is to prevent accidentally disabling the lua scripts. Once the Disable Scripts button is active, click it to disable the scripts. When the button is clicked, the luarc file is renamed to luarc.disabled which results in the scripts not starting the next time darktable starts.\n    🔗Additional Software Required git - wwww.git.org - git is used to install and update the scripts. script_manager will still run if git is not installed or accessible, but installing and updating scripts will not be possible.\n🔗Limitations   There isn\u0026rsquo;t currently a way to stop an executing script and remove it from the interface, so when a script is stopped the script preference is set to not start the next time darktable starts.\n  If the scripts are disabled by choice the only way to enable them is by renaming the file luarc.disabled to luarc. Then file is located in the user\u0026rsquo;s darktable configuration directory, $HOME/.config/darktable on linux and macos and %LOCALAPPDATA%\\darktable on windows.\n  🔗Author Bill Ferguson \u0026lt;wpferguson@gmail.com\u0026gt;\n🔗Change Log 20201225 - Rewrite for darktable 3.4 - Merry Christmas\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/tools/script_manager/","tags":null,"title":"script_manager"},{"categories":null,"content":"🔗NAME tracepoint\n🔗SYNOPSIS print out a tracepoint and dump the arguments\n🔗USAGE local dd = require \u0026quot;lib/dtutils.debug\u0026quot; local result = dd.tracepoint(name, ...) name - string - the name of the tracepoint to print out\n\u0026hellip; - arguments - variables to dump the contents of\n🔗DESCRIPTION tracepoint prints its name and dumps its parameters using darktable.debug.\n🔗RETURN VALUE result - \u0026hellip; - the supplied argument list\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.debug/tracepoint/","tags":null,"title":"tracepoint"},{"categories":null,"content":"🔗Name cr2hdr.lua - Magic Lantern Dual ISO processing\n🔗Description cr2hdr Magic Lantern Dual ISO processing.\nThis script automates the steps involved to process an image created with the Magic Lantern Dual ISO module. Upon invoking the script with a shortcut \u0026ldquo;cr2hdr\u0026rdquo; provided by Magic Lantern is run on the selected images. The processed files are imported. They are also made group leaders to hide the original files.\n🔗Usage  start this script using script manager trigger conversion on selected/hovered images by shortcut (set shortcut in settings dialog) it is also possible to have the script run after importing a collection (optin, since it is not that fast)  🔗Additional Software Required  cr2hdr (sources can be obtained through the Magic Lantern repository)  🔗Limitations 🔗Author Till Theato - theato@ttill.de\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/cr2hdr/","tags":null,"title":"cr2hdr"},{"categories":null,"content":"table\nThis section must be activated separately by calling require darktable.debug\n🔗darktable.debug.dump function( object : anything, [name : string], [known : table] ) : string This will return a string describing everything Lua knows about an object, used to know what an object is. This function is recursion-safe and can be used to dump _G if needed.\n object - anything - The object to dump. [name] - string - A name to use for the object. [known] - table - A table of object,string pairs. Any object in that table will not be dumped, the string will be printed instead. defaults to darktable.debug.known if not set return - string - A string containing a text description of the object - can be very long.  🔗darktable.debug.debug boolean\nInitialized to false; set it to true to also dump information about metatables.\n🔗darktable.debug.max_depth number\nInitialized to 10; The maximum depth to recursively dump content.\n🔗darktable.debug.known table\nA table containing the default value of darktable.debug.dump.known\n🔗darktable.debug.type function( object : anything ) : string Similar to the system function type() but it will return the real type instead of userdata for darktable specific objects.\n object - anything - The object whose type must be reported. return - string - A string describing the type of the object.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.debug/","tags":null,"title":"darktable.debug"},{"categories":null,"content":"The colorpicker menu\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/colorpicker/","tags":null,"title":"darktable.gui.libs.colorpicker"},{"categories":null,"content":"The slideshow view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/slideshow/","tags":null,"title":"darktable.gui.views.slideshow"},{"categories":null,"content":"enum\nThe different ways in which a collection filter can be compared\nValues:\n DT_COLLECTION_RATING_COMP_LT DT_COLLECTION_RATING_COMP_LEQ DT_COLLECTION_RATING_COMP_EQ DT_COLLECTION_RATING_COMP_GEQ DT_COLLECTION_RATING_COMP_GT DT_COLLECTION_RATING_COMP_NE DT_COLLECTION_RATING_N_COMPS  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_rating_comperator_t/","tags":null,"title":"dt_collection_rating_comperator_t"},{"categories":null,"content":"🔗NAME executable_path_widget\n🔗SYNOPSIS create a widget to get executable path preferences\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local widget = df.executable_path_widget(executables) executables - table - a table of strings that are executable names\n🔗DESCRIPTION executable_path_widget takes a table of executable names and builds a set of file selector widgets to get the path to the executable. The resulting widgets are wrapped in a box widget and returned.\n🔗RETURN VALUE widget - widget - a widget containing a file selector widget for each executable.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/executable_path_widget/","tags":null,"title":"executable_path_widget"},{"categories":null,"content":"🔗Name generate_image_txt.lua - generate text metadata\n🔗Description A script to run a command on images to generate text metadata\nThe medata will be displayed as an overlay on the image in lighttable mode\n🔗Usage  start this script from script manager set a command to run on all image, this command should output text on stdout enable image file generation  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/generate_image_txt/","tags":null,"title":"generate_image_txt"},{"categories":null,"content":"🔗Name moduleExample.lua - create a new example lighttable module\n🔗Description More informations about building user interface elements: https://www.darktable.org/usermanual/ch09.html.php#lua_gui_example And about new_widget here: https://www.darktable.org/lua-api/index.html.php#darktable_new_widget\n🔗Usage   start this script from script manager\n  it creates a new example lighttable module\n  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/moduleexample/","tags":null,"title":"moduleExample"},{"categories":null,"content":"event\nThis event is triggered whenever the image under the mouse changes\n🔗mouse-over-image-changed.callback function( event : string, image : types.dt_lua_image_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The new image under the mouse, can be nil if there is no image under the mouse  🔗mouse-over-image-changed.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/mouse-over-image-changed/","tags":null,"title":"mouse-over-image-changed"},{"categories":null,"content":"🔗NAME spairs\n🔗SYNOPSIS an iterator that provides sorted pairs from a table\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; for key, value in du.spairs(t, order) do -- do something end t - table - table of key, value pairs order - function - an optional function to sort the pairs, if none is supplied, table.sort() is used\n🔗DESCRIPTION spairs is an iterator that returns key, value pairs from a table in sorted order. The sorting order is the result of table.sort() if no function is supplied, otherwise sorting is done as specified in the function.\n🔗EXAMPLE HighScore = { Robin = 8, Jon = 10, Max = 11 } -- basic usage, just sort by the keys for k,v in spairs(HighScore) do print(k,v) end --\u0026gt; Jon 10 --\u0026gt; Max 11 --\u0026gt; Robin 8 -- this uses an custom sorting function ordering by score descending for k,v in spairs(HighScore, function(t,a,b) return t[b] \u0026lt; t[a] end) do print(k,v) end --\u0026gt; Max 11 --\u0026gt; Jon 10 --\u0026gt; Robin 8 🔗REFERENCE Code copied from http://stackoverflow.com/questions/15706270/sort-a-table-in-lua\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/spairs/","tags":null,"title":"spairs"},{"categories":null,"content":"🔗NAME strip_accents\n🔗SYNOPSIS strip accents from characters\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.strip_accents(str) str - string - the string with characters that need accents removed\n🔗DESCRIPTION strip_accents removes accents from accented characters returning the unaccented character.\n🔗RETURN VALUE result - string - the string containing unaccented characters\n🔗REFERENCE Copied from https://forums.coronalabs.com/topic/43048-remove-special-characters-from-string/\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/strip_accents/","tags":null,"title":"strip_accents"},{"categories":null,"content":"A table containing all the film objects in the database.\n🔗darktable.films.# types.dt_lua_film_t\nEach film has a numeric entry in the database. See types.dt_lua_film_t.\n🔗darktable.films.new function( directory : string ) : types.dt_lua_film_t Creates a new empty film\nsee darktable.database.import to import a directory with all its images and to add images to a film\n directory - string - The directory that the new film will represent. The directory must exist return - types.dt_lua_film_t - The newly created film, or the existing film if the directory is already imported  🔗darktable.films.delete see types.dt_lua_film_t.delete\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.films/","tags":null,"title":"darktable.films"},{"categories":null,"content":"The UI element that manipulates history\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/copy_history/","tags":null,"title":"darktable.gui.libs.copy_history"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t ):int Gets the size in pixels of the specified panel. This only works for the left, right, and bottom panels.\n panel - types.dt_ui_panel_t - The panel to get the size of.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_get_size/","tags":null,"title":"darktable.gui.panel_get_size"},{"categories":null,"content":"The tethering view\nAttributes:\n has_tostring parent : types.dt_lua_view_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/views/tethering/","tags":null,"title":"darktable.gui.views.tethering"},{"categories":null,"content":"enum\nThe different orders that a collection can be sorted in\nValues:\n DT_COLLECTION_SORT_ORDER_ASCENDING DT_COLLECTION_SORT_ORDER_DESCENDING  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_sort_order_t/","tags":null,"title":"dt_collection_sort_order_t"},{"categories":null,"content":"🔗Name enfuseAdvanced.lua - process HDR or focus stacked images\n🔗Description This plugin will add the new export module \u0026lsquo;fusion to DRI or DFF image\u0026rsquo;.\nDRI = Dynamic Range Increase (Blend multiple bracket images into a single LDR file)\nDFF = Depth From Focus (\u0026lsquo;Focus Stacking\u0026rsquo; - Blend multiple images with different focus into a single image)\n🔗Usage Start this script using script manager.\nSelect multiple images that are either bracketed, or focus-shifted, set your desired operating parameters, and press the export button. A new image will be created. The image will be auto imported into darktable if you have that option enabled. Additional tags or style can be applied on auto import as well, if you desire.\n🔗image align options See align_image_stack documentation for further explanation of how it specifically works and the options provided (http://hugin.sourceforge.net/docs/manual/Align_image_stack.html)\n🔗image fustion options See enfuse documentation for further explanation of how it specifically works and the options provided (https://wiki.panotools.org/Enfuse) If you have a specific set of parameters you frequently like to use, you can save them to a preset. There are 3 presets available for DRI, and 3 for DFF.\n🔗target file Select your file destination path, or check the \u0026lsquo;save to source image location\u0026rsquo; option. \u0026lsquo;Create Unique Filename\u0026rsquo; is enabled by default at startup, the user can choose to overwrite existing Set any tags or style you desire to be added to the new image (only available if the auto-import option is enabled). You can also change the defaults for this under settings \u0026gt; lua options\n🔗format options Same as other export modules\n🔗global options Same as other export modules\n🔗Additional Software Required align_image_stack enfuse ver. 4.2 or greater exiftool\n🔗Limitations 🔗Author Kevin Ertel\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/enfuseadvanced/","tags":null,"title":"enfuseAdvanced"},{"categories":null,"content":"🔗NAME file_copy\n🔗SYNOPSIS copy a file to another name/location\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.file_copy(fromFile, toFile) fromFile - string - name of file to copy from\ntoFile - string - name of file to copy to\n🔗DESCRIPTION copy a file using a succession of methods from operating system to a pure lua solution\n🔗RETURN VALUE result - boolean - nil on error, true on success\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/file_copy/","tags":null,"title":"file_copy"},{"categories":null,"content":"🔗Name image_path_in_ui.lua - Add a widget with the path of the selected images\n🔗Description Add a widget with the path of the selected images for easy copy/past Simple shortcuts to have multiple selection bufers\nThis plugin will add a widget at the bottom of the left column in lighttable mode\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Jérémy Rosen\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/image_path_in_ui/","tags":null,"title":"image_path_in_ui"},{"categories":null,"content":"🔗Name multi_os.lua - an example script that runs on linux, MacOS, and Windows.\n🔗Description multi_os is an example of how to write a script that will run on different operating systems. It uses the lua-scripts libraries to lessen the amount of code that needs to be written, as well as gaining access to tested cross-platform routines. This script also performs a function that some may find useful. It creates a button in the lighttable selected images module that extracts the embedded jpeg image from a raw file, then imports it and groups it with the raw file. A keyboard shortcut is also created. A key combination can be assigned to the shortcut in the lua preferences and then the action can be invoked by hovering over the image and pressing the key combination.\n🔗Usage  start this script from script manager start darktable, open prefreences, go to lua options and update the executable location if you are running Windows or MacOS, then restart darktable. select an image or images click the button to extract the jpeg  🔗Additional Software Required  ufraw-batch - https://ufraw.sourceforge.net MacOS - install with homebrew  🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/multi_os/","tags":null,"title":"multi_os"},{"categories":null,"content":"event\nThis event is triggered when an film import is finished (all post-import-image callbacks have already been triggered). This event can be registered multiple times.\n🔗post-import-film.callback function( event : string, film : types.dt_lua_film_t )  event - string - The name of the event that triggered the callback. film - types.dt_lua_film_t - The new film that has been added. If multiple films were added recursively only the top level film is reported.  🔗post-import-film.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/post-import-film/","tags":null,"title":"post-import-film"},{"categories":null,"content":"🔗NAME split\n🔗SYNOPSIS split a string on a specified separator\n🔗USAGE local du = require \u0026quot;lib/dtutils\u0026quot; local result = du.split(str, pat) str - string - the string to split\npat - string - the pattern to split on\n🔗DESCRIPTION split separates a string into a table of strings. The strings are separated at each occurrence of the supplied pattern. The pattern may be any pattern as described in the lua docs. Each match of the pattern is consumed and not returned.\n🔗RETURN VALUE result - table - a table of strings on success, or an empty table on error\n🔗EXAMPLE split(\u0026quot;/a/long/path/name/to/a/file.txt\u0026quot;, \u0026quot;/\u0026quot;) would return a table like\n{\u0026quot;a\u0026quot;, \u0026quot;long\u0026quot;, \u0026quot;path\u0026quot;, \u0026quot;name\u0026quot;, \u0026quot;to\u0026quot;, \u0026quot;a\u0026quot;, \u0026quot;file.txt\u0026quot;} 🔗REFERENCE http://lua-users.org/wiki/SplitJoin\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils/split/","tags":null,"title":"split"},{"categories":null,"content":"🔗NAME urlencode\n🔗SYNOPSIS encode a string in a websage manner\n🔗USAGE local ds = require \u0026quot;lib/dtutils.string\u0026quot; local result = ds.urlencode(str) str - string - the string that needs to be made websafe\n🔗DESCRIPTION urlencode converts a string into a websafe version suitable for use in a web browser.\n🔗RETURN VALUE result - string - a websafe string\n🔗REFERENCE https://forums.coronalabs.com/topic/43048-remove-special-characters-from-string\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.string/urlencode/","tags":null,"title":"urlencode"},{"categories":null,"content":"table\nThis table contains functions related to translating lua scripts\n🔗darktable.gettext.gettext function( msgid : string ) : string Translate a string using the darktable textdomain\n msgid - string - The string to translate return - string - The translated string  🔗darktable.gettext.dgettext function( domainname : string, msgid : string ) : string Translate a string using the specified textdomain\n domainname - string - The domain to use for that translation msgid - string - The string to translate return - string - The translated string  🔗darktable.gettext.ngettext function( msgid : string, msgid_plural : string, n : int ) : string Translate a string depending on the number of objects using the darktable textdomain\n msgid - string - The string to translate msgid_plural - string - The string to translate in plural form n - int - The number of objects return - string - The translated string  🔗darktable.gettext.dngettext function( domainname : string, msgid : string, msgid_plural : string, n : int ) : string Translate a string depending on the number of objects using the specified textdomain\n domainname - string - The domain to use for that translation msgid - string - The string to translate msgid_plural - string - The string to translate in plural form n - int - The number of objects return - string - The translated string  🔗darktable.gettext.bindtextdomain function( domainname : string, dirname : string ) Tell gettext where to find the .mo file translating messages for a particular domain\n domainname - string - The domain to use for that translation dirname - string - The base directory to look for the file. The file should be placed in dirname/locale name/LC_MESSAGES/domain.mo  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.gettext/","tags":null,"title":"darktable.gettext"},{"categories":null,"content":"The darktable logo in the upper left corner\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/darktable_label/","tags":null,"title":"darktable.gui.libs.darktable_label"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t ) Hides the specified panel.\n panel - types.dt_ui_panel_t - The panel to hide.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_hide/","tags":null,"title":"darktable.gui.panel_hide"},{"categories":null,"content":"enum\nThe different elements on which a collection can be sorted\nValues:\n DT_COLLECTION_SORT_NONE DT_COLLECTION_SORT_FILENAME DT_COLLECTION_SORT_DATETIME DT_COLLECTION_SORT_IMPORT_TIMESTAMP DT_COLLECTION_SORT_CHANGE_TIMESTAMP DT_COLLECTION_SORT_EXPORT_TIMESTAMP DT_COLLECTION_SORT_PRINT_TIMESTAMP DT_COLLECTION_SORT_RATING DT_COLLECTION_SORT_ID DT_COLLECTION_SORT_COLOR DT_COLLECTION_SORT_GROUP DT_COLLECTION_SORT_PATH DT_COLLECTION_SORT_CUSTOM_ORDER DT_COLLECTION_SORT_TITLE DT_COLLECTION_SORT_DESCRIPTION DT_COLLECTION_SORT_ASPECT_RATIO DT_COLLECTION_SORT_SHUFFLE  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_collection_sort_t/","tags":null,"title":"dt_collection_sort_t"},{"categories":null,"content":"🔗Name 🔗Description Given a haldCLUT identity file this script generates haldCLUTS from all the user\u0026rsquo;s styles and exports them to a location of their choosing.\n🔗Usage Start this script from script manager.\n🔗Additional Software Required 🔗Limitations Warning: during export if a naming collision occurs the older file is automatically overwritten silently.\n🔗Author Noah Clarke\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/exportlut/","tags":null,"title":"exportLUT"},{"categories":null,"content":"🔗NAME file_move\n🔗SYNOPSIS move a file from one directory to another\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.file_move(fromFile, toFile) fromFile - string - name of the original file\ntoFile - string - the new file location and name\n🔗DESCRIPTION Move a file from one place to another. Try a succession of methods from builtin to operating system to a pure lua solution.\n🔗RETURN VALUE result - boolean - nil on error, some value on success\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/file_move/","tags":null,"title":"file_move"},{"categories":null,"content":"🔗Name import_filter_manager.lua - add a dropdown list with import filters to the import dialog\n🔗Description This script adds a dropdown list with import filters to the import dialog. Scripts can add new filters by registering them with darktable.register_import_filter(name, callback) The callback has type function(event, images), i.e., it is the same as when directly registering the pre-import event.\n🔗Usage  start this script from script manager also require some files with import filters, for example import_filters.lua. it is important to add them AFTER this one!  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/import_filter_manager/","tags":null,"title":"import_filter_manager"},{"categories":null,"content":"🔗Name panels_demo.lua - an example script demonstrating how to contol panel visibility\n🔗Description panels_demo is an example script showing how to control panel visibility. It cycles through the panels hiding them one by one, then showing them one by one, then hiding all, then showing all. Finally, the original panel visibility is restored.\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author 🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/panels_demo/","tags":null,"title":"panels_demo"},{"categories":null,"content":"event\nThis event is triggered whenever a new image is imported into the database. This event can be registered multiple times, all callbacks will be called. The call is blocking.\n🔗post-import-image.callback function( event : string, image : types.dt_lua_image_t )  event - string - The name of the event that triggered the callback. image - types.dt_lua_image_t - The image object that has been imported.  🔗post-import-image.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/post-import-image/","tags":null,"title":"post-import-image"},{"categories":null,"content":"The export menu\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/export/","tags":null,"title":"darktable.gui.libs.export"},{"categories":null,"content":"function( ) Hide all panels.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_hide_all/","tags":null,"title":"darktable.gui.panel_hide_all"},{"categories":null,"content":"enum\nThe type of compression to use for the EXR image\nValues:\n off rle zips zip piz pxr24 b44 b44a  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_exr_compression_t/","tags":null,"title":"dt_imageio_exr_compression_t"},{"categories":null,"content":"🔗Name ext_editor.lua - edit images with external editors\n🔗Description This script provides helpers to edit image files with programs external to darktable. It adds:\n a new target storage \u0026ldquo;collection\u0026rdquo;. Image exported will be reimported to collection for further editing with external programs a new lighttable module \u0026ldquo;external editors\u0026rdquo;, to select a program from a list of up to 9 external editors and run it on a selected image (adjust this limit by changing MAX_EDITORS) an option to display the module in darkroom view a set of lua preferences in order to configure name and path of up to 9 external editors a set of lua shortcuts in order to quick launch the external editors  🔗Usage  start this script with script manager  🔗setup  in \u0026ldquo;preferences/lua options\u0026rdquo; configure name and path/command of external programs note that if a program name is left empty, that and all following entries will be ignored in \u0026ldquo;preferences/shortcuts/lua\u0026rdquo; configure shortcuts for external programs (optional) whenever programs preferences are changed, in lighttable/external editors, press \u0026ldquo;update list\u0026rdquo;  🔗use   in the export dialog choose \u0026ldquo;collection\u0026rdquo; and select the format and bit depth for the exported image\n  press \u0026ldquo;export\u0026rdquo;\n  the exported image will be imported into collection and grouped with the original image\n  in lighttable, select an image for editing with en external program (or in darkroom for the image being edited):\n  in external editors GUI, select program and press \u0026ldquo;edit\u0026rdquo;\n  edit the image with the external editor, overwite the file, quit the external program\n  the selected image will be updated or\n  in lighttable/external editors, select program and press \u0026ldquo;edit a copy\u0026rdquo;\n  edit the image with the external editor, overwite the file, quit the external program\n  a copy of the selected image will be created and updated or\n  in lighttable select target storage \u0026ldquo;collection\u0026rdquo;\n  enter in darkroom\n  to create an export or a copy press CRTL+E\n  use the shortcut to edit the current image with the corresponding external editor\n  overwite the file, quit the external program\n  the darkroom view will be updated\n  warning: mouseover on lighttable/filmstrip will prevail on current image\n  this is the default DT behavior, not a bug of this script\n  🔗Additional Software Required 🔗Limitations  MAC compatibility not tested  🔗Author Marco Carrarini - marco.carrarini@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/ext_editor/","tags":null,"title":"ext_editor"},{"categories":null,"content":"🔗NAME filename_increment\n🔗SYNOPSIS add a two digit increment to a filename\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.filename_increment(filepath) filepath - string - filename to increment\n🔗DESCRIPTION filename_increment solves the problem of filename conflict by adding an increment to the filename. If the supplied filename has no increment then \u0026ldquo;01\u0026rdquo; is added to the basename. If the filename already has an increment, then 1 is added to it and the filename returned.\n🔗RETURN VALUE result - string - the incremented filename\n🔗LIMITATIONS The filename will be incremented to a maximum of 99.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/filename_increment/","tags":null,"title":"filename_increment"},{"categories":null,"content":"🔗Name import_filters.lua - add filters for import_filter_manager\n🔗Description This script goes along with the import filter manager. It adds two filters:\n ignore jpegs: this one does the same as the existing option in the import dialog and just skips all JPEGs during import. prefer raw over jpeg: this one is a bit more elaborate, it ignores JPEGs when there is also another file with the same basename, otherwise it allows JPEGs, too.  🔗Usage  start this script from script manager AFTER import_filter_manager.lua  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Ellinghaus \u0026amp; Christian Mandel\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/import_filters/","tags":null,"title":"import_filters"},{"categories":null,"content":"event\nThis event is trigger before any import action\n🔗pre-import.callback function( event : string, images : table of string )  event - string - The name of the event that triggered the callback. images - table of string - The files that will be imported. Modifying this table will change the list of files that will be imported.  🔗pre-import.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/pre-import/","tags":null,"title":"pre-import"},{"categories":null,"content":"🔗Name preferenceExample.lua - show the different preference types that are possible with Lua\n🔗Description darktable script to show the different preference types that are possible with Lua\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/preferenceexamples/","tags":null,"title":"preferenceExample"},{"categories":null,"content":"The filmstrip at the bottom of some views\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/filmstrip/","tags":null,"title":"darktable.gui.libs.filmstrip"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t size : int ) Sets the size in pixels of the specified panel. This only works for the left, right, and bottom panels.\n panel - types.dt_ui_panel_t - The panel to set the size of. size - int - The size to set the panel to.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_set_size/","tags":null,"title":"darktable.gui.panel_set_size"},{"categories":null,"content":"table\nGuide lines to overlay over an image in crop and rotate. All guides are clipped to the drawing area.\n🔗darktable.guides.register_guide function( name : string, draw_callback : function, [gui_callback : function] ) Register a new guide.\n name - string - The name of the guide to show in the GUI. draw_callback - function - The function to call to draw the guide lines. [gui_callback] - function - A function returning a widget to show when the guide is selected. It takes no arguments.  draw_callback -\nfunction( cr : types.dt_lua_cairo_t, x : float, y : float, width : float, height : float, zoom_scale : float ) The function to call to draw the guide lines. The drawn lines will be stroked by darktable. THIS IS RUNNING IN THE GUI THREAD AND HAS TO BE FAST!\n cr - types.dt_lua_cairo_t - The cairo object used for drawing. x - float - The x coordinate of the top left corner of the drawing area. y - float - The y coordinate of the top left corner of the drawing area. width - float - The width of the drawing area. height - float - The height of the drawing area. zoom_scale - float -The current zoom_scale. Only needed when setting the line thickness.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.guides/","tags":null,"title":"darktable.guides"},{"categories":null,"content":"enum\nJ2K format type\nValues:\n j2k jp2  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_j2k_format_t/","tags":null,"title":"dt_imageio_j2k_format_t"},{"categories":null,"content":"🔗Name face_recognition.lua - add a new storage option and calls face_recognition after export\n🔗Description Add a new storage option to send images to face_recognition. Images are exported to darktable tmp dir first. A directory with known faces must exist, the image name are the tag names which will be used. Multiple images for one face can exist, add a number to it, the number will be removed from the tag, for example: People|IknowYou1.jpg People|IknowYou2.jpg People|Another.jpg People|Youtoo.jpg\n🔗Usage  start this script from script manager.  🔗Additional Software Required  https://github.com/ageitgey/face_recognition https://github.com/darktable-org/lua-scripts/tree/master/lib  🔗Limitations 🔗Author Sebastian Witt\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/face_recognition/","tags":null,"title":"face_recognition"},{"categories":null,"content":"🔗NAME get_basename\n🔗SYNOPSIS get the filename without the path or extension\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_basename(filepath) filepath - string - path and filename\n🔗DESCRIPTION get_basename returns the name of the file without the path or filetype.\n🔗RETURN VALUE result - string - the basename of the file\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_basename/","tags":null,"title":"get_basename"},{"categories":null,"content":"🔗Name printExamples.lua - prints \u0026ldquo;hello world\u0026rdquo; when darktable starts\n🔗Description prints \u0026ldquo;hello world\u0026rdquo; to the screen when darktable starts\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/printexamples/","tags":null,"title":"printExamples"},{"categories":null,"content":"🔗Name save_selection.lua - simple shortcuts to have multiple selection buffers\n🔗Description Simple shortcuts to have multiple selection buffers\n🔗Usage  start this script from script manager go to configuration =\u0026gt; preferences =\u0026gt; lua set the shortcuts you want to use  This plugin will provide shortcuts to save to and restore from up to five temporary buffers\nThis plugin also provides a shortcut to swap the current selection with a quick-swap buffer\nThe variable \u0026ldquo;buffer_count\u0026rdquo; controls the number of selection buffers, increase it if you need more temporary selection buffers\n🔗Additional Software Required 🔗Limitations 🔗Author Jérémy Rosen\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/save_selection/","tags":null,"title":"save_selection"},{"categories":null,"content":"event\nThis event is triggered whenever the selection of images changes\n🔗selection-changed.callback function( event : string )  event - string - The name of the event that triggered the callback.  🔗selection-changed.extra registration parameters This event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/selection-changed/","tags":null,"title":"selection-changed"},{"categories":null,"content":"🔗Name fujifilm_dynamic_range.lua - adjust darktable exposure by Fujifilm raw exposure bias\n🔗Description Support for adjusting darktable exposure by Fujifilm raw exposure bias. This corrects for a DR100/DR200/DR400 \u0026ldquo;dynamic range\u0026rdquo; setting.\nBased upon fujifilm_ratings by Ben Mendis\nThe relevant tag is RawExposureBias (0x9650). This appears to represent the shift in EV for the chosen DR setting (whether manual or automatic). Note that even at 100DR (\u0026ldquo;standard\u0026rdquo;) there is an EV shift:\n100 DR -\u0026gt; -0.72 EV 200 DR -\u0026gt; -1.72 EV 400 DR -\u0026gt; -2.72 EV\nThe ideal would be to use exiv2 to read this tag, as this is the same code which darktable import uses. Unfortunately, exiv2 as of v0.27.3 can\u0026rsquo;t read this tag. As it is encoded as a 4-byte ratio of two signed shorts \u0026ndash; a novel data type \u0026ndash; it will require some attention to fix this.\nThere is an exiv2-readable DevelopmentDynamicRange tag which maps to RawExposureBias as above. DevelopmentDynamicRange is only present when tag DynamicRangeSetting (0x1402) is Manual/Raw (0x0001). When it is Auto (0x0000), the equivalent data is tag AutoDynamicRange (0x140b). But exiv2 currently can\u0026rsquo;t read that tag either.\nHence for now this code uses exiftool to read RawExposureBias, as a more general solution. As exiftool is approx. 10x slower than exiv2 (Perl vs. C++), this may slow large imports.\nThese tags have been checked on a Fujifilm X100S and X100V. Other cameras may behave in other ways.\n🔗Usage Start this script from script manager\n🔗Additional Software Required exiftool (https://www.sno.phy.queensu.ca/~phil/exiftool/)\n🔗Limitations 🔗Author Dan Torop dant@pnym.net\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/fujifilm_dynamic_range/","tags":null,"title":"fujifilm_dynamic_range"},{"categories":null,"content":"The image-filter menus at the top of the UI\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.filter.sort function( [sort : types.dt_collection_sort_t] ) : types.dt_collection_sort_t Change the collection sort field.\n [sort] - types.dt_collection_sort_t - The new field to sort by. If empty the current sort field is unchanged return - types.dt_collection_sort_t = The current sort field.  🔗darktable.gui.libs.filter.sort_order function( [order : types.dt_collection_sort_order_t] ) : types.dt_collection_sort_order_t Change the collection sort order.\n [order] - types.dt_collection_sort_order_t - The order to sort by. If empty the current sort order is unchanged. return - types.dt_collection_sort_order_t - The current sort order.  🔗darktable.gui.libs.filter.rating function( [rating : types.dt_collection_filter_t] ) : types.dt_collection_filter_t Change the collection rating filter.\n [rating] - types.dt_collection_filter_t - The new rating field to filter by. If empty the current rating field is unchanged. return - types.dt_collection_filter_t - The current rating field.  🔗darktable.gui.libs.filter.rating_comparator function( [comparator : types.dt_collection_rating_comperator_t] ) : types.dt_collection_rating_comperator_t Change the collection filter comparison field.\n [comparator] - types.dt_collection_rating_comperator_t - The new comparison field to filter the rating by. If empty the current rating comparison field is unchanged return - types.dt_collection_rating_comperator_t - The current rating comparison field  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/filter/","tags":null,"title":"darktable.gui.libs.filter"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t ) Shows the specified panel.\n panel - types.dt_ui_panel_t - The panel to show.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_show/","tags":null,"title":"darktable.gui.panel_show"},{"categories":null,"content":"function( type : string ) : types.dt_imageio_module_format_t Creates a new format object to export images\n  type - string - The type of format object to create, one of :\n copy exr j2k jpeg pdf pfm png ppm tiff webp    return - types.dt_imageio_module_format_t - The newly created object. Exact type depends on the type passed\n  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.new_format/","tags":null,"title":"darktable.new_format"},{"categories":null,"content":"enum\nJ2K preset type\nValues:\n off cinema2k_24 cinema2k_48 cinema4k_24  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_j2k_preset_t/","tags":null,"title":"dt_imageio_j2k_preset_t"},{"categories":null,"content":"🔗Name fujifilm_ratings.lua - support for importing Fujifilm in-camera ratings in darktable\n🔗Description Support for importing Fujifilm in-camera ratings in darktable.\n🔗Usage Start this script from script manager\n🔗Additional Software Required exiftool (https://www.sno.phy.queensu.ca/~phil/exiftool/)\n🔗Limitations 🔗Author Ben Mendis - ben.mendis@gmail.com\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/fujifilm_ratings/","tags":null,"title":"fujifilm_ratings"},{"categories":null,"content":"🔗NAME get_executable_path_preference\n🔗SYNOPSIS return the path to an executable from a preference\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_executable_path_preference(executable) executable - string - the name of the executable to get the path for\n🔗DESCRIPTION get_executable_path_preference returns the path preference to the requested executable.\n🔗RETURN VALUE result - string - path to the executable\n🔗LIMITATIONS executable should be the basename of the executable without extensions\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_executable_path_preference/","tags":null,"title":"get_executable_path_preference"},{"categories":null,"content":"🔗Name running_os.lua - prints the operating system\n🔗Description prints the operating system\n🔗Usage  start this script from script manager  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/examples/running_os/","tags":null,"title":"running_os"},{"categories":null,"content":"🔗Name selection_to_pdf.lua - generate a PDF file (via Latex) containing all selected images\n🔗Description Generates a PDF file (via Latex) containing all selected images\nThis plugin will add a new exporter that will allow you to generate the pdf file\nPlugin allows you to choose how many thumbnails you need per row\n🔗Usage  start this script from script manager  🔗Additional Software Required  a PDF-Viewer pdflatex (Latex)  🔗Limitations 🔗Author Jérémy Rosen \u0026amp; Pascal Obry\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/official/selection_to_pdf/","tags":null,"title":"selection_to_pdf"},{"categories":null,"content":"event\nThis event registers a new keyboard shortcut. The shortcut isn\u0026rsquo;t bound to any key until the users does so in the preference panel. The event is triggered whenever the shortcut is triggered. This event can only be registered once per value of shortcut.\n🔗shortcut.callback function( event : string, shortcut : string )  event - string - The name of the event that triggered the callback. shortcut - string - The tooltip string that was given at registration time.  🔗shortcut.extra registration parameters  tooltip - string - The string that will be displayed on the shortcut preference panel describing the shortcut.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/shortcut/","tags":null,"title":"shortcut"},{"categories":null,"content":"The geotagging time synchronisation UI\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/geotagging/","tags":null,"title":"darktable.gui.libs.geotagging"},{"categories":null,"content":"function( ) Show all panels.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_show_all/","tags":null,"title":"darktable.gui.panel_show_all"},{"categories":null,"content":"function( type : string ) : types.dt_imageio_module_storage_t Creates a new storage object to export images.\n  type - string - The type of storage object to create, one of:\n disk email gallery latex piwigo (Other, lua-defined, storage types may appear.)    return - [types.dt_imageio_module_storage_t(../../types/dt_imageio_module_storage_t)] - The newly created object. Exact type depends on the type passed\n  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.new_storage/","tags":null,"title":"darktable.new_storage"},{"categories":null,"content":"dt_type\nType object describing parameters to export to copy.\nAttributes:\n parent : types.dt_imageio_module_format_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_copy/","tags":null,"title":"dt_imageio_module_format_data_copy"},{"categories":null,"content":"🔗Name geoJSON_export.lua - export a geoJSON file from selected images\n🔗Description darktable geoJSON export script\n🔗Usage  start this script using script manager  🔗Additional Software Required  mkdir convert (ImageMagick) xdg-open xdg-user-dir  🔗Limitations This script is only tested with Linux\n🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/geojson_export/","tags":null,"title":"geoJSON_export"},{"categories":null,"content":"🔗NAME get_filename\n🔗SYNOPSIS get the filename and extension from a file path\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_filename(filepath) filepath - string - path and filename\n🔗DESCRIPTION get_filename strips the path from a filepath and returns the filename\n🔗RETURN VALUE result - string - the file name and type\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_filename/","tags":null,"title":"get_filename"},{"categories":null,"content":"event\nThis event is triggered after the user changed the active view\n#view-changed.callback\nfunction( event : string, old_view : types.dt_lua_view_t, new_view : types.dt_lua_view_t )  event - string - The name of the event that triggered the callback. old_view - types.dt_lua_view_t - The view that we just left new_view - types.dt_lua_view_t - The view we are now in  #view-changed.extra registration parameters\nThis event has no extra registration parameters.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/events/view-changed/","tags":null,"title":"view_changed"},{"categories":null,"content":"The common tools to all view (settings, grouping\u0026hellip;)\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.global_toolbox.grouping boolean- The current status of the image grouping option\nAttributes:\n write  🔗darktable.gui.libs.global_toolbox.show_overlays boolean - the current status of the image overlays option\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/global_toolbox/","tags":null,"title":"darktable.gui.libs.global_toolbox"},{"categories":null,"content":"function( panel : types.dt_ui_panel_t ) : boolean Determines if the specified panel is visible.\n panel - types.dt_ui_panel_t - The panel to check. return - boolean - true if the panel is visible, false if not  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/panel_visible/","tags":null,"title":"darktable.gui.panel_visible"},{"categories":null,"content":"function( type : string, ... : variable ) : types.lua_widget Creates a new widget object to display in the UI.\n  type - string - The type of storage object to create, one of:\n box button check_button combobox container entry file_chooser_button label section_label separator slider stack text_view    \u0026hellip; - variable - Extra parameters, exact value are documented with each type\n  return - types.lua_widget - The newly created object. Exact type depends on the type passed\n  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.new_widget/","tags":null,"title":"darktable.new_widget"},{"categories":null,"content":"dt_type\nType object describing parameters to export to exr.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_exr.compression string\nThe compression parameter to use when exporting.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_exr/","tags":null,"title":"dt_imageio_module_format_data_exr"},{"categories":null,"content":"🔗Name geoToolbox.lua - a module of geo tools\n🔗Description  it creates a new geoToolbox lighttable module  🔗Usage  require this script from your main lua file To do this add this line to the file .config/darktable/luarc: require \u0026ldquo;geoToolbox\u0026rdquo;  🔗Additional Software Required 🔗Limitations 🔗Author Tobias Jakobs\n🔗Change Log ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/geotoolbox/","tags":null,"title":"geoToolbox"},{"categories":null,"content":"🔗NAME get_filetype\n🔗SYNOPSIS get the filetype from a filename\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_filetype(filepath) filepath - string - path and filename\n🔗DESCRIPTION get_filetype returns the filetype from the supplied filepath\n🔗RETURN VALUE result - string - the filetype\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_filetype/","tags":null,"title":"get_filetype"},{"categories":null,"content":"The small line of text at the top of the UI showing the number of selected images\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/hinter/","tags":null,"title":"darktable.gui.libs.hinter"},{"categories":null,"content":"function( [selection : table of types.dt_lua_image_t] ) : table of types.dt_lua_image_t Get or change the set of selected images.\nAttributes: implicit_yield\n [selection] - table of types.dt_lua_image_t - A table of images which will define the selected images. If this parameter is not given the selection will be untouched. If an empty table is given the selection will be emptied. return - table of types.dt_lua_image_t - A table containing the selection as it was before the function was called.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/selection/","tags":null,"title":"darktable.gui.selection"},{"categories":null,"content":"Store and retrieve credentials using the darktable password storage backend.\n🔗darktable.password.save function( application : string, username : string, password : string ) :boolean Save a username/password pair for use accessing an application.\n application - string - Name of application or website. username - string - The username used to access the application or website. password - string - The credential used to authenticate the username. return - boolean - True if the credentials are saved, false if they are not.  🔗darktable.password.get function( application : string, username : string ) :string Retrieves the password associated with the username for the application.\n application - string - Name of application or website. username - string - The username used to access the application or website. return - string - The credentials used to authenticate the user. Nil is returned if there is an error or the crendentials don\u0026rsquo;t exist.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.password/","tags":null,"title":"darktable.password"},{"categories":null,"content":"dt_type\nType object describing parameters to export to jpeg2000.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_j2k.quality number\nThe quality to use at export time.\nAttributes:\n write  🔗dt_imageio_module_format_data_j2k.bpp number\nThe bpp parameter to use when exporting.\nAttributes:\n write  🔗dt_imageio_module_format_data_j2k.format types.dt_imageio_j2k_format_t\nThe format to use.\nAttributes:\n write  🔗dt_imageio_module_format_data_j2k.preset types.dt_imageio_j2k_preset_t\nThe preset to use.\nAttributes: 62\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_j2k/","tags":null,"title":"dt_imageio_module_format_data_j2k"},{"categories":null,"content":"🔗NAME get_path\n🔗SYNOPSIS get the path from a file path\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.get_path(filepath) filepath - string - path and filename\n🔗DESCRIPTION get_path strips the filename and filetype from a path and returns the path\n🔗RETURN VALUE result - string - the path\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/get_path/","tags":null,"title":"get_path"},{"categories":null,"content":"🔗Name gimp.lua - export and edit with GIMP\n🔗Description This script provides another storage (export target) for darktable. Selected images are exported in the specified format to temporary storage. GIMP is launched and opens the files. After editing, the exported images are overwritten to save the changes. When GIMP exits, the exported files are moved into the current collection and imported into the database. The imported files then show up grouped with the originally selected images.\n🔗Usage  start this script using script manager select an image or images for editing with GIMP in the export dialog select \u0026ldquo;Edit with GIMP\u0026rdquo; and select the format and bit depth for the exported image. Check the \u0026ldquo;run_detached\u0026rdquo; button to run GIMP in detached mode. Images will not be returned to darktable in this mode, but additional images can be sent to GIMP without stopping it. Press \u0026ldquo;export\u0026rdquo; Edit the image with GIMP then save the changes with File-\u0026gt;Overwrite\u0026hellip;. Exit GIMP The edited image will be imported and grouped with the original image  🔗Additional Software Required  GIMP - http://www.gimp.org  🔗Limitations  There is no provision for dealing with the xcf files generated by GIMP, since darktable doesn\u0026rsquo;t deal with them. You may want to save the xcf file if you intend on doing further edits to the image or need to save the layers used. Where you save them is up to you.  🔗Author Bill Ferguson - wpferguson@gmail.com\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/gimp/","tags":null,"title":"gimp"},{"categories":null,"content":"The histogram widget\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/histogram/","tags":null,"title":"darktable.gui.libs.histogram"},{"categories":null,"content":"table\nLua allows you to manipulate preferences. Lua has its own namespace for preferences and you can\u0026rsquo;t write normal darktable preferences. Preference handling functions take a script parameter. This is a string used to avoid name collision in preferences (i.e namespace). Set it to something unique, usually the name of the script handling the preference. Preference handling functions can\u0026rsquo;t guess the type of a parameter. You must pass the type of the preference you are handling. Note that the directory, enum, lua and file type preferences are stored internally as string. The user can only select valid values, but a lua script can set it to any string\n🔗darktable.preferences.register function( script : string, name : string, type : types.lua_pref_type, label : string, tooltip : string, [default : depends on type], [min : int or float], [max : int or float], [step : float], [values : string...], [widget : types.lua_widget], [set_callback : function] ) Creates a new preference entry in the Lua tab of the preference screen. If this function is not called the preference can\u0026rsquo;t be set by the user (you can still read and write invisible preferences).\n script - string - Invisible prefix to guarantee unicity of preferences. name - string - A unique name used with the script part to identify the preference. type - _types.lua_pref_type_The type of the preference - one of the string values described above. label - string - The label displayed in the preference screen. tooltip - string - The tooltip to display in the preference menu. [default] - Thedepends on type - Default value to use when not set explicitly or by the user. For the enum type of pref, this is mandatory [mi] - int or float - Minimum value (integer and float preferences only). [max] - int or float - Maximum value (integer and float preferences only). [step] - float - Step of the spinner (float preferences only). [values] - string - Other allowed values (enum preferences only) [widget] - types.lua_widget - The widget to use in preference (lua preferences only) [set_callback] - function_ - A function called when the widget needs to be updated from the preference  [set_callback] -\nfunction( widget : types.lua_widget ) A function called when the widget needs to be updated from the preference\n widget - types.lua_widget - The widget to update  🔗darktable.preferences.read function( script : string, name : string, type : types.lua_pref_type ) : depends on type Reads a value from a Lua preference.\n script - string - Invisible prefix to guarantee unicity of preferences. Specifying \u0026ldquo;darktable\u0026rdquo; as the script name allows access to the darktable core preferences. name - string - The name of the preference displayed in the preference screen. type - types.lua_pref_type - The type of the preference. return - depends on type - The value of the preference.  🔗darktable.preferences.write function( script : string, name : string, type : types.lua_pref_type, value : depends on type ) Writes a value to a Lua preference.\n script - string - Invisible prefix to guarantee unicity of preferences. name - string - The name of the preference displayed in the preference screen. type - types.lua_pref_type - The type of the preference. value - depends on type - The value to set the preference to.  🔗darktable.preferences.destroy function( script : string, name : string, ) : return boolean Destroys a lua preference key and value.\n script - string - Invisible prefix to guarantee unicity of preferences. name - string - The name of the preference displayed in the preference screen. return - boolean - True for success, false otherwise.  🔗darktable.preferences.get_keys function( script : string, name : string, ) : return table of strings Get all of the darktable core and lua preference keys and return them in a sorted table.\n return - table of string - Sorted darktable core preference and lua preference keys.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.preferences/","tags":null,"title":"darktable.preferences"},{"categories":null,"content":"dt_type\nType object describing parameters to export to jpeg.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_jpeg.quality number\nThe quality to use at export time.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_jpeg/","tags":null,"title":"dt_imageio_module_format_data_jpeg"},{"categories":null,"content":"🔗Name gpx_export.lua - gpx exporter\n🔗Description Simple darktable GPX generator script\nThis script generates a GPX track from all images having GPS latitude and longitude information. For each source folder, a separate \u0026lt;trk\u0026gt; is generated in the gpx file.\n🔗Usage 🔗Additional Software Required 🔗Limitations 🔗Author Jannis_V\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/gpx_export/","tags":null,"title":"gpx_export"},{"categories":null,"content":"🔗NAME mkdir\n🔗SYNOPSIS create the directory(ies) if they do not already exist\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; df.mkdir(path) path - string - a directory path\n🔗DESCRIPTION mkdir creates directories if they do not already exist. It creates parent directories if needed.\n🔗RETURN VALUE path - string - a directory path\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/mkdir/","tags":null,"title":"mkdir"},{"categories":null,"content":"The history manipulation menu\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/history/","tags":null,"title":"darktable.gui.libs.history"},{"categories":null,"content":"function( message : string ) Will print a string to the darktable control log (the long overlaid window that appears over the main panel).\n message - string - The string to display which should be a single line.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print/","tags":null,"title":"darktable.print"},{"categories":null,"content":"dt_type\nType object describing parameters to export to pdf.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_pdf.dpi number\nThe dot per inch value to use at export\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.icc boolean\nShould the images be tagged with their embedded profile\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.border string\nEmpty space around the PDF images\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.orientation string\nOrientation of the pages in the document\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.title string\nThe title for the document\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.rotate boolean\nShould the images be rotated to match the PDF orientation\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.mode string\nThe image mode to use at export time\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.size string\nThe paper size to use\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.compression string\nCompression mode to use for images\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.pages string\nThe page type to use\nAttributes:\n write  🔗dt_imageio_module_format_data_pdf.rotate boolean\nShould the images be rotated in the resulting PDF\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_pdf/","tags":null,"title":"dt_imageio_module_format_data_pdf"},{"categories":null,"content":"🔗Name HDRMerge.lua - create an HDR image using HDRMerge\n🔗Description This plugin adds the module \u0026lsquo;HDRMerge\u0026rsquo; to darktable\u0026rsquo;s lighttable view\n🔗Usage Start this script using script manager.\nOn the initial startup go to darktable settings \u0026gt; lua options and set your executable paths and other preferences, then restart darktable\nSelect bracketed images and press the Run HDRMerge button. The resulting DNG will be auto-imported into darktable. Additional tags or style can be applied on auto import as well, if you desire.\n🔗Base Options Select your desired BPS (bits per sample and Embedded Preview Size.\n🔗Batch Options Select if you want to run in batch mode or not Select the gap, in seconds, between images for auto grouping in batch mode\nSee HDRMerge manual for further detail: http://jcelaya.github.io/hdrmerge/documentation/2014/07/11/user-manual.html\n🔗Auto-import Options Select a style, whether you want tags to be copied from the original, and any additional tags you desire added when the new image is auto-imported\n🔗Additional Software Required HDRMerge ver. 4.5 or greater\n🔗Limitations 🔗Author Kevin Ertel\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/hdrmerge/","tags":null,"title":"HDRMerge"},{"categories":null,"content":"🔗NAME rmdir\n🔗SYNOPSIS recursively remove a directory\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; df.rmdir(path) path - string - a directory path\n🔗DESCRIPTION rmdir allows directories to be removed recursively.\n🔗RETURN VALUE path - string - a directory path\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/rmdir/","tags":null,"title":"rmdir"},{"categories":null,"content":"The UI element that manipulates the current images\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.image.register_action function( name : string, label : string, callback : function, [tooltip : string] ) Add a new button and call a callback when it is clicked\n name - string - A unique name for the action that can be referenced later to destroy it label - string - The label to display on the button callback - function - The function to call when the button is pressed [tooltip] - string - The tooltip to use on the new button  callback -\nfunction( event : string, images : table oftypes.dt_lua_image_t ) The function to call when the button is pressed\n event - string - The name of the button that was pressed images - table of types.dt_lua_image_t - The images to act on when the button was clicked  🔗darktable.gui.libs.image.destroy_action function( name : string ) Destroy an action created with register_action\n name - string - The name of the action to destroy  🔗darktable.gui.libs.image.action_set_sensitive function( name : string, sensitive : boolean ) Set the sensitivity of a button created by darktable.gui.libs.image.register_action\n name - string - The name of the action to destroy sensitive - boolean - True to set the button sensitive, false to set it insensitive  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/image/","tags":null,"title":"darktable.gui.libs.image"},{"categories":null,"content":"function( message : string ) This function is similar todarktable.print_log but adds an ERROR prefix for clarity.\n message - string - The string to display.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print_error/","tags":null,"title":"darktable.print_error"},{"categories":null,"content":"dt_type\nType object describing parameters to export to pfm.\nAttributes:\n parent : types.dt_imageio_module_format_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_pfm/","tags":null,"title":"dt_imageio_module_format_data_pfm"},{"categories":null,"content":"🔗Name hugin.lua - stitch multiple images into a panorama\n🔗Description Add a new storage option to send images to hugin. Images are exported to darktable tmp dir first.\n🔗Usage  start this script from script manager set the hugin tool paths (on some platforms) if hugin gui mode is used, save the final result in the tmp directory with the first file name and _pano as suffix for the image to be automatically imported to DT afterwards  🔗Additional Software Required  hugin  🔗Limitations 🔗Author Wolfgang Goetz\nChristian Kanzian\nTobias Jakobs\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/hugin/","tags":null,"title":"hugin"},{"categories":null,"content":"🔗NAME sanitize_filename\n🔗SYNOPSIS make a filename safe to pass as an argument\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local sanitized_filename = df.sanitize_filename(filename) filename - string - a filepath and filename\n🔗DESCRIPTION sanitize_filename places quotes around the filename in an operating system specific manner. The result is safe to pass as an argument to the operating system.\n🔗RETURN VALUE sanitized_filename - string - quoted filename\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/sanitize_filename/","tags":null,"title":"sanitize_filename"},{"categories":null,"content":"function( message : string ) Print a hint message to the darktable GUI.\n message - string - The string to display.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print_hinter/","tags":null,"title":"darktable.print_hinter"},{"categories":null,"content":"The buttons to start importing images\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.import.register_widget function( widget : types.lua_widget ) Add a widget in the option expander of the import dialog\n widget - types.lua_widget - The widget to add to the dialog. The reset callback of the widget will be called whenever the dialog is opened.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/import/","tags":null,"title":"darktable.gui.libs.import"},{"categories":null,"content":"function( message : string ) This function will print its parameter if the Lua logdomain is activated. Start darktable with the \u0026quot;-d lua\u0026quot; command line option to enable the Lua logdomain.\n message - string - The string to display.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print_log/","tags":null,"title":"darktable.print_log"},{"categories":null,"content":"dt_type\nType object describing parameters to export to png.\nAttributes:\n parent : types.dt_imageio_module_format_t../types/dt_imageio_module_format_t  🔗dt_imageio_module_format_data_png.bpp number\nThe bpp parameter to use when exporting.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_png/","tags":null,"title":"dt_imageio_module_format_data_png"},{"categories":null,"content":"🔗Name image_stack.lua - process a stack of images\n🔗Description This script provides another storage (export target) for darktable. Selected images are exported in the specified format to temporary storage. The images are aligned if the user requests it. When the images are ready, imagemagick is launched and uses the selected evaluate-sequence operator to process the images. The output file is written to a filename representing the input files in the format specified by the user. The resulting image is imported into the film roll. The source images can be tagged as part of the file creation so that a user can later find the contributing images.\n🔗Usage  start this script using script manager select the images to process with image_stack in the export dialog select \u0026ldquo;image stack\u0026rdquo; and select the format and bit depth for the exported image Select whether the images need to be aligned. Select the stack operator Select the output format Select whether to tag the source images used to create the resulting file Specify executable locations if necessary Press \u0026ldquo;export\u0026rdquo; The resulting image will be imported  🔗Additional Software Required  align_image_stack - http://www.hugin.org imagemagick - http://www.imagemagick.org  🔗Limitations Mean is a fairly quick operation. On my machine (i7-6800K, 16G) it takes a few seconds. Median, on the other hand takes approximately 10x longer to complete. Processing 10 and 12 image stacks took over a minute. I didn\u0026rsquo;t test all the other functions, but the ones I did fell between Mean and Median performance wise.\n🔗Author Bill Ferguson - wpferguson@gmail.com\n🔗See Also  Thanks to Pat David and his blog entry on blending images, https://patdavid.net/2013/05/noise-removal-in-photos-with-median_6.html  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/image_stack/","tags":null,"title":"image_stack"},{"categories":null,"content":"🔗NAME set_executable_path_preference\n🔗SYNOPSIS set a preference for the path to an executable\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; df.set_executable_path_preference(executable, path) executable - string - the name of the executable to set the path for\npath - string - the path to the binary\n🔗DESCRIPTION set_executable_path_preference takes an executable name and path to the executable and registers the preference for later use.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/set_executable_path_preference/","tags":null,"title":"set_executable_path_preference"},{"categories":null,"content":"function( message : string ) Print a toast message to the darktable GUI.\n message - string - The string to display.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.print_toast/","tags":null,"title":"darktable.print_toast"},{"categories":null,"content":"The navigation and zoom level UI in lighttable\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.lighttable_mode.layout function( [layout : types.dt_lighttable_layout_t] ) : types.dt_lighttable_layout_t Change the lighttable layout.\n [layout] - types.dt_lighttable_layout_t - The layout to switch to. If empty the current layout is unchanged return - types.dt_lighttable_layout_t - the current layout  🔗darktable.gui.libs.lighttable_mode.zoom_level function( [level : int] ) : int Change the lighttable zoom level.\n [level] - int - The zoom level to switch to. If empty the current zoom level is unchanged return - int - the current zoom level  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/lighttable_mode/","tags":null,"title":"darktable.gui.libs.lighttable_mode"},{"categories":null,"content":"function( event_name : string, event_type : string, callback : function, ... : variable ) This function registers a callback to be called when a given event happens. Events are documented in the event section.\n event_name - string - The name of the event used to manipulate the event. The combination of event_name and event_type must be unique. event_type - string - The name of the event to register to. callback - function - The function to call on event. The signature of the function depends on the type of event. \u0026hellip; - variable - Some events need extra parameters at registration time; these must be specified here.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.register_event/","tags":null,"title":"darktable.register_event"},{"categories":null,"content":"dt_type\nType object describing parameters to export to ppm.\nAttributes:\n parent : types.dt_imageio_module_format_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_ppm/","tags":null,"title":"dt_imageio_module_format_data_ppm"},{"categories":null,"content":"🔗Name image_time.lua - synchronize image time for images shot with different cameras\n🔗Description image_time non destructively adjusts image times by modifying the database image exif_datetime_taken field. There are 4 modes: adjust time, set time, synchronize time, and reset time.\n🔗ADJUST TIME adjust time mode lets you chose an offset in terms of years, months, days, hours, minutes, and seconds. The adjustment can be added or subtracted.\nWARNING: When adding and subtracting months the result will usually be what is expected unless the time being adjusted is at the end of the month. This is because a month is a variable amount of time that can be 28, 29, 30 or 31 days depending on the month. Example: It\u0026rsquo;s March 31st and I subtract a month which not sets the time to February 31st. When that gets set to a valid time, then the date changes to March 3rd.\n🔗SET TIME set time mode allows you to pick a date and time and set the image time accordingly. Fields may be left out. This is useful when importing scanned images that don\u0026rsquo;t have an embedded date.\n🔗SYNCHRONIZE TIME I recently purchased a 7DmkII to replace my aging 7D. My 7D was still serviceable, so I bought a remote control and figured I\u0026rsquo;d try shooting events from 2 different perspectives. I didn\u0026rsquo;t think to synchonize the time between the 2 cameras, so when I loaded the images and sorted by time it was a disaster. I hacked a script together with hard coded values to adjust the exif_datetime_taken value in the database for the 7D images so that everything sorted properly. I\u0026rsquo;ve tried shooting with 2 cameras several times since that first attempt. I\u0026rsquo;ve gotten better at getting the camera times close, but still haven\u0026rsquo;t managed to get them to sync. So I decided to think the problem through and write a proper script to take care of the problem.\n🔗RESET TIME Select the images and click reset.\n🔗Usage 🔗ADJUST TIME Change the year, month, day, hour, minute, second dropdowns to the amount of change desired. Select add or subtract. Select the images. Click adjust.\n🔗SET TIME Set the time fields to the desired time. Select the images to change. Click set.\n🔗SYNCHRONIZE TIME Select 2 images, one from each camera, of the same moment in time. Click the Calculate button to calculate the time difference. The difference is displayed in the difference entry. You can manually adjust it by changing the value if necessary.\nSelect the images that need their time adjusted. Determine which way to adjust adjust the time (add or subtract) and select the appropriate choice.\nIf the image times get messed up and you just want to start over, select reset time from the mode and reset the image times.\n🔗RESET TIME Select the images and click reset.\n🔗Additional Software Required  exiv2  🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/image_time/","tags":null,"title":"image_time"},{"categories":null,"content":"🔗NAME split_filepath\n🔗SYNOPSIS split a filepath into parts\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.split_filepath(filepath) filepath - string - path and filename\n🔗DESCRIPTION split_filepath splits a filepath into the path, filename, basename and filetype and puts that in a table\n🔗RETURN VALUE result - table - a table containing the path, filename, basename, and filetype\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/split_filepath/","tags":null,"title":"split_filepath"},{"categories":null,"content":"function( event_name : string, event_type : string, ) This function removes the callback registered by darktable.register_event. Events are documented in the event section.\n event_name - string - The name of the event used to manipulate the event. The combination of event_name and event_type must be unique. event_type - string - The name of the event to register to.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.destroy_event/","tags":null,"title":"darktable.destroy_event"},{"categories":null,"content":"The liveview window\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/live_view/","tags":null,"title":"darktable.gui.libs.live_view"},{"categories":null,"content":"function( plugin_name : string, name : string, expandable : boolean, resettable : boolean, containers : table of types.dt_lua_view_t =\u0026gt; [ types.dt_ui_container_t, int ], widget : types.lua_widget, view_enter : function, view_leave : function ) Register a new lib object. A lib is a graphical element of darktable\u0026rsquo;s user interface\n plugin_name - string - A unique name for your library name - string - A user-visible name for your library expandable - boolean - whether this lib should be expandable or not resettable - boolean - whether this lib has a reset button or not containers - table of types.dt_lua_view_t =\u0026gt; [ types.dt_ui_container_t, int ] - A table associating to each view containing the lib the corresponding container and position. widget - types.lua_widget - The widget to display in the lib view_enter - function - A callback called when a view displaying the lib is entered. view_leave - function - A callback called when leaving a view displaying the lib.  🔗view_enter self:function( old_view : types.dt_lua_view_t, new_view : types.dt_lua_view_t ) A callback called when a view displaying the lib is entered\n self - types.dt_lua_lib_t - The lib on which the callback is called old_view - types.dt_lua_lib_t - The view that we are leaving new_view - types.dt_lua_lib_t - The view that we are entering  🔗view_leave self:function( old_view : types.dt_lua_view_t, new_view : types.dt_lua_view_t ) A callback called when leaving a view displaying the lib\n self - types.dt_lua_lib_t - The lib on which the callback is called old_view - types.dt_lua_lib_t - The view that we are leaving new_view - types.dt_lua_lib_t - The view that we are entering  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.register_lib/","tags":null,"title":"darktable.register_lib"},{"categories":null,"content":"dt_type\nType object describing parameters to export to tiff.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_tiff.bpp number\nThe bpp parameter to use when exporting.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_tiff/","tags":null,"title":"dt_imageio_module_format_data_tiff"},{"categories":null,"content":"🔗Name kml_export.lua - export a kml file from selected images\n🔗Description darktable KML export script\n🔗Usage  start this script from script manager when choosing file format, pick JPEG or PNG as Google Earth doesn\u0026rsquo;t support other formats  🔗Additional Software Required  zip (at the moment Linux only and only if you create KMZ files) magick (ImageMagick) xdg-user-dir (Linux)  🔗Limitations This script is only tested with Linux\n🔗Author Tobias Jakobs\nErik Augustin\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/kml_export/","tags":null,"title":"kml_export"},{"categories":null,"content":"🔗NAME test_file\n🔗SYNOPSIS test a file to see what it is\n🔗USAGE local df = require \u0026quot;lib/dtutils.file\u0026quot; local result = df.test_file(path, test) path - string - path and filename test - char - one of d, e, f, x where\n d - directory e - exists f - file x - executable  🔗DESCRIPTION test_file checks a specified path to see if it meets the specified test\n🔗RETURN VALUE result - boolean - true if the path satisfies the test, false if not\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.api.manual/dtutils.file/test_file/","tags":null,"title":"test_file"},{"categories":null,"content":"The location ui\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/location/","tags":null,"title":"darktable.gui.libs.location"},{"categories":null,"content":"function( plugin_name : string, name : string, [store : function], [finalize : function], [supported : function], [initialize : function], [widget : types.lua_widget] ) This function will add a new storage implemented in Lua. A storage is a module that is responsible for handling images once they have been generated during export. Examples of core storages include filesystem, e-mail, pwigo\u0026hellip;\n plugin_name - string - A unique name for the plugin. name - string - A human readable name for the plugin. [store] - function - This function is called once for each exported image. [finalize] - function - This function is called once all images are processed and all store calls are finished. [supported] - function - A function called to check if a given image format is supported by the Lua storage. [initialize] - function - A function called before storage happens. widget - types.lua_widget - A widget to display in the export section of darktable\u0026rsquo;s UI.  🔗[store] function( storage : types.dt_imageio_module_storage_t, image : types.dt_lua_image_t, format : types.dt_imageio_module_format_t, filename : string, number : integer, total : integer, high_quality : boolean, extra_data : table ) This function is called once for each exported image. Images can be exported in parallel but the calls to this function will be serialized.\n storage - types.dt_imageio_module_storage_t - The storage object used for the export. image - types.dt_lua_image_t - The exported image object. format - types.dt_imageio_module_format_t - The format object used for the export. filename - string - The name of a temporary file where the processed image is stored. number - integer - The number of the image out of the export series. total - integer - The total number of images in the export series. high_quality - boolean - True if the export is high quality. extra_data - table- An empty Lua table to take extra data. This table is common to the initialize, store and finalize calls in an export series.  🔗[finalize] function( storage : types.dt_imageio_module_storage_t, image_table : table, extra_data : table ) This function is called once all images are processed and all store calls are finished.\n storage - types.dt_imageio_module_storage_t - The storage object used for the export. image_table - table - A table keyed by the exported image objects and valued with the corresponding temporary export filename. extra_data - table - An empty Lua table to store extra data. This table is common to all calls to store and the call to finalize in a given export series.  🔗[supported] function( storage : types.dt_imageio_module_storage_t, format : types.dt_imageio_module_format_t ) : boolean A function called to check if a given image format is supported by the Lua storage; this is used to build the dropdown format list for the GUI.\nNote that the parameters in the format are the ones currently set in the GUI; the user might change them before export.\n storage - types.dt_imageio_module_storage_t - The storage object tested. format - types.dt_imageio_module_format_t - The format object to report about. return - boolean - True if the corresponding format is supported.  🔗[initialize] function( storage : types.dt_imageio_module_storage_t, format : types.dt_imageio_module_format_t, images : table of types.dt_lua_image_t, high_quality : boolean, extra_data : table ) : table or nil A function called before storage happens This function can change the list of exported functions\n storage - types.dt_imageio_module_storage_t - The storage object tested. format - types.dt_imageio_module_format_t - The format object to report about. images - table of types.dt_lua_image_t - A table containing images to be exported. high_quality - boolean - True if the export is high quality. extra_data - table - An empty Lua table to take extra data. This table is common to the initialize, store and finalize calls in an export series. return - table or nil - The modified table of images to export or nil If nil (or nothing) is returned, the original list of images will be exported If a table of images is returned, that table will be used instead. The table can be empty. The images parameter can be modified and returned  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.register_storage/","tags":null,"title":"darktable.register_storage"},{"categories":null,"content":"dt_type\nType object describing parameters to export to webp.\nAttributes:\n parent : types.dt_imageio_module_format_t  🔗dt_imageio_module_format_data_webp.quality number\nThe quality to use at export time.\nAttributes:\n write  🔗dt_imageio_module_format_data_webp.comp_type types.comp_type_t\nThe overall quality to use; can be one of \u0026ldquo;webp_lossy\u0026rdquo; or \u0026ldquo;webp_lossless\u0026rdquo;.\nAttributes:\n write  🔗dt_imageio_module_format_data_webp.hint types.hint_t\nA hint on the overall content of the image.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_data_webp/","tags":null,"title":"dt_imageio_module_format_data_webp"},{"categories":null,"content":"🔗Name LabelsToTags.lua - mass apply tags to images\n🔗Description Allows the mass-application of tags using color labels and ratings as a guide.\n🔗Usage In your \u0026lsquo;luarc\u0026rsquo; file or elsewhere, use the function \u0026lsquo;register_tag_mapping\u0026rsquo;, defined in this module, to specify one or more tag mappings for use by the module. Any mappings so registered will be selectable, according to their given names, in the module\u0026rsquo;s \u0026ldquo;mapping\u0026rdquo; combo box.\nA mapping takes the form of a table mapping patterns to lists of tags. A pattern consists of 6 characters, of which the first five represent color labels and the last the rating. Each color label character may be \u0026lsquo;+\u0026rsquo;, \u0026lsquo;-\u0026rsquo;, or \u0026lsquo;\u0026rsquo;, indicating that for this pattern to match, the corresponding color label, respectively, must be on, must be off, or can be either. Similarly, the rating character may be a numeral between 0 and 5, \u0026ldquo;R\u0026rdquo; for rejected, or \u0026ldquo;\u0026rdquo; for \u0026ldquo;any value.\u0026rdquo;\nAn example call to \u0026lsquo;register_tag_mapping\u0026rsquo; is provided in a comment at the end of this file.\nWhen the \u0026ldquo;Start\u0026rdquo; button is pressed, the module will iterate over each selected image and check the state of that image\u0026rsquo;s color labels and rating against each pattern defined in the selected mapping. For each pattern that matches, the corresponding tags will be added to the image. Any such tag not already existing in the database will be created.\n🔗Additional Software Required 🔗Limitations 🔗Author August Schwerdfeger - august@schwerdfeger.name\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/labelstotags/","tags":null,"title":"LabelsToTags"},{"categories":null,"content":"function( plugin_name : string ) This function will destroy a storage created by darktable.register_storage.\n plugin_name - string - The name of the plugin to destroy.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.destroy_storage/","tags":null,"title":"darktable.destroy_storage"},{"categories":null,"content":"The map setting window\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/map_settings/","tags":null,"title":"darktable.gui.libs.map_settings"},{"categories":null,"content":"This pseudo table allows you to access and manipulate styles.\n🔗darktable.styles.# types.dt_style_t\nEach existing style has a numeric index; you can iterate them using ipairs.\n🔗darktable.styles.create function( image : types.dt_lua_image_t, name : string, description : string ) : types.dt_style_t Create a new style based on an image.\n image - types.dt_lua_image_t - The image to create the style from. name - string - The name to give to the new style. description - string - The description of the new style. return - types.dt_style_t - The new style object.  🔗darktable.styles.delete function( style : types.dt_style_t ) Deletes an existing style.\n style - types.dt_style_t - the style to delete  🔗darktable.styles.duplicate function( style : types.dt_style_t, name : string, description : string ) : types.dt_style_t Create a new style based on an existing style.\n style - types.dt_style_t - The style to base the new style on. name - string - The new style\u0026rsquo;s name. description - string - The new style\u0026rsquo;s description. return - types.dt_style_t - The new style object.  🔗darktable.styles.apply function( style : types.dt_style_t, image : types.dt_lua_image_t ) Apply a style to an image. The order of parameters can be inverted.\n style - types.dt_style_t - The style to use. image - types.dt_lua_image_t - The image to apply the style to.  🔗darktable.styles.import function( filename : string ) Import a style from an external .dtstyle file\n filename - string - The file to import  🔗darktable.styles.export function( style : types.dt_style_t, directory : string, overwrite : boolean ) Export a style to an external .dtstyle file\n style - types.dt_style_t - The style to export directory - string - The directory to export to overwrite - boolean - Is overwriting an existing file allowed  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.styles/","tags":null,"title":"darktable.styles"},{"categories":null,"content":"dt_type\nA virtual type representing all format types.\n🔗dt_imageio_module_format_t.plugin_name string\nA unique name for the plugin.\n🔗dt_imageio_module_format_t.name string\nA human readable name for the plugin.\n🔗dt_imageio_module_format_t.extension string\nThe typical filename extension for that format.\n🔗dt_imageio_module_format_t.mime string\nThe mime type associated with the format.\n🔗dt_imageio_module_format_t.max_width number\nThe max width allowed for the format (0 = unlimited).\nAttributes:\n write  🔗dt_imageio_module_format_t.max_height number\nThe max height allowed for the format (0 = unlimited).\nAttributes:\n write  🔗dt_imageio_module_format_t.write_image self:function( image : types.dt_lua_image_t, filename : string, [allow_upscale : boolean] ) : boolean Exports an image to a file. This is a blocking operation that will not return until the image is exported.\n self - types.dt_imageio_module_format_t - The format that will be used to export. image - types.dt_lua_image_t - The image object to export. filename - string - The filename to export to. [allow_upscale] - boolean - Set to true to allow upscaling of the image. return - boolean - Returns true on success.  Attributes:\n implicit_yield  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_format_t/","tags":null,"title":"dt_imageio_module_format_t"},{"categories":null,"content":"🔗Name OpenInExplorer.lua - open an images containing folder\n🔗Description This plugin adds the module \u0026ldquo;OpenInExplorer\u0026rdquo; to darktable\u0026rsquo;s lighttable view.\n🔗Usage Require this file in your luarc file, as with any other dt plug-in\nSelect the photo(s) you wish to find in your operating system\u0026rsquo;s file manager and press \u0026ldquo;show in file explorer\u0026rdquo; in the \u0026ldquo;selected images\u0026rdquo; section.\n  Nautilus (Linux), Explorer (Windows), and Finder (macOS prior to Mojave) will open one window for each selected image at the file\u0026rsquo;s location. The file name will be highlighted.\n  On macOS Mojave and Catalina the Finder will open one window for each different directory. In these windows only the last one of the corresponding files will be highlighted (bug or feature?).\n  Dolphin (Linux) will open one window with tabs for the different directories. All the selected images' file names are highlighted in their respective directories.\n  As an alternative option you can choose to show the image file names as symbolic links in an arbitrary directory. Go to preferences|Lua options. This option is not available for Windows users as on Windows only admins are allowed to create links.\n  Pros: You do not clutter up your display with multiple windows. So there is no need to limit the number of selections.\n  Cons: If you want to work with the files you are one step behind the original data.\n  🔗Additional Software Required 🔗Limitations 🔗Author Kevin Ertel\nVolker Lenhardt\nBill Ferguson\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/openinexplorer/","tags":null,"title":"OpenInExplorer"},{"categories":null,"content":"The masks window\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/masks/","tags":null,"title":"darktable.gui.libs.masks"},{"categories":null,"content":"Allows access to all existing tags.\n🔗darktable.tags.# types.dt_lua_tag_t\nEach existing tag has a numeric entry in the tags table - use ipairs to iterate over them.\n🔗darktable.tags.create function( name : string ) Creates a new tag and return it. If the tag exists return the existing tag.\n name - string - The name of the new tag.  🔗darktable.tags.find function( name : string ) : types.dt_lua_tag_t Returns the tag object or nil if the tag doesn\u0026rsquo;t exist.\n name - string - The name of the tag to find. return - _ types.dt_lua_tag_t_ - The tag object or nil.  🔗darktable.tags.delete function( tag : types.dt_lua_tag_t ) Deletes the tag object, detaching it from all images.\n tag - types.dt_lua_tag_t - The tag to be deleted.  🔗darktable.tags.attach function( tag : types.dt_lua_tag_t, image : types.dt_lua_image_t ) Attach a tag to an image; the order of the parameters can be reversed.\n tag - types.dt_lua_tag_t - The tag to be attached. image - types.dt_lua_image_t - The image to attach the tag to.  🔗darktable.tags.detach function( tag : types.dt_lua_tag_t, image : types.dt_lua_image_t ) Detach a tag from an image; the order of the parameters can be reversed.\n tag - types.dt_lua_tag_t - The tag to be detached. image - types.dt_lua_image_t - The image to detach the tag from.  🔗darktable.tags.get_tags function( image : types.dt_lua_image_t ) : table of types.dt_lua_tag_t Gets all tags attached to an image.\n image - types.dt_lua_image_t - The image to get the tags from. return - table of types.dt_lua_tag_t - A table of tags that are attached to the image.  🔗darktable.tags.get_tagged_images function( tag : types.dt_lua_tag_t ) : table of types.dt_lua_image_t Gets all images with the attached tag.\n tag - types.dt_lua_tag_t - The tag to search images for. return - table of types.dt_lua_image_t - A table of images that have the tag attached.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/darktable.tags/","tags":null,"title":"darktable.tags"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to disk.\nAttributes:\n parent : types.dt_imageio_module_storage_t  🔗dt_imageio_module_storage_data_disk.filename string\nThe filename to export to.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_disk/","tags":null,"title":"dt_imageio_module_storage_data_disk"},{"categories":null,"content":"🔗Name 🔗Description guides for cropping passport photos based on documents from the Finnish police (https://www.poliisi.fi/instancedata/prime_product_julkaisu/intermin/embeds/poliisiwwwstructure/38462_Passikuvaohje_EN.pdf) describing passport photo dimensions of 47x36 mm and 500x653 px for digital biometric data stored in passports. They use ISO 19794-5 standard based on ICAO 9303 regulations which should also be compliant for all of Europe.\n🔗Usage  add the following line in the file $CONFIGDIR/luarc require \u0026ldquo;passport_guide\u0026rdquo; (optional) add the line: \u0026ldquo;plugins/darkroom/clipping/extra_aspect_ratios/passport 36x47mm=47:36\u0026rdquo; to $CONFIGDIR/darktablerc when using the cropping tool, select \u0026ldquo;passport\u0026rdquo; as guide and if you added the line in your luarc select \u0026ldquo;passport 36x47mm\u0026rdquo; as aspect  🔗Additional Software Required 🔗Limitations 🔗Author Kåre Hampf\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/passport_guide/","tags":null,"title":"passport_guide"},{"categories":null,"content":"The widget allowing modification of metadata fields on the current image\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/metadata/","tags":null,"title":"darktable.gui.libs.metadata"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to email.\nAttributes:\n parent : types.dt_imageio_module_storage_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_email/","tags":null,"title":"dt_imageio_module_storage_data_email"},{"categories":null,"content":"🔗Name pdf_slideshow.lua - generate a pdf slideshow\n🔗Description Generates a PDF slideshow (via Latex) containing all selected images one per slide.\n🔗Usage  start this script from script manager  This plugin will add a new exporter that will allow you to generate a pdf slideshow. The interface will let you add:\n a global title for the slideshow (prefix in all slide label) a delay for the transition between each slide  Each slide will contain a single picture with a label at the bottom with the format (all fields can be the empty string):\n\u0026lt;global title\u0026gt; / \u0026lt;image creator\u0026gt; / \u0026lt;image title\u0026gt;\n🔗Additional Software Required  a PDF-Viewer pdflatex (Latex)  🔗Limitations 🔗Author Pascal Obry\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/pdf_slideshow/","tags":null,"title":"pdf_slideshow"},{"categories":null,"content":"The widget displaying metadata about the current image\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.metadata_view.register_info function( name : string, callback : function ) Register a field in the image information module with a callback function to update the field\n name - string - The name displayed for the new information callback - function - The function providing the info  callback -\nfunction( image : types.dt_lua_image_t ) : string  image - types.dt_lua_image_t - The image to analyze return - string - The extra information to display  🔗darktable.gui.libs.metadata_view.destroy_info function( name : string ) Remove the named field from the image information module and it\u0026rsquo;s associated callback\n name - string - The name of the field, created by darktable.gui.libs.metadata_view.register_info, to remove  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/metadata_view/","tags":null,"title":"darktable.gui.libs.metadata_view"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to gallery.\nAttributes:\n parent : types.dt_imageio_module_storage_t  🔗dt_imageio_module_storage_data_gallery.filename string\nThe filename to export to.\nAttributes:\n write  🔗dt_imageio_module_storage_data_gallery.title string\nThe title to use for export.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_gallery/","tags":null,"title":"dt_imageio_module_storage_data_gallery"},{"categories":null,"content":"🔗Name photils.lua - auto tag images based on feature recognition\n🔗Description A darktable plugin that tries to predict keywords based on the selected image. This plugin uses photils-cli to handle this task. Photils-cli is an application that passes the image through a neural network, classifies it, and extracts the suggested tags. Everything happens offline without the need that your data are sent over the internet.\n🔗Usage  start this script from script manager Select an image Press \u0026ldquo;get tags\u0026rdquo; Select the tags you want from a list of suggestions Press \u0026ldquo;Attach .. Tags\u0026rdquo; to add the selected tags to your image  🔗Additional Software Required  photils-cli - https://github.com/scheckmedia/photils-cli at the moment only available for Linux and MacOS  🔗Limitations 🔗Website photils\n🔗Author Tobias Scheck\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/photils/","tags":null,"title":"photils"},{"categories":null,"content":"The icons describing the different iop groups\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/modulegroups/","tags":null,"title":"darktable.gui.libs.modulegroups"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to latex.\nAttributes:\n parent : types.dt_imageio_module_storage_t  🔗dt_imageio_module_storage_data_latex.filename string\nThe filename to export to.\nAttributes:\n write  🔗dt_imageio_module_storage_data_latex.title string\nThe title to use for export.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_latex/","tags":null,"title":"dt_imageio_module_storage_data_latex"},{"categories":null,"content":"🔗Name quicktag.lua - add shortcuts to speed up tagging\n🔗Description For faster attaching your favorite tags, the script adds shortcuts and the module \u0026ldquo;quicktag\u0026rdquo; in lighttable mode with a changeable number of buttons. A tag can be assigned to each button. If the tags do not exist in your database, they are added to the database the first time they are attached to an image.\nThe number of buttons/shortcuts can be changed in the lua preferences. Changes in the number require a restart of darktable.\n🔗Usage  set the number of quicktags between 2 and 10 in the preferences dialog and restart darktable if wanted set the shortcuts in the preferences dialog to add or change a quicktag, first select the old tag with the combobox \u0026ldquo;old quicktag\u0026rdquo;, enter a new tag in the \u0026ldquo;new quicktag\u0026rdquo; filed and press \u0026ldquo;set quicktag\u0026rdquo; use a shortcut or button to attach the tag to selected images  🔗Additional Software Required 🔗Limitations 🔗Author Christian Kanzian\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/quicktag/","tags":null,"title":"quicktag"},{"categories":null,"content":"The tools on the bottom line of the UI (overexposure)\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/module_toolbox/","tags":null,"title":"darktable.gui.libs.module_toolbox"},{"categories":null,"content":"dt_type\nAn object containing parameters to export to piwigo.\nAttributes:\n parent : types.dt_imageio_module_storage_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_piwigo/","tags":null,"title":"dt_imageio_module_storage_data_piwigo"},{"categories":null,"content":"🔗Name rate_group.lua - rate groups of images\n🔗Description Provide shortcuts for rating or rejecting all images within a group; particularly useful for RAW+JPEG shooters employing a star rating workflow like the below:\nhttp://blog.chasejarvis.com/blog/2011/03/photo-editing-101/\n🔗Usage Assign a keyboard shortcut to each action via settings \u0026gt; shortcuts \u0026gt; lua\nI use the following shortcuts:\n Reject group: Ctrl+R Rate group 1: Ctrl+1 Rate group 2: Ctrl+2 Rate group 3: Ctrl+3 Rate group 4: Ctrl+4 Rate group 5: Ctrl+5 Rate group 0: Ctrl+0  🔗Additional Software Required 🔗Limitations 🔗Author Dom H - dom@hxy.io\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/rate_group/","tags":null,"title":"rate_group"},{"categories":null,"content":"🔗Name rename_images.lua - rename one or more image files\n🔗Description Rename an image or images according to a pattern built by the user. It is possible to specify a different directory in the rename pattern, which will result in a move as well as a rename. The database will be updated to reflect the new name/location of the image.\n🔗Usage  require this script from your luarc file or start it from script_manager select an image or images enter a renaming pattern click the button to rename the files  🔗Additional Software Required 🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.com\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/rename_images/","tags":null,"title":"rename_images"},{"categories":null,"content":"The full image preview to allow navigation\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/navigation/","tags":null,"title":"darktable.gui.libs.navigation"},{"categories":null,"content":"dt_type\nA virtual type representing all storage types.\n🔗dt_imageio_module_storage_t.plugin_name string\nA unique name for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.name string\nA human readable name for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.width number\nThe currently selected width for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.height number\nThe currently selected height for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.recommended_width number The recommended width for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.recommended_height number\nThe recommended height for the plugin.\nAttributes:\n write  🔗dt_imageio_module_storage_t.supports_format format : types.dt_imageio_module_format_t ) : boolean Checks if a format is supported by this storage.\n self - types.dt_imageio_module_storage_t - The storage type to check against. format - types.dt_imageio_module_format_t - The format type to check. return - boolean - True if the format is supported by the storage.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_imageio_module_storage_t/","tags":null,"title":"dt_imageio_module_storage_t"},{"categories":null,"content":"🔗Name rename-tags.lua - rename tags\n🔗Description 🔗Usage  In lighttable there is a new entry: \u0026lsquo;rename tag\u0026rsquo; Enter old tag (this one gets deleted!) Enter new tag name  🔗Additional Software Required 🔗Limitations 🔗Author Sebastian Witt - se.witt@gmx.net\nBill Ferguson - wpferguson@gmail.com\n🔗Deprecation This functionality now exists in core darktable so this script will be removed when darktable 4.0 is released.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/","tags":null,"title":"rename_tags"},{"categories":null,"content":"The settings window in the print view\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/print_settings/","tags":null,"title":"darktable.gui.libs.print_settings"},{"categories":null,"content":"enum\nThe logical operators to apply between rulesAttributes:\nValues:\n DT_LIB_COLLECT_MODE_AND DT_LIB_COLLECT_MODE_OR DT_LIB_COLLECT_MODE_AND_NOT  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lib_collect_mode_t/","tags":null,"title":"dt_lib_collect_mode_t"},{"categories":null,"content":"🔗Name RL_out_sharp.lua - Richardson-Lucy output sharpening using GMic\n🔗Description This script provides a new target storage \u0026ldquo;RL output sharpen\u0026rdquo;. Images exported will be sharpened using GMic (RL deblur algorithm)\n🔗EXAMPLE set sigma = 0.7, iterations = 10, jpeg output quality = 95, to correct blur due to image resize for web usage\n🔗Usage  start this script from script manager in lua preferences, select the GMic cli executable from \u0026ldquo;export selected\u0026rdquo;, choose \u0026ldquo;RL output sharpen\u0026rdquo; configure output folder configure RL parameters with sliders configure temp files format and quality, jpg 8bpp (good quality) and tif 16bpp (best quality) are supported configure other export options (size, etc.) export, images will be first exported in the temp format, then sharpened sharpened images will be stored in jpg format in the output folder  🔗Additional Software Required GMic command line interface (CLI) https://gmic.eu/download.shtml\n🔗Limitations MAC compatibility not tested Although Darktable can handle file names containing spaces, GMic cli cannot, so if you want to use this script please make sure that your images do not have spaces in the file name and path\n🔗Author Marco Carrarini - marco.carrarini@gmail.com\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/rl_out_sharp/","tags":null,"title":"RL_out_sharp"},{"categories":null,"content":"The stars to set the rating of an image\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/ratings/","tags":null,"title":"darktable.gui.libs.ratings"},{"categories":null,"content":"dt_type\nA single rule for filtering a collection\n🔗dt_lib_collect_params_rule_t.mode types.dt_lib_collect_mode_t\nHow this rule is applied after the previous one. Unused for the first rule\nAttributes:\n write  🔗dt_lib_collect_params_rule_t.data string\nThe text segment of the rule. Exact content depends on the type of rule\nAttributes:\n write  🔗dt_lib_collect_params_rule_t.item types.dt_collection_properties_t\nThe item on which this rule filter. i.e the type of the rule\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lib_collect_params_rule_t/","tags":null,"title":"dt_lib_collect_params_rule_t"},{"categories":null,"content":"🔗Name select_untagged.lua - select all images that aren\u0026rsquo;t tagged\n🔗Description Enable selection of untagged images (darktable|* tags are ignored)\n🔗Usage 🔗Additional Software Required 🔗Limitations 🔗Author Jannis_V\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/select_untagged/","tags":null,"title":"select_untagged"},{"categories":null,"content":"The recent collection UI element\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/recentcollect/","tags":null,"title":"darktable.gui.libs.recentcollect"},{"categories":null,"content":"enum\nThe different lighttable layouts\nValues:\n DT_LIGHTTABLE_LAYOUT_FIRST DT_LIGHTTABLE_LAYOUT_ZOOMABLE DT_LIGHTTABLE_LAYOUT_FILEMANAGER DT_LIGHTTABLE_LAYOUT_CULLING DT_LIGHTTABLE_LAYOUT_CULLING_DYNAMIC DT_LIGHTTABLE_LAYOUT_PREVIEW DT_LIGHTTABLE_LAYOUT_LAST  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lighttable_layout_t/","tags":null,"title":"dt_lighttable_layout_t"},{"categories":null,"content":"🔗Name slideshowMusic.lua - play music during a slideshow\n🔗Description darktable script to play music during a Slideshow\n🔗Usage  start this script from script manager  🔗Additional Software Required You need rhythmbox-client installed to use this script\n🔗Limitations 🔗Author Tobias Jakobs\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/slideshowmusic/","tags":null,"title":"slideshowMusic"},{"categories":null,"content":"The buttons that allow quickly changing the selection\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.select.register_selection function( name : string label : string, callback : function, [tooltip : string] ) Add a new button and call a callback when it is clicked\n name - string - The name to use to refer to the select button label - string - The label to display on the button callback - function - The function to call when the button is pressed [tooltip] - string - The tooltip to use on the new button  callback -\nfunction( event : string, images : table oftypes.dt_lua_image_t ) : table oftypes.dt_lua_image_t The function to call when the button is pressed\n event - string - The name of the button that was pressed images - table of types.dt_lua_image_t - The images in the current collection. This is the same content asdarktable.collection return - table of types.dt_lua_image_t - The images to set the selection to  🔗darktable.gui.libs.select.destroy_selection function( name : string ) Remove a button created by darktable.gui.libs.select.register_selection.\n name - string - The name of the selection button to destroy  🔗darktable.gui.libs.select.selection_set_sensitive function( name : string sensitive : boolean ) Set the sensitivity of a button created by darktable.gui.libs.select.register_selection.\n name - string - The name of the selection button to change the sensitivty of sensitive - boolean - True to set the button sensitive, false to set it insensitive  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/select/","tags":null,"title":"darktable.gui.libs.select"},{"categories":null,"content":"enum\nThe alignment of a label\nValues:\n fill start end center baseline  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_align_t/","tags":null,"title":"dt_lua_align_t"},{"categories":null,"content":"🔗Name transfer_hierarchy.lua - move or copy image hierarchies from one location to another\n🔗Description Allows the moving or copying of images from one directory tree to another, while preserving the existing hierarchy.\n🔗Usage darktable\u0026rsquo;s native operations for moving and copying images in batches allow only one directory to be specified as the destination for each batch. Those wanting to move or copy images from a hierarchy of directories within darktable while preserving the directory structure, must take the laborious step of performing the operation one individual directory at a time.\nThis module allows the intact moving and copying of whole directory trees. It was designed for the specific use case of rapidly transferring images from a customary source (e.g., a staging directory on the local disk) to a customary destination (e.g., a directory on a NAS device).\n🔗Instructions for operation:   Select the set of images you want to copy.\n  Click the \u0026ldquo;calculate\u0026rdquo; button. This will calculate the lowest directory in the hierarchy that contains every selected file (i.e., the common prefix of all the images' pathnames), and write its path into the \u0026ldquo;existing root\u0026rdquo; text box.\n  If (a) you have specified the \u0026ldquo;customary source root\u0026rdquo; and \u0026ldquo;customary destination root\u0026rdquo; preferences, and (b) the selected images are all contained under the directory specified as the customary source root, then the \u0026ldquo;root of destination\u0026rdquo; text box will also be automatically filled out.\nFor example, suppose that you have specified \u0026lsquo;/home/user/Staging\u0026rsquo; as your customary source root and \u0026lsquo;/mnt/storage\u0026rsquo; as your customary destination root. If all selected images fell under the directory \u0026lsquo;/home/user/Staging/2020/Roll0001\u0026rsquo;, the \u0026ldquo;root of destination\u0026rdquo; would be automatically filled out with \u0026lsquo;/mnt/storage/2020/Roll0001\u0026rsquo;.\nBut if all selected images fall under a directory outside the specified customary source root (e.g., \u0026lsquo;/opt/other\u0026rsquo;), the \u0026ldquo;root of destination\u0026rdquo; text box must be filled out manually.\nIt is also possible to edit the \u0026ldquo;root of destination\u0026rdquo; further once it has been automatically filled out.\n  Click the \u0026ldquo;move\u0026rdquo; or \u0026ldquo;copy\u0026rdquo; button.\nBefore moving or copying any images, the module will first replicate the necessary directory hierarchy by creating all destination directories that do not already exist; should a directory creation attempt fail, the operation will be aborted, but any directories already created will not be removed.\nDuring the actual move/copy operation, the module transfers an image by taking its path and replacing the string in the \u0026ldquo;existing root\u0026rdquo; text box with that in the \u0026ldquo;root of destination\u0026rdquo; text box (e.g., \u0026lsquo;/home/user/Staging/2020/Roll0001/DSC_0001.jpg\u0026rsquo; would be transferred to \u0026lsquo;/mnt/storage/2020/Roll0001/DSC_0001.jpg\u0026rsquo;).\n  🔗Additional Software Required 🔗Limitations 🔗Author August Schwerdfeger - august@schwerdfeger.name\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/transfer_hierarchy/","tags":null,"title":"transfer_hierarchy"},{"categories":null,"content":"The session UI when tethering\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/session/","tags":null,"title":"darktable.gui.libs.session"},{"categories":null,"content":"dt_type\nA lua-managed entry in the backgroundjob lib\n🔗dt_lua_backgroundjob_t.percent number\nThe value of the progress bar, between 0 and 1. will return nil if there is no progress bar, will raise an error if read or written on an invalid job\nAttributes:\n write  🔗dt_lua_backgroundjob_t.valid boolean\nTrue if the job is displayed, set it to false to destroy the entry An invalid job cannot be made valid again\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_backgroundjob_t/","tags":null,"title":"dt_lua_backgroundjob_t"},{"categories":null,"content":"🔗Name video_ffmpeg.lua - create a timelapse video from selected images\n🔗Description This plugin will add the new export module \u0026ldquo;video ffmpeg\u0026rdquo;.\n🔗Usage  Go to Lighttable Select images you want to use as a video ffmpeg frames In image export module select \u0026ldquo;video ffmpeg\u0026rdquo; Configure you video settings Export  🔗Additional Software Required ffmpeg\n🔗Limitations This script has been tested under Linux only\n🔗Author Dominik Markiewicz\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.scripts.manual/scripts/contrib/video_ffmpeg/","tags":null,"title":"video_ffmpeg"},{"categories":null,"content":"The UI element that manipulates snapshots in darkroom\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  🔗darktable.gui.libs.snapshots.ratio number - The place in the screen where the line separating the snapshot is. Between 0 and 1\nAttributes:\n write  🔗darktable.gui.libs.snapshots.direction types.snapshot_direction_t - The direction of the snapshot overlay\nAttributes:\n write  🔗darktable.gui.libs.snapshots.# types.dt_lua_snapshot_t - Each snapshot appears with a numerical index; you can iterate over them with ipairs.\n🔗darktable.gui.libs.snapshots.selected types.dt_lua_snapshot_t - The currently selected snapshot\n🔗darktable.gui.libs.snapshots.take_snapshot function( ) Take a snapshot of the current image and add it to the UI The snapshot file will be generated at the next redraw of the main window\n🔗darktable.gui.libs.snapshots.clear_snapshots function( ) Delete all snapshots and remove them from the UI.\n🔗darktable.gui.libs.snapshots.max_snapshot types.dt_lua_snapshot_t - The maximum number of snapshots\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/snapshots/","tags":null,"title":"darktable.gui.libs.snapshots"},{"categories":null,"content":"dt_type\nA wrapper around a cairo drawing context. You probably shouldn\u0026rsquo;t use this after the callback that got it passed returned. For more details of the member functions have a look at the cairo documentation for the drawing context, transformations and paths.\n🔗dt_lua_cairo_t.save self:function( ) Save the state of the drawing context.\n self - types.dt_lua_cairo_t - The context to modify.  🔗types.dt_lua_cairo_t.restore self:function( ) Restore a previously saved state.\n self - types.dt_lua_cairo_t - The context to modify.  🔗dt_lua_cairo_t.move_to self:function( x : float, y : float ) Begin a new sub-path.\n self - types.dt_lua_cairo_t - The context to modify x - float - The x coordinate of the new position. y - float - The y coordinate of the new position.  🔗dt_lua_cairo_t.line_to self:function( x : float, y : float ) Add a line to the path.\n self - types.dt_lua_cairo_t - The context to modify. x - float - The x coordinate of the end of the new line. y - float - The y coordinate of the end of the new line.  🔗types.dt_lua_cairo_t.rectangle self:function( x : float, y : float, width : float, height : float ) Add a closed sub-path rectangle.\n self - types.dt_lua_cairo_t - The context to modify. x - float - The x coordinate of the top left corner of the rectangle. y - float - The y coordinate of the top left corner of the rectangle. width - float - The width of the rectangle. height - float - The height of the rectangle.  🔗dt_lua_cairo_t.arc self:function( x : float, y : float, radius : float, angle1 : float, angle2 : float ) Add a circular arc.\n self - types.dt_lua_cairo_t - The context to modify. x - float - The x position of the center of the arc. y - float - The y position of the center of the arc. radius - float - The radius of the arc. angle1 - float - The start angle, in radians. angle2 - float - The end angle, in radians.  🔗dt_lua_cairo_t.arc_negative self:function( x : float, y : float, radius : float, angle1 : float, angle2 : float ) Add a circular arc. It only differs in the direction from types.dt_lua_cairo_t.arc.\n self - types.dt_lua_cairo_t - The context to modify. x - float - The x position of the center of the arc. y - float - The y position of the center of the arc. radius - float - The radius of the arc. angle1 - float - The start angle, in radians. angle2 - float - The end angle, in radians.  🔗dt_lua_cairo_t.rotate self:function( angle : float ) Add a rotation to the transformation matrix.\n self - types.dt_lua_cairo_t - The context to modify. angle - float - The angle (in radians) by which the user-space axes will be rotated.  🔗dt_lua_cairo_t.scale self:function( x : float, y : float ) Add a scaling to the transformation matrix.\nself** - _types.dt_lua_cairo_t_ - The context to modify.\n x - float - The scale factor for the x dimension. y - float - The scale factor for the y dimension.  🔗dt_lua_cairo_t.translate self:function( x : float, y : float ) Add a translation to the transformation matrix.\n self - types.dt_lua_cairo_t - The context to modify. x - float - Amount to translate in the x direction y - float - Amount to translate in the y direction  🔗dt_lua_cairo_t.new_sub_path self:function( ) Begin a new sub-path.\n self - types.dt_lua_cairo_t - The context to modify.  🔗dt_lua_cairo_t.draw_line self:function( x_start : float, y_start : float, x_end : float, y_end : float ) Helper function to draw a line with a given start and end.\n self - types.dt_lua_cairo_t - The context to modify. x_start - float - The x coordinate of the start of the new line. y_start - float - The y coordinate of the start of the new line. x_end - float - The x coordinate of the end of the new line. y_end - float - The y coordinate of the end of the new line.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_cairo_t/","tags":null,"title":"dt_lua_cairo_t"},{"categories":null,"content":"The style selection menu\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/styles/","tags":null,"title":"darktable.gui.libs.styles"},{"categories":null,"content":"enum\nThe ellipsize mode of a label\nValues:\n none start middle end  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_ellipsize_mode_t/","tags":null,"title":"dt_lua_ellipsize_mode_t"},{"categories":null,"content":"The tag manipulation UI\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/tagging/","tags":null,"title":"darktable.gui.libs.tagging"},{"categories":null,"content":"dt_type\nA film in darktable; this represents a directory containing imported images.\nAttributes:\n has_tostring  🔗dt_lua_film_t.move_image see darktable.database.move_image\n🔗dt_lua_film_t.copy_image see darktable.database.copy_image\n🔗dt_lua_film_t.# types.dt_lua_image_t\nThe different images within the film.\n🔗dt_lua_film_t.id number A unique numeric id used by this film.\nAttributes:\n write  🔗dt_lua_film_t.path string\nThe path represented by this film.\nAttributes:\n write  🔗dt_lua_film_t.delete self:function( [force : boolean] ) Removes the film from the database.\n self - types.dt_lua_film_t - The film to remove. [force] - boolean - Force removal, even if the film is not empty.  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_film_t/","tags":null,"title":"dt_lua_film_t"},{"categories":null,"content":"The labels allowing to switch view\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/viewswitcher/","tags":null,"title":"darktable.gui.libs.viewswitcher"},{"categories":null,"content":"dt_type\nImage objects represent an image in the database. This is slightly different from a file on disk since a file can have multiple developments. Note that this is the real image object; changing the value of a field will immediately change it in darktable and will be reflected on any copy of that image object you may have kept.\nAttributes:\n has_tostring  🔗dt_lua_image_t.attach_tag see darktable.tags.attach\n🔗dt_lua_image_t.detach_tag see darktable.tags.detach\n🔗dt_lua_image_t.get_tags see darktable.tags.get_tags\n🔗dt_lua_image_t.create_style see darktable.styles.create\n🔗dt_lua_image_t.apply_style see darktable.styles.apply\n🔗dt_lua_image_t.duplicate see darktable.database.duplicate\n🔗dt_lua_image_t.move see darktable.database.move_image\n🔗dt_lua_image_t.copy see darktable.database.copy_image\n🔗dt_lua_image_t.id number\nA unique id identifying the image in the database.\n🔗dt_lua_image_t.path string\nThe file the directory containing the image.\n🔗dt_lua_image_t.film types.dt_lua_film_t\nThe film object that contains this image.\n🔗dt_lua_image_t.filename string\nThe filename of the image.\n🔗dt_lua_image_t.sidecar string\nThe filename of the image\u0026rsquo;s sidecar file.\n🔗dt_lua_image_t.duplicate_index number\nIf there are multiple images based on a same file, each will have a unique number, starting from 0.\n🔗dt_lua_image_t.publisher string\nThe publisher field of the image.\nAttributes:\n write  🔗dt_lua_image_t.title string\nThe title field of the image.\nAttributes:\n write  🔗dt_lua_image_t.creator string\nThe creator field of the image.\nAttributes:\n write  🔗dt_lua_image_t.rights string\nThe rights field of the image.\nAttributes:\n write  🔗dt_lua_image_t.description string\nThe description field for the image.\nAttributes:\n write  🔗dt_lua_image_t.notes string\nThe notes field for the image.\nAttributes:\n write  🔗dt_lua_image_t.version_name string\nThe version_name field for the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_maker string\nThe maker exif data.\nAttributes:\n write  🔗dt_lua_image_t.exif_model string\nThe camera model used.\nAttributes:\n write  🔗dt_lua_image_t.exif_lens string\nThe id string of the lens used.\nAttributes:\n write  🔗dt_lua_image_t.exif_aperture number\nThe aperture saved in the exif data.\nAttributes:\n write  🔗dt_lua_image_t.exif_exposure number\nThe exposure time of the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_focal_length number\nThe focal length of the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_iso number\nThe iso used on the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_datetime_taken string\nThe date and time of the image.\nAttributes:\n write  🔗dt_lua_image_t.exif_focus_distance number\nThe distance of the subject.\nAttributes:\n write  🔗dt_lua_image_t.exif_crop number\nThe exif crop data.\nAttributes:\n write  🔗dt_lua_image_t.latitude float or nil\nGPS latitude data of the image, nil if not set.\nAttributes:\n write  🔗dt_lua_image_t.longitude float or nil\nGPS longitude data of the image, nil if not set.\nAttributes:\n write  🔗dt_lua_image_t.elevation float or nil\nGPS altitude data of the image, nil if not set.\nAttributes:\n write  🔗dt_lua_image_t.is_raw boolean\nTrue if the image is a RAW file. WARNING: This is a flag that gets set the first time the image is opened, either by an edit or thumbnail generation. If images are imported using darktable.database.import(), then dt_lua_image_t.is_raw is not guaranteed to be correct.\n🔗dt_lua_image_t.is_ldr boolean\nTrue if the image is a ldr image.\n🔗dt_lua_image_t.is_hdr boolean\nTrue if the image is a hdr image.\n🔗dt_lua_image_t.is_altered boolean\nTrue if the image has been edited.\n🔗dt_lua_image_t.has_txt boolean\nTrue if the image has a txt sidecar file.\nAttributes:\n write  🔗dt_lua_image_t.width number\nThe width of the image.\n🔗dt_lua_image_t.height number\nThe height of the image.\n🔗dt_lua_image_t.rating number\nThe rating of the image (-1 for rejected).\nAttributes:\n write  🔗dt_lua_image_t.red boolean\nTrue if the image has the corresponding colorlabel.\nAttributes:\n write  🔗dt_lua_image_t.blue see types.dt_lua_image_t.red\n🔗dt_lua_image_t.green see types.dt_lua_image_t.red\n🔗dt_lua_image_t.yellow see types.dt_lua_image_t.red\n🔗dt_lua_image_t.purple see types.dt_lua_image_t.red\n🔗dt_lua_image_t.reset  self:function( ) Removes all processing from the image, resetting it back to its original state\n self - types.dt_lua_image_t - The image whose history will be deleted  🔗dt_lua_image_t.delete self:function( ) Removes an image from the database\n self - types.dt_lua_image_t - The image to remove  🔗dt_lua_image_t.group_with self:function( [image : types.dt_lua_image_t] ) Puts the first image in the same group as the second image. If no second image is provided the image will be in its own group.\n self - types.dt_lua_image_t - The image whose group must be changed. [image] - types.dt_lua_image_t - The image we want to group with.  🔗dt_lua_image_t.make_group_leader self:function( ) Makes the image the leader of its group.\n self - types.dt_lua_image_t - The image we want as the leader.  🔗dt_lua_image_t.get_group_members self:function( ) : table of types.dt_lua_image_t Returns a table containing all types.dt_lua_image_t of the group. The group leader is both at a numeric key and at the \u0026ldquo;leader\u0026rdquo; special key (so you probably want to use ipairs to iterate through that table).\n self - types.dt_lua_image_t - The image whose group we are querying. return - table of types.dt_lua_image_t - A table of image objects containing all images that are in the same group as the image.  🔗dt_lua_image_t.group_leader types.dt_lua_image_t\nThe image which is the leader of the group this image is a member of.\n🔗dt_lua_image_t.local_copy boolean\nTrue if the image has a copy in the local cache\nAttributes:\n write  🔗dt_lua_image_t.drop_cache self:function( ) drops the cached version of this image. This function should be called if an image is modified out of darktable to force darktable to regenerate the thumbnail. darktable will regenerate the thumbnail by itself when it is needed.\n self - types.dt_lua_image_t - The image whose cache must be dropped.  🔗dt_lua_image_t.generate_cache self.function( check_dirs : boolean start_size : integer end_size : integer )  self - types.dt_lua_image_t - The image whose cache is to be generated. check_dirs - boolean - check if the mipmap cache directories exist. Create them if necessary. start_size - integer - mipmap size to generate first end_size - integer - mipmap size to generate last  NOTES:\n  mipmap cache image sizes\n 0 - tiny 1 - 180 px 2 - 360 px 3 - 640 px 4 - 1920 px 5 - 2560 px 6 - 4096 px 7 - 5120 px 8 - full resolution    To generate a single size mipmap image set start_size and end_size to the same value\n  When generating multiple sizes put the largest size as the start size and the smallest as the end.\n  When different start and end sizes are specified, every size mipmap from start to end is generated.\n  When looping over a set of images and generating just one size, check for directories on the first image only.\n  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_image_t/","tags":null,"title":"dt_lua_image_t"},{"categories":null,"content":"The view_toolbox window\nAttributes:\n has_tostring parent : types.dt_lua_lib_t  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/darktable/gui/libs/view_toolbox/","tags":null,"title":"darktable.gui.libs.view_toolbox"},{"categories":null,"content":"dt_type\nThe type of a UI lib\n🔗dt_lua_lib_t.id string\nA unit string identifying the lib\n🔗dt_lua_lib_t.name string\nThe translated title of the UI element\n🔗dt_lua_lib_t.version number\nThe version of the internal data of this lib\n🔗dt_lua_lib_t.visible boolean\nAllow to make a lib module completely invisible to the user. Note that if the module is invisible the user will have no way to restore it without lua\nAttributes:\n implicit_yield write  🔗dt_lua_lib_t.container types.dt_ui_container_t\nThe location of the lib in the darktable UI\n🔗dt_lua_lib_t.expandable boolean\nTrue if the lib can be expanded/retracted\n🔗dt_lua_lib_t.expanded boolean\nTrue if the lib is expanded\nAttributes:\n write  🔗dt_lua_lib_t.position number\nA value deciding the position of the lib within its container\n🔗dt_lua_lib_t.views table\nA table of all the views that display this widget\n🔗dt_lua_lib_t.reset self:function( ) A function to reset the lib to its default values This function will do nothing if the lib is not visible or can\u0026rsquo;t be reset\n self - types.dt_lua_lib_t - The lib to reset  🔗dt_lua_lib_t.on_screen boolean\nTrue if the lib is currently visible on the screen\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_lib_t/","tags":null,"title":"dt_lua_lib_t"},{"categories":null,"content":"enum\nA possible orientation for a widget\nValues:\n horizontal vertical  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_orientation_t/","tags":null,"title":"dt_lua_orientation_t"},{"categories":null,"content":"dt_type\nThe description of a snapshot in the snapshot lib\nAttributes:\nhas_tostring\n🔗dt_lua_snapshot_t.filename string\nThe filename of an image containing the snapshot\n🔗dt_lua_snapshot_t.select self:function( ) Activates this snapshot on the display. To deactivate all snapshot you need to call this function on the active snapshot\n self - types.dt_lua_snapshot_t - The snapshot to activate  🔗dt_lua_snapshot_t.name string\nThe name of the snapshot, as seen in the UI\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_snapshot_t/","tags":null,"title":"dt_lua_snapshot_t"},{"categories":null,"content":"dt_type\nA tag that can be attached to an image.\nAttributes:\nhas_tostring\n🔗dt_lua_tag_t.delete see darktable.tags.delete\n🔗dt_lua_tag_t.attach see darktable.tags.attach\n🔗dt_lua_tag_t.detach see darktable.tags.detach\n🔗dt_lua_tag_t.name string\nThe name of the tag.\n🔗dt_lua_tag_t.# types.dt_lua_image_t\nThe images that have that tag attached to them.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_tag_t/","tags":null,"title":"dt_lua_tag_t"},{"categories":null,"content":"dt_type\nA darktable view\n🔗dt_lua_view_t.id string\nA unique string identifying the view\n🔗dt_lua_view_t.name string\nThe name of the view\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_lua_view_t/","tags":null,"title":"dt_lua_view_t"},{"categories":null,"content":"enum\nThe compression mode for PDF document\nValues:\n uncompressed deflate  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_pdf_stream_encoder_t/","tags":null,"title":"dt_pdf_stream_encoder_t"},{"categories":null,"content":"dt_type\nAn element that is part of a style.\nAttributes:\n has_tostring  🔗dt_style_item_t.name string\nThe name of the style item.\n🔗dt_style_item_t.num number\nThe position of the style item within its style.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_style_item_t/","tags":null,"title":"dt_style_item_t"},{"categories":null,"content":"dt_type A style that can be applied to an image. Attributes:\n has_tostring  🔗dt_style_t.delete see darktable.styles.delete\n🔗dt_style_t.duplicate see darktable.styles.duplicate\n🔗dt_style_t.apply see darktable.styles.apply\n🔗dt_style_t.export see darktable.styles.export\n🔗dt_style_t.name string\nThe name of the style.\n🔗dt_style_t.description string\nThe description of the style.\n🔗dt_style_t.# types.dt_style_item_t\nThe different items that make the style.\n","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_style_t/","tags":null,"title":"dt_style_t"},{"categories":null,"content":"enum\nA place in the darktable UI where a lib can be placed\nValues:\n DT_UI_CONTAINER_PANEL_LEFT_TOP DT_UI_CONTAINER_PANEL_LEFT_CENTER DT_UI_CONTAINER_PANEL_LEFT_BOTTOM DT_UI_CONTAINER_PANEL_RIGHT_TOP DT_UI_CONTAINER_PANEL_RIGHT_CENTER DT_UI_CONTAINER_PANEL_RIGHT_BOTTOM DT_UI_CONTAINER_PANEL_TOP_LEFT DT_UI_CONTAINER_PANEL_TOP_CENTER DT_UI_CONTAINER_PANEL_TOP_RIGHT DT_UI_CONTAINER_PANEL_CENTER_TOP_LEFT DT_UI_CONTAINER_PANEL_CENTER_TOP_CENTER DT_UI_CONTAINER_PANEL_CENTER_TOP_RIGHT DT_UI_CONTAINER_PANEL_CENTER_BOTTOM_LEFT DT_UI_CONTAINER_PANEL_CENTER_BOTTOM_CENTER DT_UI_CONTAINER_PANEL_CENTER_BOTTOM_RIGHT DT_UI_CONTAINER_PANEL_BOTTOM  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_ui_container_t/","tags":null,"title":"dt_ui_container_t"},{"categories":null,"content":"enum\nThe different user interface panels\nValues:\n DT_UI_PANEL_TOP DT_UI_PANEL_CENTER_TOP DT_UI_PANEL_CENTER_BOTTOM DT_UI_PANEL_LEFT DT_UI_PANEL_RIGHT DT_UI_PANEL_BOTTOM DT_UI_PANEL_SIZE  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/dt_ui_panel_t/","tags":null,"title":"dt_ui_panel_t"},{"categories":null,"content":"enum\na hint on the way to encode a webp image\nValues:\n hint_default hint_picture hint_photo hint_graphic  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/hint_t/","tags":null,"title":"hint_t"},{"categories":null,"content":"dt_type\nA container for widget in a horizontal or vertical list\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_box.__call see types.lua_widget.As a function\n🔗lua_box.extra registration parameters This widget has no extra registration parameters\n🔗lua_box.orientation types.dt_lua_orientation_t\nThe orientation of the box.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_box/","tags":null,"title":"lua_box"},{"categories":null,"content":"dt_type\nA clickable button\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_button.__call see types.lua_widget.As a function\n🔗lua_button.extra registration parameters This widget has no extra registration parameters\n🔗lua_button.label string\nThe label displayed on the button\nAttributes:\n write  🔗lua_button.ellipsize types.dt_lua_ellipsize_mode_t\nThe ellipsize mode of the button label\nAttributes:\n write  🔗lua_button.clicked_callback function( widget : types.lua_widget ) A function to call on button click\n widget - types.lua_widget - The widget that triggered the callback  Attributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_button/","tags":null,"title":"lua_button"},{"categories":null,"content":"dt_type\nA checkable button with a label next to it Attributes:\n has_tostring parent : types.lua_widget  🔗lua_check_button.__call see types.lua_widget.As a function\n🔗lua_check_button.extra registration parameters This widget has no extra registration parameters\n🔗lua_check_button.label string\nThe label displayed next to the button\nAttributes:\n write  🔗lua_check_button.value boolean\nIf the widget is checked or not\nAttributes:\n write  🔗lua_check_button.clicked_callback function( widget : types.lua_widget ) A function to call on button click\n widget - types.lua_widget - The widget that triggered the callback  Attributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_check_button/","tags":null,"title":"lua_check_button"},{"categories":null,"content":"dt_type\nA widget with multiple text entries in a menu. This widget can be set as editable at construction time. If it is editable the user can type a value and is not constrained by the values in the menu.\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_combobox.__call see types.lua_widget.As a function\n🔗lua_combobox.extra registration parameters This widget has no extra registration parameters\n🔗lua_combobox.value string\nThe text content of the selected entry, can be nil. You can set it to a number to select the corresponding entry from the menu. If the combobox is editable, you can set it to any string. You can set it to nil to deselect all entries.\nAttributes:\n write  🔗lua_combobox.selected integer\nThe index of the selected entry, or 0 if nothing is selected. You can set it to a number to select the corresponding entry from the menu, or to 0 to select nothing. You can set it to nil to deselect all entries.\nAttributes:\n write  🔗lua_combobox.# string\nThe various menu entries. You can add new entries by writing to the first element beyond the end. You can removes entries by setting them to nil.\nAttributes:\n write  🔗lua_combobox.changed_callback function( widget : types.lua_widget ) A function to call when the value field changes (character entered or value selected)\n widget - types.lua_widget - The widget that triggered the callback  Attributes:\n write  🔗lua_combobox.editable boolean\nTrue is the user is allowed to type a string in the combobox\nAttributes:\n write  🔗lua_combobox.label string\nThe label displayed on the combobox\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_combobox/","tags":null,"title":"lua_combobox"},{"categories":null,"content":"dt_type\nA widget containing other widgets\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_container.__call see types.lua_widget.As a function\n🔗lua_container.extra registration parameters This widget has no extra registration parameters\n🔗lua_container.# types.lua_widget\nThe widgets contained by the box. You can append widgets by adding them at the end of the list. You can remove widgets by setting them to nil.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_container/","tags":null,"title":"lua_container"},{"categories":null,"content":"dt_type\nA widget in which the user can input text\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_entry.__call see types.lua_widget.As a function\n🔗lua_entry.extra registration parameters This widget has no extra registration parameters\n🔗lua_entry.text string\nThe content of the entry\nAttributes:\n write  🔗lua_entry.placeholder string\nThe text to display when the entry is empty\nAttributes:\n write  🔗lua_entry.is_password boolean\nTrue if the text content should be hidden\nAttributes:\n write  🔗lua_entry.editable boolean\nFalse if the entry should be read-only\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_entry/","tags":null,"title":"lua_entry"},{"categories":null,"content":"dt_type\nA button that allows the user to select an existing file\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_file_chooser_button.__call see types.lua_widget.As a function\n🔗lua_file_chooser_button.extra registration parameters This widget has no extra registration parameters\n🔗lua_file_chooser_button.title string\nThe title of the window when choosing a file\nAttributes:\n write  🔗lua_file_chooser_button.value string\nThe currently selected file\nAttributes:\n write  🔗lua_file_chooser_button.changed_callback function( widget : types.lua_widget ) A function to call when the value field changes (character entered or value selected)\n widget - types.lua_widget - The widget that triggered the callback  Attributes:\n write  🔗lua_file_chooser_button.is_directory boolean\nTrue if the file chooser button only allows directories to be selected\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_file_chooser_button/","tags":null,"title":"lua_file_chooser_button"},{"categories":null,"content":"dt_type\nA label containing some text\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_label.__call see types.lua_widget.As a function\n🔗lua_label.extra registration parameters This widget has no extra registration parameters\n🔗lua_label.label string\nThe label displayed\nAttributes:\n write  🔗lua_label.selectable boolean\nTrue if the label content should be selectable\nAttributes:\n write  🔗lua_label.halign types.dt_lua_align_t\nThe horizontal alignment of the label\nAttributes:\n write  🔗lua_label.ellipsize types.dt_lua_ellipsize_mode_t\nThe ellipsize mode of the label\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_label/","tags":null,"title":"lua_label"},{"categories":null,"content":"enum The type of OS we darktable can run on\nValues :\n windows macos linux unix  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_os_type/","tags":null,"title":"lua_os_type"},{"categories":null,"content":"enum\nThe type of value to save in a preference\nValues:\n enum directory file string bool integer float lua  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_pref_type/","tags":null,"title":"lua_pref_type"},{"categories":null,"content":"dt_type\nA section label\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_section_label.__call see types.lua_widget.As a function\n🔗types.lua_section_label.extra registration parameters This widget has no extra registration parameters\n🔗lua_section_label.label string\nThe section name\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_section_label/","tags":null,"title":"lua_section_label"},{"categories":null,"content":"dt_type\nA widget providing a separation in the UI.\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_separator.__call see types.lua_widget.As a function\n🔗lua_separator.extra registration parameters This widget has no extra registration parameters\n🔗lua_separator.orientation string\nThe orientation of the separator.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_separator/","tags":null,"title":"lua_separator"},{"categories":null,"content":"dt_type\nA slider that can be set by the user\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_slider.__call see types.lua_widget.As a function\n🔗lua_slider.extra registration parameters This widget has no extra registration parameters\n🔗lua_slider.soft_min number\nThe soft minimum value for the slider, the slider can\u0026rsquo;t go beyond this point\nAttributes:\n write  🔗lua_slider.soft_max number\nThe soft maximum value for the slider, the slider can\u0026rsquo;t go beyond this point\nAttributes:\n write  🔗lua_slider.hard_min number\nThe hard minimum value for the slider, the user can\u0026rsquo;t manually enter a value beyond this point Attributes:\n write  🔗lua_slider.hard_max number\nThe hard maximum value for the slider, the user can\u0026rsquo;t manually enter a value beyond this point\nAttributes:\n write  🔗lua_slider.step number\nThe step width of the slider\nAttributes:\n write  🔗lua_slider.digits integer\nThe number of decimal digits shown on the slider\nAttributes:\n write  🔗lua_slider.value number\nThe current value of the slider\nAttributes:\n write  🔗lua_slider.label string\nThe label next to the slider\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_slider/","tags":null,"title":"lua_slider"},{"categories":null,"content":"dt_type\nA container that will only show one of its child at a time\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_stack.__call see types.lua_widget.As a function\n🔗lua_stack.extra registration parameters This widget has no extra registration parameters\n🔗lua_stack.active types.lua_widget or nil\nThe currently selected child, can be nil if the container has no child, can be set to one of the child widget or to an index in the child table\nAttributes:\n write  🔗lua_stack.h_size_fixed boolean\nTrue if horizontal size is fixed, false if stack can be resized horizontally.\nAttributes:\n write  🔗lua_stack.v_size_fixed boolean\nTrue if vertical size is fixed, false if stack can be resized vertically.\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_stack/","tags":null,"title":"lua_stack"},{"categories":null,"content":"dt_type\nA multiline text input widget\nAttributes:\n has_tostring parent : types.lua_widget  🔗lua_text_view.__call see types.lua_widget.As a function\n🔗lua_text_view.extra registration parameters This widget has no extra registration parameters\n🔗lua_text_view.text string\nThe text in the widget\nAttributes:\n write  🔗lua_text_view.editable boolean\nFalse if the entry should be read-only\nAttributes:\n write  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_text_view/","tags":null,"title":"lua_text_view"},{"categories":null,"content":"dt_type\nCommon parent type for all lua-handled widgets\nAttributes:\n has_tostring  🔗lua_widget.extra registration parameters This widget has no extra registration parameters\n🔗lua_widget.name string or nil\nName assigned to the widget for CSS styling purposes.\nAttributes:\n write  🔗lua_widget.sensitive boolean\nSet if the widget is enabled/disabled\nAttributes:\n write  🔗lua_widget.tooltip string or nil\nTooltip to display for the widget\nAttributes:\n write  🔗lua_widget.visible boolean or nil\nHide or show widget. Default is show.\nAttributes:\n write  🔗lua_widget.reset_callback function( widget : types.lua_widget ) A function to call when the widget needs to reset itself. Note that some widgets have a default implementation that can be overridden, (containers in particular will recursively reset their children). If you replace that default implementation you need to reimplement that functionality or call the original function within your callback.\nAttributes:\n  write\n  widget - types.lua_widget - The widget that triggered the callback\n  🔗lua_widget.As a function function( attributes : table ) : types.lua_widget Using a lua widget as a function Allows to set multiple attributes of that widget at once. This is mainly used to create UI elements in a more readable way.\nFor example:\nlocal widget = dt.new_widget(\u0026quot;button\u0026quot;){ label =\u0026quot;my label\u0026quot;, clicked_callback = function() print \u0026quot;hello world\u0026quot; end }  attributes - table - A table of attributes =\u0026gt; value to set return - types.lua_widget - The object called itself, to allow chaining  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/lua_widget/","tags":null,"title":"lua_widget"},{"categories":null,"content":"enum\nWhich part of the main window is occupied by a snapshot\nValues:\n left right top bottom  ","date":"0001-01-01T00:00:00Z","href":"/luadocs/lua.api.manual/types/snapshot_direction_t/","tags":null,"title":"snapshot_direction_t"},{"categories":null,"content":"","date":"0001-01-01T00:00:00Z","href":"/luadocs/search/","tags":null,"title":"Search"}]
\ No newline at end of file
diff --git a/index.xml b/index.xml
index eb5c1b5..29e6e8d 100644
--- a/index.xml
+++ b/index.xml
@@ -2770,6 +2770,17 @@ I use the following shortcuts:
  Reject group: Ctrl+R Rate group 1: Ctrl+1 Rate group 2: Ctrl+2 Rate group 3: Ctrl+3 Rate group 4: Ctrl+4 Rate group 5: Ctrl+5 Rate group 0: Ctrl+0  🔗Additional Software Required 🔗Limitations 🔗Author Dom H - dom@hxy.</description>
     </item>
     
+    <item>
+      <title>rename_images</title>
+      <link>https://darktable-org.github.io/luadocs/lua.scripts.manual/scripts/contrib/rename_images/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://darktable-org.github.io/luadocs/lua.scripts.manual/scripts/contrib/rename_images/</guid>
+      <description>🔗Name rename_images.lua - rename one or more image files
+🔗Description Rename an image or images according to a pattern built by the user. It is possible to specify a different directory in the rename pattern, which will result in a move as well as a rename. The database will be updated to reflect the new name/location of the image.
+🔗Usage  require this script from your luarc file or start it from script_manager select an image or images enter a renaming pattern click the button to rename the files  🔗Additional Software Required 🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.</description>
+    </item>
+    
     <item>
       <title>darktable.gui.libs.navigation</title>
       <link>https://darktable-org.github.io/luadocs/lua.api.manual/darktable/gui/libs/navigation/</link>
diff --git a/lua.api.manual/attributes/index.html b/lua.api.manual/attributes/index.html
index 699b32d..9c3040e 100644
--- a/lua.api.manual/attributes/index.html
+++ b/lua.api.manual/attributes/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.collection/index.html b/lua.api.manual/darktable/darktable.collection/index.html
index 034a424..036cbb4 100644
--- a/lua.api.manual/darktable/darktable.collection/index.html
+++ b/lua.api.manual/darktable/darktable.collection/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.configuration/index.html b/lua.api.manual/darktable/darktable.configuration/index.html
index 32276a9..bb38f6f 100644
--- a/lua.api.manual/darktable/darktable.configuration/index.html
+++ b/lua.api.manual/darktable/darktable.configuration/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.control/index.html b/lua.api.manual/darktable/darktable.control/index.html
index 8f2de14..d09add7 100644
--- a/lua.api.manual/darktable/darktable.control/index.html
+++ b/lua.api.manual/darktable/darktable.control/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.database/index.html b/lua.api.manual/darktable/darktable.database/index.html
index 246a248..e2b971b 100644
--- a/lua.api.manual/darktable/darktable.database/index.html
+++ b/lua.api.manual/darktable/darktable.database/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.debug/index.html b/lua.api.manual/darktable/darktable.debug/index.html
index 5f60cfb..fc038a1 100644
--- a/lua.api.manual/darktable/darktable.debug/index.html
+++ b/lua.api.manual/darktable/darktable.debug/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.destroy_event/index.html b/lua.api.manual/darktable/darktable.destroy_event/index.html
index 6301910..f76242c 100644
--- a/lua.api.manual/darktable/darktable.destroy_event/index.html
+++ b/lua.api.manual/darktable/darktable.destroy_event/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.destroy_storage/index.html b/lua.api.manual/darktable/darktable.destroy_storage/index.html
index 291ef82..6c187fb 100644
--- a/lua.api.manual/darktable/darktable.destroy_storage/index.html
+++ b/lua.api.manual/darktable/darktable.destroy_storage/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.films/index.html b/lua.api.manual/darktable/darktable.films/index.html
index 35c6376..ae6f6db 100644
--- a/lua.api.manual/darktable/darktable.films/index.html
+++ b/lua.api.manual/darktable/darktable.films/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.gettext/index.html b/lua.api.manual/darktable/darktable.gettext/index.html
index 0fca294..75ec12a 100644
--- a/lua.api.manual/darktable/darktable.gettext/index.html
+++ b/lua.api.manual/darktable/darktable.gettext/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.guides/index.html b/lua.api.manual/darktable/darktable.guides/index.html
index 34cfbae..9fb8afe 100644
--- a/lua.api.manual/darktable/darktable.guides/index.html
+++ b/lua.api.manual/darktable/darktable.guides/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.new_format/index.html b/lua.api.manual/darktable/darktable.new_format/index.html
index 8a0e666..3d03e5b 100644
--- a/lua.api.manual/darktable/darktable.new_format/index.html
+++ b/lua.api.manual/darktable/darktable.new_format/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.new_storage/index.html b/lua.api.manual/darktable/darktable.new_storage/index.html
index 0673b8a..6a7cd79 100644
--- a/lua.api.manual/darktable/darktable.new_storage/index.html
+++ b/lua.api.manual/darktable/darktable.new_storage/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.new_widget/index.html b/lua.api.manual/darktable/darktable.new_widget/index.html
index 71d55ca..ab7e1a7 100644
--- a/lua.api.manual/darktable/darktable.new_widget/index.html
+++ b/lua.api.manual/darktable/darktable.new_widget/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.password/index.html b/lua.api.manual/darktable/darktable.password/index.html
index 2fbbd16..14cde8e 100644
--- a/lua.api.manual/darktable/darktable.password/index.html
+++ b/lua.api.manual/darktable/darktable.password/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.preferences/index.html b/lua.api.manual/darktable/darktable.preferences/index.html
index db28c54..6f30dca 100644
--- a/lua.api.manual/darktable/darktable.preferences/index.html
+++ b/lua.api.manual/darktable/darktable.preferences/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.print/index.html b/lua.api.manual/darktable/darktable.print/index.html
index d1722e7..f124c07 100644
--- a/lua.api.manual/darktable/darktable.print/index.html
+++ b/lua.api.manual/darktable/darktable.print/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.print_error/index.html b/lua.api.manual/darktable/darktable.print_error/index.html
index 8966fdd..4b0c01a 100644
--- a/lua.api.manual/darktable/darktable.print_error/index.html
+++ b/lua.api.manual/darktable/darktable.print_error/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.print_hinter/index.html b/lua.api.manual/darktable/darktable.print_hinter/index.html
index a5c17be..b455e11 100644
--- a/lua.api.manual/darktable/darktable.print_hinter/index.html
+++ b/lua.api.manual/darktable/darktable.print_hinter/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.print_log/index.html b/lua.api.manual/darktable/darktable.print_log/index.html
index 77c8401..f3267f5 100644
--- a/lua.api.manual/darktable/darktable.print_log/index.html
+++ b/lua.api.manual/darktable/darktable.print_log/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.print_toast/index.html b/lua.api.manual/darktable/darktable.print_toast/index.html
index f7a83d0..154b2ef 100644
--- a/lua.api.manual/darktable/darktable.print_toast/index.html
+++ b/lua.api.manual/darktable/darktable.print_toast/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.register_event/index.html b/lua.api.manual/darktable/darktable.register_event/index.html
index 49b15ff..9eaacde 100644
--- a/lua.api.manual/darktable/darktable.register_event/index.html
+++ b/lua.api.manual/darktable/darktable.register_event/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.register_lib/index.html b/lua.api.manual/darktable/darktable.register_lib/index.html
index b5829cd..a87588e 100644
--- a/lua.api.manual/darktable/darktable.register_lib/index.html
+++ b/lua.api.manual/darktable/darktable.register_lib/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.register_storage/index.html b/lua.api.manual/darktable/darktable.register_storage/index.html
index cbd3c04..db557b2 100644
--- a/lua.api.manual/darktable/darktable.register_storage/index.html
+++ b/lua.api.manual/darktable/darktable.register_storage/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.styles/index.html b/lua.api.manual/darktable/darktable.styles/index.html
index 66092d4..cba9ce6 100644
--- a/lua.api.manual/darktable/darktable.styles/index.html
+++ b/lua.api.manual/darktable/darktable.styles/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/darktable.tags/index.html b/lua.api.manual/darktable/darktable.tags/index.html
index f3b75de..c8182b7 100644
--- a/lua.api.manual/darktable/darktable.tags/index.html
+++ b/lua.api.manual/darktable/darktable.tags/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/action/index.html b/lua.api.manual/darktable/gui/action/index.html
index ad27b54..f971fa9 100644
--- a/lua.api.manual/darktable/gui/action/index.html
+++ b/lua.api.manual/darktable/gui/action/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/action_images/index.html b/lua.api.manual/darktable/gui/action_images/index.html
index 19dcbbe..0d0436c 100644
--- a/lua.api.manual/darktable/gui/action_images/index.html
+++ b/lua.api.manual/darktable/gui/action_images/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/create_job/index.html b/lua.api.manual/darktable/gui/create_job/index.html
index cb983c2..3991c3f 100644
--- a/lua.api.manual/darktable/gui/create_job/index.html
+++ b/lua.api.manual/darktable/gui/create_job/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/current_view/index.html b/lua.api.manual/darktable/gui/current_view/index.html
index 5f24af2..2fb027d 100644
--- a/lua.api.manual/darktable/gui/current_view/index.html
+++ b/lua.api.manual/darktable/gui/current_view/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/hovered/index.html b/lua.api.manual/darktable/gui/hovered/index.html
index 51ae4c7..52cce1f 100644
--- a/lua.api.manual/darktable/gui/hovered/index.html
+++ b/lua.api.manual/darktable/gui/hovered/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/index.html b/lua.api.manual/darktable/gui/index.html
index b41950f..465db39 100644
--- a/lua.api.manual/darktable/gui/index.html
+++ b/lua.api.manual/darktable/gui/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/backgroundjobs/index.html b/lua.api.manual/darktable/gui/libs/backgroundjobs/index.html
index 9518f74..da2f180 100644
--- a/lua.api.manual/darktable/gui/libs/backgroundjobs/index.html
+++ b/lua.api.manual/darktable/gui/libs/backgroundjobs/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/camera/index.html b/lua.api.manual/darktable/gui/libs/camera/index.html
index 811857c..45ba338 100644
--- a/lua.api.manual/darktable/gui/libs/camera/index.html
+++ b/lua.api.manual/darktable/gui/libs/camera/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/collect/index.html b/lua.api.manual/darktable/gui/libs/collect/index.html
index 7a721a1..d9d2a99 100644
--- a/lua.api.manual/darktable/gui/libs/collect/index.html
+++ b/lua.api.manual/darktable/gui/libs/collect/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/colorlabels/index.html b/lua.api.manual/darktable/gui/libs/colorlabels/index.html
index d43fd38..ec17403 100644
--- a/lua.api.manual/darktable/gui/libs/colorlabels/index.html
+++ b/lua.api.manual/darktable/gui/libs/colorlabels/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/colorpicker/index.html b/lua.api.manual/darktable/gui/libs/colorpicker/index.html
index f609585..1fbd950 100644
--- a/lua.api.manual/darktable/gui/libs/colorpicker/index.html
+++ b/lua.api.manual/darktable/gui/libs/colorpicker/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/copy_history/index.html b/lua.api.manual/darktable/gui/libs/copy_history/index.html
index fd1f4e2..7677429 100644
--- a/lua.api.manual/darktable/gui/libs/copy_history/index.html
+++ b/lua.api.manual/darktable/gui/libs/copy_history/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/darktable_label/index.html b/lua.api.manual/darktable/gui/libs/darktable_label/index.html
index 2a4b8c0..1d53394 100644
--- a/lua.api.manual/darktable/gui/libs/darktable_label/index.html
+++ b/lua.api.manual/darktable/gui/libs/darktable_label/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/export/index.html b/lua.api.manual/darktable/gui/libs/export/index.html
index 6c7fbfa..c9502a4 100644
--- a/lua.api.manual/darktable/gui/libs/export/index.html
+++ b/lua.api.manual/darktable/gui/libs/export/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/filmstrip/index.html b/lua.api.manual/darktable/gui/libs/filmstrip/index.html
index 42148f6..73bed7b 100644
--- a/lua.api.manual/darktable/gui/libs/filmstrip/index.html
+++ b/lua.api.manual/darktable/gui/libs/filmstrip/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/filter/index.html b/lua.api.manual/darktable/gui/libs/filter/index.html
index ad510da..80a838a 100644
--- a/lua.api.manual/darktable/gui/libs/filter/index.html
+++ b/lua.api.manual/darktable/gui/libs/filter/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/geotagging/index.html b/lua.api.manual/darktable/gui/libs/geotagging/index.html
index ded79dc..29fd940 100644
--- a/lua.api.manual/darktable/gui/libs/geotagging/index.html
+++ b/lua.api.manual/darktable/gui/libs/geotagging/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/global_toolbox/index.html b/lua.api.manual/darktable/gui/libs/global_toolbox/index.html
index c1c5dc1..4c1660b 100644
--- a/lua.api.manual/darktable/gui/libs/global_toolbox/index.html
+++ b/lua.api.manual/darktable/gui/libs/global_toolbox/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/hinter/index.html b/lua.api.manual/darktable/gui/libs/hinter/index.html
index 728d4e1..24e4e98 100644
--- a/lua.api.manual/darktable/gui/libs/hinter/index.html
+++ b/lua.api.manual/darktable/gui/libs/hinter/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/histogram/index.html b/lua.api.manual/darktable/gui/libs/histogram/index.html
index df687fe..f88ab29 100644
--- a/lua.api.manual/darktable/gui/libs/histogram/index.html
+++ b/lua.api.manual/darktable/gui/libs/histogram/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/history/index.html b/lua.api.manual/darktable/gui/libs/history/index.html
index eede985..a577826 100644
--- a/lua.api.manual/darktable/gui/libs/history/index.html
+++ b/lua.api.manual/darktable/gui/libs/history/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/image/index.html b/lua.api.manual/darktable/gui/libs/image/index.html
index 3460f47..4c7ef17 100644
--- a/lua.api.manual/darktable/gui/libs/image/index.html
+++ b/lua.api.manual/darktable/gui/libs/image/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/import/index.html b/lua.api.manual/darktable/gui/libs/import/index.html
index 3c490e2..22ff6e0 100644
--- a/lua.api.manual/darktable/gui/libs/import/index.html
+++ b/lua.api.manual/darktable/gui/libs/import/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/index.html b/lua.api.manual/darktable/gui/libs/index.html
index 3288156..f43e8a4 100644
--- a/lua.api.manual/darktable/gui/libs/index.html
+++ b/lua.api.manual/darktable/gui/libs/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/lighttable_mode/index.html b/lua.api.manual/darktable/gui/libs/lighttable_mode/index.html
index 4a30755..9a0df7f 100644
--- a/lua.api.manual/darktable/gui/libs/lighttable_mode/index.html
+++ b/lua.api.manual/darktable/gui/libs/lighttable_mode/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/live_view/index.html b/lua.api.manual/darktable/gui/libs/live_view/index.html
index 7cb3e4f..2ddab61 100644
--- a/lua.api.manual/darktable/gui/libs/live_view/index.html
+++ b/lua.api.manual/darktable/gui/libs/live_view/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/location/index.html b/lua.api.manual/darktable/gui/libs/location/index.html
index a4f5a5f..500d792 100644
--- a/lua.api.manual/darktable/gui/libs/location/index.html
+++ b/lua.api.manual/darktable/gui/libs/location/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/map_settings/index.html b/lua.api.manual/darktable/gui/libs/map_settings/index.html
index 5a257d9..5801fe3 100644
--- a/lua.api.manual/darktable/gui/libs/map_settings/index.html
+++ b/lua.api.manual/darktable/gui/libs/map_settings/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/masks/index.html b/lua.api.manual/darktable/gui/libs/masks/index.html
index d7df47b..5392897 100644
--- a/lua.api.manual/darktable/gui/libs/masks/index.html
+++ b/lua.api.manual/darktable/gui/libs/masks/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/metadata/index.html b/lua.api.manual/darktable/gui/libs/metadata/index.html
index d5fbffb..76be351 100644
--- a/lua.api.manual/darktable/gui/libs/metadata/index.html
+++ b/lua.api.manual/darktable/gui/libs/metadata/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/metadata_view/index.html b/lua.api.manual/darktable/gui/libs/metadata_view/index.html
index e936f6a..ab9e5e1 100644
--- a/lua.api.manual/darktable/gui/libs/metadata_view/index.html
+++ b/lua.api.manual/darktable/gui/libs/metadata_view/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/module_toolbox/index.html b/lua.api.manual/darktable/gui/libs/module_toolbox/index.html
index feccb96..bb2d775 100644
--- a/lua.api.manual/darktable/gui/libs/module_toolbox/index.html
+++ b/lua.api.manual/darktable/gui/libs/module_toolbox/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/modulegroups/index.html b/lua.api.manual/darktable/gui/libs/modulegroups/index.html
index c2f9467..b4290d3 100644
--- a/lua.api.manual/darktable/gui/libs/modulegroups/index.html
+++ b/lua.api.manual/darktable/gui/libs/modulegroups/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/navigation/index.html b/lua.api.manual/darktable/gui/libs/navigation/index.html
index 8095c4c..f26581d 100644
--- a/lua.api.manual/darktable/gui/libs/navigation/index.html
+++ b/lua.api.manual/darktable/gui/libs/navigation/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/overview/index.html b/lua.api.manual/darktable/gui/libs/overview/index.html
index 9fffd5c..cf6f411 100644
--- a/lua.api.manual/darktable/gui/libs/overview/index.html
+++ b/lua.api.manual/darktable/gui/libs/overview/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/print_settings/index.html b/lua.api.manual/darktable/gui/libs/print_settings/index.html
index 0285935..7f89d7e 100644
--- a/lua.api.manual/darktable/gui/libs/print_settings/index.html
+++ b/lua.api.manual/darktable/gui/libs/print_settings/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/ratings/index.html b/lua.api.manual/darktable/gui/libs/ratings/index.html
index 1f62d17..14167c7 100644
--- a/lua.api.manual/darktable/gui/libs/ratings/index.html
+++ b/lua.api.manual/darktable/gui/libs/ratings/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/recentcollect/index.html b/lua.api.manual/darktable/gui/libs/recentcollect/index.html
index 736a70b..7c3bb04 100644
--- a/lua.api.manual/darktable/gui/libs/recentcollect/index.html
+++ b/lua.api.manual/darktable/gui/libs/recentcollect/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/select/index.html b/lua.api.manual/darktable/gui/libs/select/index.html
index a91a2b1..5d4a4ab 100644
--- a/lua.api.manual/darktable/gui/libs/select/index.html
+++ b/lua.api.manual/darktable/gui/libs/select/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/session/index.html b/lua.api.manual/darktable/gui/libs/session/index.html
index eff738b..1ff3cac 100644
--- a/lua.api.manual/darktable/gui/libs/session/index.html
+++ b/lua.api.manual/darktable/gui/libs/session/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/snapshots/index.html b/lua.api.manual/darktable/gui/libs/snapshots/index.html
index c165b2d..c758651 100644
--- a/lua.api.manual/darktable/gui/libs/snapshots/index.html
+++ b/lua.api.manual/darktable/gui/libs/snapshots/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/styles/index.html b/lua.api.manual/darktable/gui/libs/styles/index.html
index 69c7587..76c8ae4 100644
--- a/lua.api.manual/darktable/gui/libs/styles/index.html
+++ b/lua.api.manual/darktable/gui/libs/styles/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/tagging/index.html b/lua.api.manual/darktable/gui/libs/tagging/index.html
index c531227..2f17c30 100644
--- a/lua.api.manual/darktable/gui/libs/tagging/index.html
+++ b/lua.api.manual/darktable/gui/libs/tagging/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/view_toolbox/index.html b/lua.api.manual/darktable/gui/libs/view_toolbox/index.html
index bedb85b..ee1474c 100644
--- a/lua.api.manual/darktable/gui/libs/view_toolbox/index.html
+++ b/lua.api.manual/darktable/gui/libs/view_toolbox/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/libs/viewswitcher/index.html b/lua.api.manual/darktable/gui/libs/viewswitcher/index.html
index a44366a..26f6203 100644
--- a/lua.api.manual/darktable/gui/libs/viewswitcher/index.html
+++ b/lua.api.manual/darktable/gui/libs/viewswitcher/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/overview/index.html b/lua.api.manual/darktable/gui/overview/index.html
index c972bc3..3d3b6c3 100644
--- a/lua.api.manual/darktable/gui/overview/index.html
+++ b/lua.api.manual/darktable/gui/overview/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/panel_get_size/index.html b/lua.api.manual/darktable/gui/panel_get_size/index.html
index 5fecdd0..50171fd 100644
--- a/lua.api.manual/darktable/gui/panel_get_size/index.html
+++ b/lua.api.manual/darktable/gui/panel_get_size/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/panel_hide/index.html b/lua.api.manual/darktable/gui/panel_hide/index.html
index 403be65..eaad391 100644
--- a/lua.api.manual/darktable/gui/panel_hide/index.html
+++ b/lua.api.manual/darktable/gui/panel_hide/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/panel_hide_all/index.html b/lua.api.manual/darktable/gui/panel_hide_all/index.html
index e6b08f4..d3155d6 100644
--- a/lua.api.manual/darktable/gui/panel_hide_all/index.html
+++ b/lua.api.manual/darktable/gui/panel_hide_all/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/panel_set_size/index.html b/lua.api.manual/darktable/gui/panel_set_size/index.html
index 0fd81a4..befb4a6 100644
--- a/lua.api.manual/darktable/gui/panel_set_size/index.html
+++ b/lua.api.manual/darktable/gui/panel_set_size/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/panel_show/index.html b/lua.api.manual/darktable/gui/panel_show/index.html
index 5abaac6..caf97ca 100644
--- a/lua.api.manual/darktable/gui/panel_show/index.html
+++ b/lua.api.manual/darktable/gui/panel_show/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/panel_show_all/index.html b/lua.api.manual/darktable/gui/panel_show_all/index.html
index 665b5ea..c890a06 100644
--- a/lua.api.manual/darktable/gui/panel_show_all/index.html
+++ b/lua.api.manual/darktable/gui/panel_show_all/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/panel_visible/index.html b/lua.api.manual/darktable/gui/panel_visible/index.html
index d240d77..371bf8c 100644
--- a/lua.api.manual/darktable/gui/panel_visible/index.html
+++ b/lua.api.manual/darktable/gui/panel_visible/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/selection/index.html b/lua.api.manual/darktable/gui/selection/index.html
index e79cfc5..b7a4358 100644
--- a/lua.api.manual/darktable/gui/selection/index.html
+++ b/lua.api.manual/darktable/gui/selection/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/views/darkroom/index.html b/lua.api.manual/darktable/gui/views/darkroom/index.html
index 9532d61..f20e55d 100644
--- a/lua.api.manual/darktable/gui/views/darkroom/index.html
+++ b/lua.api.manual/darktable/gui/views/darkroom/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/views/index.html b/lua.api.manual/darktable/gui/views/index.html
index b9ade9f..e91d616 100644
--- a/lua.api.manual/darktable/gui/views/index.html
+++ b/lua.api.manual/darktable/gui/views/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/views/lighttable/index.html b/lua.api.manual/darktable/gui/views/lighttable/index.html
index 5ff3365..50f5fa3 100644
--- a/lua.api.manual/darktable/gui/views/lighttable/index.html
+++ b/lua.api.manual/darktable/gui/views/lighttable/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/views/map/index.html b/lua.api.manual/darktable/gui/views/map/index.html
index e135959..c5e5590 100644
--- a/lua.api.manual/darktable/gui/views/map/index.html
+++ b/lua.api.manual/darktable/gui/views/map/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/views/overview/index.html b/lua.api.manual/darktable/gui/views/overview/index.html
index 046c68e..e2f712a 100644
--- a/lua.api.manual/darktable/gui/views/overview/index.html
+++ b/lua.api.manual/darktable/gui/views/overview/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/views/print/index.html b/lua.api.manual/darktable/gui/views/print/index.html
index 5e2f6a7..e279f3d 100644
--- a/lua.api.manual/darktable/gui/views/print/index.html
+++ b/lua.api.manual/darktable/gui/views/print/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/views/slideshow/index.html b/lua.api.manual/darktable/gui/views/slideshow/index.html
index 903ed3c..441ff33 100644
--- a/lua.api.manual/darktable/gui/views/slideshow/index.html
+++ b/lua.api.manual/darktable/gui/views/slideshow/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/gui/views/tethering/index.html b/lua.api.manual/darktable/gui/views/tethering/index.html
index 1b1653c..f095ae0 100644
--- a/lua.api.manual/darktable/gui/views/tethering/index.html
+++ b/lua.api.manual/darktable/gui/views/tethering/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/index.html b/lua.api.manual/darktable/index.html
index fe66777..0fbfce8 100644
--- a/lua.api.manual/darktable/index.html
+++ b/lua.api.manual/darktable/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/darktable/overview/index.html b/lua.api.manual/darktable/overview/index.html
index 34fb179..265a598 100644
--- a/lua.api.manual/darktable/overview/index.html
+++ b/lua.api.manual/darktable/overview/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/darkroom-image-history-changed/index.html b/lua.api.manual/events/darkroom-image-history-changed/index.html
index d9eaa87..3d270d5 100644
--- a/lua.api.manual/events/darkroom-image-history-changed/index.html
+++ b/lua.api.manual/events/darkroom-image-history-changed/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/darkroom-image-loaded/index.html b/lua.api.manual/events/darkroom-image-loaded/index.html
index 898ed1c..d728c50 100644
--- a/lua.api.manual/events/darkroom-image-loaded/index.html
+++ b/lua.api.manual/events/darkroom-image-loaded/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/exit/index.html b/lua.api.manual/events/exit/index.html
index 0b52808..d0c2a6d 100644
--- a/lua.api.manual/events/exit/index.html
+++ b/lua.api.manual/events/exit/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/global_toolbox-grouping_toggle/index.html b/lua.api.manual/events/global_toolbox-grouping_toggle/index.html
index cbc86f2..fef51f9 100644
--- a/lua.api.manual/events/global_toolbox-grouping_toggle/index.html
+++ b/lua.api.manual/events/global_toolbox-grouping_toggle/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/global_toolbox-overlay_toggle/index.html b/lua.api.manual/events/global_toolbox-overlay_toggle/index.html
index 4aabfc1..da84bb6 100644
--- a/lua.api.manual/events/global_toolbox-overlay_toggle/index.html
+++ b/lua.api.manual/events/global_toolbox-overlay_toggle/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/index.html b/lua.api.manual/events/index.html
index f2cb36e..09d21ad 100644
--- a/lua.api.manual/events/index.html
+++ b/lua.api.manual/events/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/intermediate-export-image/index.html b/lua.api.manual/events/intermediate-export-image/index.html
index 81498dc..e141f59 100644
--- a/lua.api.manual/events/intermediate-export-image/index.html
+++ b/lua.api.manual/events/intermediate-export-image/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/mouse-over-image-changed/index.html b/lua.api.manual/events/mouse-over-image-changed/index.html
index e26c731..e8f6436 100644
--- a/lua.api.manual/events/mouse-over-image-changed/index.html
+++ b/lua.api.manual/events/mouse-over-image-changed/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/overview/index.html b/lua.api.manual/events/overview/index.html
index cd2de63..b71c501 100644
--- a/lua.api.manual/events/overview/index.html
+++ b/lua.api.manual/events/overview/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/post-import-film/index.html b/lua.api.manual/events/post-import-film/index.html
index 32d37f7..f677217 100644
--- a/lua.api.manual/events/post-import-film/index.html
+++ b/lua.api.manual/events/post-import-film/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/post-import-image/index.html b/lua.api.manual/events/post-import-image/index.html
index a7dff40..5e29a58 100644
--- a/lua.api.manual/events/post-import-image/index.html
+++ b/lua.api.manual/events/post-import-image/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/pre-import/index.html b/lua.api.manual/events/pre-import/index.html
index 8b09f0d..77a8dfd 100644
--- a/lua.api.manual/events/pre-import/index.html
+++ b/lua.api.manual/events/pre-import/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/selection-changed/index.html b/lua.api.manual/events/selection-changed/index.html
index 572d06b..bcf12ea 100644
--- a/lua.api.manual/events/selection-changed/index.html
+++ b/lua.api.manual/events/selection-changed/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/shortcut/index.html b/lua.api.manual/events/shortcut/index.html
index d244586..4150b6b 100644
--- a/lua.api.manual/events/shortcut/index.html
+++ b/lua.api.manual/events/shortcut/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/events/view-changed/index.html b/lua.api.manual/events/view-changed/index.html
index 48e981a..264ff5e 100644
--- a/lua.api.manual/events/view-changed/index.html
+++ b/lua.api.manual/events/view-changed/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/index.html b/lua.api.manual/index.html
index 69b2174..aacf415 100644
--- a/lua.api.manual/index.html
+++ b/lua.api.manual/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/_pdf_mode_t/index.html b/lua.api.manual/types/_pdf_mode_t/index.html
index 19a76b3..738de2e 100644
--- a/lua.api.manual/types/_pdf_mode_t/index.html
+++ b/lua.api.manual/types/_pdf_mode_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/_pdf_pages_t/index.html b/lua.api.manual/types/_pdf_pages_t/index.html
index 5dcab9f..229d15f 100644
--- a/lua.api.manual/types/_pdf_pages_t/index.html
+++ b/lua.api.manual/types/_pdf_pages_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/comp_type_t/index.html b/lua.api.manual/types/comp_type_t/index.html
index 9f96f3d..8b33f12 100644
--- a/lua.api.manual/types/comp_type_t/index.html
+++ b/lua.api.manual/types/comp_type_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_collection_filter_t/index.html b/lua.api.manual/types/dt_collection_filter_t/index.html
index e7d5ef6..62b1c9b 100644
--- a/lua.api.manual/types/dt_collection_filter_t/index.html
+++ b/lua.api.manual/types/dt_collection_filter_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_collection_properties_t/index.html b/lua.api.manual/types/dt_collection_properties_t/index.html
index 7d4ff9d..c9fae3c 100644
--- a/lua.api.manual/types/dt_collection_properties_t/index.html
+++ b/lua.api.manual/types/dt_collection_properties_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_collection_rating_comperator_t/index.html b/lua.api.manual/types/dt_collection_rating_comperator_t/index.html
index c879ec3..484fd46 100644
--- a/lua.api.manual/types/dt_collection_rating_comperator_t/index.html
+++ b/lua.api.manual/types/dt_collection_rating_comperator_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_collection_sort_order_t/index.html b/lua.api.manual/types/dt_collection_sort_order_t/index.html
index bd0f135..6081d56 100644
--- a/lua.api.manual/types/dt_collection_sort_order_t/index.html
+++ b/lua.api.manual/types/dt_collection_sort_order_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_collection_sort_t/index.html b/lua.api.manual/types/dt_collection_sort_t/index.html
index 749cda1..d4dfaa7 100644
--- a/lua.api.manual/types/dt_collection_sort_t/index.html
+++ b/lua.api.manual/types/dt_collection_sort_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_exr_compression_t/index.html b/lua.api.manual/types/dt_imageio_exr_compression_t/index.html
index a5c74ed..fc25590 100644
--- a/lua.api.manual/types/dt_imageio_exr_compression_t/index.html
+++ b/lua.api.manual/types/dt_imageio_exr_compression_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_j2k_format_t/index.html b/lua.api.manual/types/dt_imageio_j2k_format_t/index.html
index ed2dd3a..9931341 100644
--- a/lua.api.manual/types/dt_imageio_j2k_format_t/index.html
+++ b/lua.api.manual/types/dt_imageio_j2k_format_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_j2k_preset_t/index.html b/lua.api.manual/types/dt_imageio_j2k_preset_t/index.html
index 81b7bf3..14df061 100644
--- a/lua.api.manual/types/dt_imageio_j2k_preset_t/index.html
+++ b/lua.api.manual/types/dt_imageio_j2k_preset_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_copy/index.html b/lua.api.manual/types/dt_imageio_module_format_data_copy/index.html
index 72b7ff8..d7bd147 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_copy/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_copy/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_exr/index.html b/lua.api.manual/types/dt_imageio_module_format_data_exr/index.html
index 3803feb..4ef0f7f 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_exr/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_exr/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_j2k/index.html b/lua.api.manual/types/dt_imageio_module_format_data_j2k/index.html
index e28e0c2..3c4d83e 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_j2k/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_j2k/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_jpeg/index.html b/lua.api.manual/types/dt_imageio_module_format_data_jpeg/index.html
index 707e8ff..f32ab25 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_jpeg/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_jpeg/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_pdf/index.html b/lua.api.manual/types/dt_imageio_module_format_data_pdf/index.html
index f4075dc..457290f 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_pdf/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_pdf/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_pfm/index.html b/lua.api.manual/types/dt_imageio_module_format_data_pfm/index.html
index bb4b209..2ab0dc7 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_pfm/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_pfm/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_png/index.html b/lua.api.manual/types/dt_imageio_module_format_data_png/index.html
index e6f0085..dd1885f 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_png/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_png/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_ppm/index.html b/lua.api.manual/types/dt_imageio_module_format_data_ppm/index.html
index 7b90b75..87b5ec0 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_ppm/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_ppm/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_tiff/index.html b/lua.api.manual/types/dt_imageio_module_format_data_tiff/index.html
index 4d355ec..910fcb8 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_tiff/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_tiff/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_data_webp/index.html b/lua.api.manual/types/dt_imageio_module_format_data_webp/index.html
index a920c11..8a2a3c2 100644
--- a/lua.api.manual/types/dt_imageio_module_format_data_webp/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_data_webp/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_format_t/index.html b/lua.api.manual/types/dt_imageio_module_format_t/index.html
index 71afd9d..70a771f 100644
--- a/lua.api.manual/types/dt_imageio_module_format_t/index.html
+++ b/lua.api.manual/types/dt_imageio_module_format_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_storage_data_disk/index.html b/lua.api.manual/types/dt_imageio_module_storage_data_disk/index.html
index 0d02cf5..e098c39 100644
--- a/lua.api.manual/types/dt_imageio_module_storage_data_disk/index.html
+++ b/lua.api.manual/types/dt_imageio_module_storage_data_disk/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_storage_data_email/index.html b/lua.api.manual/types/dt_imageio_module_storage_data_email/index.html
index f2e5637..656e25a 100644
--- a/lua.api.manual/types/dt_imageio_module_storage_data_email/index.html
+++ b/lua.api.manual/types/dt_imageio_module_storage_data_email/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_storage_data_gallery/index.html b/lua.api.manual/types/dt_imageio_module_storage_data_gallery/index.html
index 87c04e6..ecd1633 100644
--- a/lua.api.manual/types/dt_imageio_module_storage_data_gallery/index.html
+++ b/lua.api.manual/types/dt_imageio_module_storage_data_gallery/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_storage_data_latex/index.html b/lua.api.manual/types/dt_imageio_module_storage_data_latex/index.html
index 860495b..467ece6 100644
--- a/lua.api.manual/types/dt_imageio_module_storage_data_latex/index.html
+++ b/lua.api.manual/types/dt_imageio_module_storage_data_latex/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_storage_data_piwigo/index.html b/lua.api.manual/types/dt_imageio_module_storage_data_piwigo/index.html
index e91b3ad..9b22a0e 100644
--- a/lua.api.manual/types/dt_imageio_module_storage_data_piwigo/index.html
+++ b/lua.api.manual/types/dt_imageio_module_storage_data_piwigo/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_imageio_module_storage_t/index.html b/lua.api.manual/types/dt_imageio_module_storage_t/index.html
index 29f1537..0b96fdd 100644
--- a/lua.api.manual/types/dt_imageio_module_storage_t/index.html
+++ b/lua.api.manual/types/dt_imageio_module_storage_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lib_collect_mode_t/index.html b/lua.api.manual/types/dt_lib_collect_mode_t/index.html
index 870d828..53c2cc6 100644
--- a/lua.api.manual/types/dt_lib_collect_mode_t/index.html
+++ b/lua.api.manual/types/dt_lib_collect_mode_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lib_collect_params_rule_t/index.html b/lua.api.manual/types/dt_lib_collect_params_rule_t/index.html
index 29e3231..d54d56e 100644
--- a/lua.api.manual/types/dt_lib_collect_params_rule_t/index.html
+++ b/lua.api.manual/types/dt_lib_collect_params_rule_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lighttable_layout_t/index.html b/lua.api.manual/types/dt_lighttable_layout_t/index.html
index f4c3662..47797b6 100644
--- a/lua.api.manual/types/dt_lighttable_layout_t/index.html
+++ b/lua.api.manual/types/dt_lighttable_layout_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_align_t/index.html b/lua.api.manual/types/dt_lua_align_t/index.html
index 1250023..5c39821 100644
--- a/lua.api.manual/types/dt_lua_align_t/index.html
+++ b/lua.api.manual/types/dt_lua_align_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_backgroundjob_t/index.html b/lua.api.manual/types/dt_lua_backgroundjob_t/index.html
index 63925d7..6434c48 100644
--- a/lua.api.manual/types/dt_lua_backgroundjob_t/index.html
+++ b/lua.api.manual/types/dt_lua_backgroundjob_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_cairo_t/index.html b/lua.api.manual/types/dt_lua_cairo_t/index.html
index 11f4328..c8045c2 100644
--- a/lua.api.manual/types/dt_lua_cairo_t/index.html
+++ b/lua.api.manual/types/dt_lua_cairo_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_ellipsize_mode_t/index.html b/lua.api.manual/types/dt_lua_ellipsize_mode_t/index.html
index 4829f8b..aa8dbc2 100644
--- a/lua.api.manual/types/dt_lua_ellipsize_mode_t/index.html
+++ b/lua.api.manual/types/dt_lua_ellipsize_mode_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_film_t/index.html b/lua.api.manual/types/dt_lua_film_t/index.html
index ba90e2f..4cc7e79 100644
--- a/lua.api.manual/types/dt_lua_film_t/index.html
+++ b/lua.api.manual/types/dt_lua_film_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_image_t/index.html b/lua.api.manual/types/dt_lua_image_t/index.html
index ce1f8e2..26c2cae 100644
--- a/lua.api.manual/types/dt_lua_image_t/index.html
+++ b/lua.api.manual/types/dt_lua_image_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_lib_t/index.html b/lua.api.manual/types/dt_lua_lib_t/index.html
index d008229..7aea419 100644
--- a/lua.api.manual/types/dt_lua_lib_t/index.html
+++ b/lua.api.manual/types/dt_lua_lib_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_orientation_t/index.html b/lua.api.manual/types/dt_lua_orientation_t/index.html
index 7c8297f..994fbbe 100644
--- a/lua.api.manual/types/dt_lua_orientation_t/index.html
+++ b/lua.api.manual/types/dt_lua_orientation_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_snapshot_t/index.html b/lua.api.manual/types/dt_lua_snapshot_t/index.html
index 8fd165d..50aaa7d 100644
--- a/lua.api.manual/types/dt_lua_snapshot_t/index.html
+++ b/lua.api.manual/types/dt_lua_snapshot_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_tag_t/index.html b/lua.api.manual/types/dt_lua_tag_t/index.html
index 90cab06..75820a1 100644
--- a/lua.api.manual/types/dt_lua_tag_t/index.html
+++ b/lua.api.manual/types/dt_lua_tag_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_lua_view_t/index.html b/lua.api.manual/types/dt_lua_view_t/index.html
index 282ce37..5669128 100644
--- a/lua.api.manual/types/dt_lua_view_t/index.html
+++ b/lua.api.manual/types/dt_lua_view_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_pdf_stream_encoder_t/index.html b/lua.api.manual/types/dt_pdf_stream_encoder_t/index.html
index 9e97557..42a360e 100644
--- a/lua.api.manual/types/dt_pdf_stream_encoder_t/index.html
+++ b/lua.api.manual/types/dt_pdf_stream_encoder_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_style_item_t/index.html b/lua.api.manual/types/dt_style_item_t/index.html
index d776967..ea39249 100644
--- a/lua.api.manual/types/dt_style_item_t/index.html
+++ b/lua.api.manual/types/dt_style_item_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_style_t/index.html b/lua.api.manual/types/dt_style_t/index.html
index 5a2f339..1b80213 100644
--- a/lua.api.manual/types/dt_style_t/index.html
+++ b/lua.api.manual/types/dt_style_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_ui_container_t/index.html b/lua.api.manual/types/dt_ui_container_t/index.html
index efc3e07..d3c3872 100644
--- a/lua.api.manual/types/dt_ui_container_t/index.html
+++ b/lua.api.manual/types/dt_ui_container_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/dt_ui_panel_t/index.html b/lua.api.manual/types/dt_ui_panel_t/index.html
index f73e6ef..024d2f2 100644
--- a/lua.api.manual/types/dt_ui_panel_t/index.html
+++ b/lua.api.manual/types/dt_ui_panel_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/hint_t/index.html b/lua.api.manual/types/hint_t/index.html
index f25eede..a549093 100644
--- a/lua.api.manual/types/hint_t/index.html
+++ b/lua.api.manual/types/hint_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/index.html b/lua.api.manual/types/index.html
index 4183704..f073444 100644
--- a/lua.api.manual/types/index.html
+++ b/lua.api.manual/types/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_box/index.html b/lua.api.manual/types/lua_box/index.html
index 8cb794b..7aca568 100644
--- a/lua.api.manual/types/lua_box/index.html
+++ b/lua.api.manual/types/lua_box/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_button/index.html b/lua.api.manual/types/lua_button/index.html
index 78e7467..2852202 100644
--- a/lua.api.manual/types/lua_button/index.html
+++ b/lua.api.manual/types/lua_button/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_check_button/index.html b/lua.api.manual/types/lua_check_button/index.html
index 817d730..a1165a0 100644
--- a/lua.api.manual/types/lua_check_button/index.html
+++ b/lua.api.manual/types/lua_check_button/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_combobox/index.html b/lua.api.manual/types/lua_combobox/index.html
index 06f5281..d9b7ecc 100644
--- a/lua.api.manual/types/lua_combobox/index.html
+++ b/lua.api.manual/types/lua_combobox/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_container/index.html b/lua.api.manual/types/lua_container/index.html
index 8adbb85..3aeb07e 100644
--- a/lua.api.manual/types/lua_container/index.html
+++ b/lua.api.manual/types/lua_container/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_entry/index.html b/lua.api.manual/types/lua_entry/index.html
index 184bacc..9c11db3 100644
--- a/lua.api.manual/types/lua_entry/index.html
+++ b/lua.api.manual/types/lua_entry/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_file_chooser_button/index.html b/lua.api.manual/types/lua_file_chooser_button/index.html
index 6df883c..8efb658 100644
--- a/lua.api.manual/types/lua_file_chooser_button/index.html
+++ b/lua.api.manual/types/lua_file_chooser_button/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_label/index.html b/lua.api.manual/types/lua_label/index.html
index da8e0fb..b395e84 100644
--- a/lua.api.manual/types/lua_label/index.html
+++ b/lua.api.manual/types/lua_label/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_os_type/index.html b/lua.api.manual/types/lua_os_type/index.html
index 5ea45c9..cdd57ac 100644
--- a/lua.api.manual/types/lua_os_type/index.html
+++ b/lua.api.manual/types/lua_os_type/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_pref_type/index.html b/lua.api.manual/types/lua_pref_type/index.html
index 548d2a8..93d41e5 100644
--- a/lua.api.manual/types/lua_pref_type/index.html
+++ b/lua.api.manual/types/lua_pref_type/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_section_label/index.html b/lua.api.manual/types/lua_section_label/index.html
index ee51fac..857a935 100644
--- a/lua.api.manual/types/lua_section_label/index.html
+++ b/lua.api.manual/types/lua_section_label/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_separator/index.html b/lua.api.manual/types/lua_separator/index.html
index 452eb52..9634172 100644
--- a/lua.api.manual/types/lua_separator/index.html
+++ b/lua.api.manual/types/lua_separator/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_slider/index.html b/lua.api.manual/types/lua_slider/index.html
index e3d3c0f..99a9694 100644
--- a/lua.api.manual/types/lua_slider/index.html
+++ b/lua.api.manual/types/lua_slider/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_stack/index.html b/lua.api.manual/types/lua_stack/index.html
index 154f3c0..34c6df9 100644
--- a/lua.api.manual/types/lua_stack/index.html
+++ b/lua.api.manual/types/lua_stack/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_text_view/index.html b/lua.api.manual/types/lua_text_view/index.html
index 79109ba..20e8153 100644
--- a/lua.api.manual/types/lua_text_view/index.html
+++ b/lua.api.manual/types/lua_text_view/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/lua_widget/index.html b/lua.api.manual/types/lua_widget/index.html
index 4d116e0..32f4149 100644
--- a/lua.api.manual/types/lua_widget/index.html
+++ b/lua.api.manual/types/lua_widget/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/overview/index.html b/lua.api.manual/types/overview/index.html
index afdcd2a..47ae0c1 100644
--- a/lua.api.manual/types/overview/index.html
+++ b/lua.api.manual/types/overview/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/types/snapshot_direction_t/index.html b/lua.api.manual/types/snapshot_direction_t/index.html
index a066b34..9eea259 100644
--- a/lua.api.manual/types/snapshot_direction_t/index.html
+++ b/lua.api.manual/types/snapshot_direction_t/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.api.manual/version/index.html b/lua.api.manual/version/index.html
index 26b562b..04af172 100644
--- a/lua.api.manual/version/index.html
+++ b/lua.api.manual/version/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.debug/details/index.html b/lua.scripts.api.manual/dtutils.debug/details/index.html
index e2fedd0..d5d834f 100644
--- a/lua.scripts.api.manual/dtutils.debug/details/index.html
+++ b/lua.scripts.api.manual/dtutils.debug/details/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.debug/dprint/index.html b/lua.scripts.api.manual/dtutils.debug/dprint/index.html
index e37dbdf..f89a2f8 100644
--- a/lua.scripts.api.manual/dtutils.debug/dprint/index.html
+++ b/lua.scripts.api.manual/dtutils.debug/dprint/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.debug/index.html b/lua.scripts.api.manual/dtutils.debug/index.html
index 3b4776e..ec34bff 100644
--- a/lua.scripts.api.manual/dtutils.debug/index.html
+++ b/lua.scripts.api.manual/dtutils.debug/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.debug/new_tracepoint/index.html b/lua.scripts.api.manual/dtutils.debug/new_tracepoint/index.html
index 0b8c6c4..93238ad 100644
--- a/lua.scripts.api.manual/dtutils.debug/new_tracepoint/index.html
+++ b/lua.scripts.api.manual/dtutils.debug/new_tracepoint/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.debug/terse_dump/index.html b/lua.scripts.api.manual/dtutils.debug/terse_dump/index.html
index c3aace8..e5d8f74 100644
--- a/lua.scripts.api.manual/dtutils.debug/terse_dump/index.html
+++ b/lua.scripts.api.manual/dtutils.debug/terse_dump/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.debug/tracepoint/index.html b/lua.scripts.api.manual/dtutils.debug/tracepoint/index.html
index d1eff8c..93de392 100644
--- a/lua.scripts.api.manual/dtutils.debug/tracepoint/index.html
+++ b/lua.scripts.api.manual/dtutils.debug/tracepoint/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/index.html b/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/index.html
index 8888567..b2ccca6 100644
--- a/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/index.html
+++ b/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/check_if_file_exists/index.html b/lua.scripts.api.manual/dtutils.file/check_if_file_exists/index.html
index a73727d..e3d482b 100644
--- a/lua.scripts.api.manual/dtutils.file/check_if_file_exists/index.html
+++ b/lua.scripts.api.manual/dtutils.file/check_if_file_exists/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/chop_filetype/index.html b/lua.scripts.api.manual/dtutils.file/chop_filetype/index.html
index 32aaeeb..d8f0663 100644
--- a/lua.scripts.api.manual/dtutils.file/chop_filetype/index.html
+++ b/lua.scripts.api.manual/dtutils.file/chop_filetype/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/create_unique_filename/index.html b/lua.scripts.api.manual/dtutils.file/create_unique_filename/index.html
index c246c85..8a0d307 100644
--- a/lua.scripts.api.manual/dtutils.file/create_unique_filename/index.html
+++ b/lua.scripts.api.manual/dtutils.file/create_unique_filename/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/details/index.html b/lua.scripts.api.manual/dtutils.file/details/index.html
index 42838a8..58d8063 100644
--- a/lua.scripts.api.manual/dtutils.file/details/index.html
+++ b/lua.scripts.api.manual/dtutils.file/details/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/executable_path_widget/index.html b/lua.scripts.api.manual/dtutils.file/executable_path_widget/index.html
index b5bd57c..dbb0339 100644
--- a/lua.scripts.api.manual/dtutils.file/executable_path_widget/index.html
+++ b/lua.scripts.api.manual/dtutils.file/executable_path_widget/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/file_copy/index.html b/lua.scripts.api.manual/dtutils.file/file_copy/index.html
index bbea3c5..b539c4e 100644
--- a/lua.scripts.api.manual/dtutils.file/file_copy/index.html
+++ b/lua.scripts.api.manual/dtutils.file/file_copy/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/file_move/index.html b/lua.scripts.api.manual/dtutils.file/file_move/index.html
index c7cc1e7..58133ff 100644
--- a/lua.scripts.api.manual/dtutils.file/file_move/index.html
+++ b/lua.scripts.api.manual/dtutils.file/file_move/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/filename_increment/index.html b/lua.scripts.api.manual/dtutils.file/filename_increment/index.html
index 758c312..73ebf1c 100644
--- a/lua.scripts.api.manual/dtutils.file/filename_increment/index.html
+++ b/lua.scripts.api.manual/dtutils.file/filename_increment/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/get_basename/index.html b/lua.scripts.api.manual/dtutils.file/get_basename/index.html
index a69cecd..4d718aa 100644
--- a/lua.scripts.api.manual/dtutils.file/get_basename/index.html
+++ b/lua.scripts.api.manual/dtutils.file/get_basename/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/get_executable_path_preference/index.html b/lua.scripts.api.manual/dtutils.file/get_executable_path_preference/index.html
index 4408846..4c3889e 100644
--- a/lua.scripts.api.manual/dtutils.file/get_executable_path_preference/index.html
+++ b/lua.scripts.api.manual/dtutils.file/get_executable_path_preference/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/get_filename/index.html b/lua.scripts.api.manual/dtutils.file/get_filename/index.html
index fde659c..b9a8e11 100644
--- a/lua.scripts.api.manual/dtutils.file/get_filename/index.html
+++ b/lua.scripts.api.manual/dtutils.file/get_filename/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/get_filetype/index.html b/lua.scripts.api.manual/dtutils.file/get_filetype/index.html
index 20da3b3..39d0da6 100644
--- a/lua.scripts.api.manual/dtutils.file/get_filetype/index.html
+++ b/lua.scripts.api.manual/dtutils.file/get_filetype/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/get_path/index.html b/lua.scripts.api.manual/dtutils.file/get_path/index.html
index 4a7d48e..a1ebda8 100644
--- a/lua.scripts.api.manual/dtutils.file/get_path/index.html
+++ b/lua.scripts.api.manual/dtutils.file/get_path/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/index.html b/lua.scripts.api.manual/dtutils.file/index.html
index 7d1bf23..3f93b65 100644
--- a/lua.scripts.api.manual/dtutils.file/index.html
+++ b/lua.scripts.api.manual/dtutils.file/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/mkdir/index.html b/lua.scripts.api.manual/dtutils.file/mkdir/index.html
index bf9bbf3..196d6df 100644
--- a/lua.scripts.api.manual/dtutils.file/mkdir/index.html
+++ b/lua.scripts.api.manual/dtutils.file/mkdir/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/rmdir/index.html b/lua.scripts.api.manual/dtutils.file/rmdir/index.html
index f21201d..a869a7a 100644
--- a/lua.scripts.api.manual/dtutils.file/rmdir/index.html
+++ b/lua.scripts.api.manual/dtutils.file/rmdir/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/sanitize_filename/index.html b/lua.scripts.api.manual/dtutils.file/sanitize_filename/index.html
index f97e7e5..6c679ce 100644
--- a/lua.scripts.api.manual/dtutils.file/sanitize_filename/index.html
+++ b/lua.scripts.api.manual/dtutils.file/sanitize_filename/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/set_executable_path_preference/index.html b/lua.scripts.api.manual/dtutils.file/set_executable_path_preference/index.html
index 12e5918..5cdba25 100644
--- a/lua.scripts.api.manual/dtutils.file/set_executable_path_preference/index.html
+++ b/lua.scripts.api.manual/dtutils.file/set_executable_path_preference/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/split_filepath/index.html b/lua.scripts.api.manual/dtutils.file/split_filepath/index.html
index de4422b..c166b3e 100644
--- a/lua.scripts.api.manual/dtutils.file/split_filepath/index.html
+++ b/lua.scripts.api.manual/dtutils.file/split_filepath/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.file/test_file/index.html b/lua.scripts.api.manual/dtutils.file/test_file/index.html
index e473318..d477c8e 100644
--- a/lua.scripts.api.manual/dtutils.file/test_file/index.html
+++ b/lua.scripts.api.manual/dtutils.file/test_file/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.log/caller/index.html b/lua.scripts.api.manual/dtutils.log/caller/index.html
index 6b11ccc..07d7558 100644
--- a/lua.scripts.api.manual/dtutils.log/caller/index.html
+++ b/lua.scripts.api.manual/dtutils.log/caller/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.log/details/index.html b/lua.scripts.api.manual/dtutils.log/details/index.html
index 5aa36cd..9e8753d 100644
--- a/lua.scripts.api.manual/dtutils.log/details/index.html
+++ b/lua.scripts.api.manual/dtutils.log/details/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.log/engine/index.html b/lua.scripts.api.manual/dtutils.log/engine/index.html
index 6ffa508..c3dfe88 100644
--- a/lua.scripts.api.manual/dtutils.log/engine/index.html
+++ b/lua.scripts.api.manual/dtutils.log/engine/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.log/index.html b/lua.scripts.api.manual/dtutils.log/index.html
index 1ac20d9..b03bea2 100644
--- a/lua.scripts.api.manual/dtutils.log/index.html
+++ b/lua.scripts.api.manual/dtutils.log/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.log/log_level/index.html b/lua.scripts.api.manual/dtutils.log/log_level/index.html
index 2832cf5..60e247a 100644
--- a/lua.scripts.api.manual/dtutils.log/log_level/index.html
+++ b/lua.scripts.api.manual/dtutils.log/log_level/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.log/msg/index.html b/lua.scripts.api.manual/dtutils.log/msg/index.html
index e2de12e..a4a69b5 100644
--- a/lua.scripts.api.manual/dtutils.log/msg/index.html
+++ b/lua.scripts.api.manual/dtutils.log/msg/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.string/details/index.html b/lua.scripts.api.manual/dtutils.string/details/index.html
index 3545e1b..a98e9f6 100644
--- a/lua.scripts.api.manual/dtutils.string/details/index.html
+++ b/lua.scripts.api.manual/dtutils.string/details/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.string/escape_xml_characters/index.html b/lua.scripts.api.manual/dtutils.string/escape_xml_characters/index.html
index 6f90e9e..7ffea1b 100644
--- a/lua.scripts.api.manual/dtutils.string/escape_xml_characters/index.html
+++ b/lua.scripts.api.manual/dtutils.string/escape_xml_characters/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.string/index.html b/lua.scripts.api.manual/dtutils.string/index.html
index fd1b088..154d078 100644
--- a/lua.scripts.api.manual/dtutils.string/index.html
+++ b/lua.scripts.api.manual/dtutils.string/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.string/is_not_sanitized/index.html b/lua.scripts.api.manual/dtutils.string/is_not_sanitized/index.html
index 2263242..c448855 100644
--- a/lua.scripts.api.manual/dtutils.string/is_not_sanitized/index.html
+++ b/lua.scripts.api.manual/dtutils.string/is_not_sanitized/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.string/sanitize/index.html b/lua.scripts.api.manual/dtutils.string/sanitize/index.html
index 27a1e9b..63d23f9 100644
--- a/lua.scripts.api.manual/dtutils.string/sanitize/index.html
+++ b/lua.scripts.api.manual/dtutils.string/sanitize/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.string/sanitize_lua/index.html b/lua.scripts.api.manual/dtutils.string/sanitize_lua/index.html
index 04d185e..45fb9c1 100644
--- a/lua.scripts.api.manual/dtutils.string/sanitize_lua/index.html
+++ b/lua.scripts.api.manual/dtutils.string/sanitize_lua/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.string/strip_accents/index.html b/lua.scripts.api.manual/dtutils.string/strip_accents/index.html
index f35d4e8..ebdd99c 100644
--- a/lua.scripts.api.manual/dtutils.string/strip_accents/index.html
+++ b/lua.scripts.api.manual/dtutils.string/strip_accents/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.string/urlencode/index.html b/lua.scripts.api.manual/dtutils.string/urlencode/index.html
index 1c1a2f0..200086f 100644
--- a/lua.scripts.api.manual/dtutils.string/urlencode/index.html
+++ b/lua.scripts.api.manual/dtutils.string/urlencode/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.system/details/index.html b/lua.scripts.api.manual/dtutils.system/details/index.html
index 64bf84c..43118ee 100644
--- a/lua.scripts.api.manual/dtutils.system/details/index.html
+++ b/lua.scripts.api.manual/dtutils.system/details/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.system/external_command/index.html b/lua.scripts.api.manual/dtutils.system/external_command/index.html
index a431eba..0833d2b 100644
--- a/lua.scripts.api.manual/dtutils.system/external_command/index.html
+++ b/lua.scripts.api.manual/dtutils.system/external_command/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.system/index.html b/lua.scripts.api.manual/dtutils.system/index.html
index 26963e3..cc596d4 100644
--- a/lua.scripts.api.manual/dtutils.system/index.html
+++ b/lua.scripts.api.manual/dtutils.system/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.system/launch_default_app/index.html b/lua.scripts.api.manual/dtutils.system/launch_default_app/index.html
index cc96a05..f47dcca 100644
--- a/lua.scripts.api.manual/dtutils.system/launch_default_app/index.html
+++ b/lua.scripts.api.manual/dtutils.system/launch_default_app/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils.system/windows_command/index.html b/lua.scripts.api.manual/dtutils.system/windows_command/index.html
index 4a040c9..44ae695 100644
--- a/lua.scripts.api.manual/dtutils.system/windows_command/index.html
+++ b/lua.scripts.api.manual/dtutils.system/windows_command/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/check_min_api_version/index.html b/lua.scripts.api.manual/dtutils/check_min_api_version/index.html
index 95590eb..052752c 100644
--- a/lua.scripts.api.manual/dtutils/check_min_api_version/index.html
+++ b/lua.scripts.api.manual/dtutils/check_min_api_version/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/check_os/index.html b/lua.scripts.api.manual/dtutils/check_os/index.html
index fbb9420..18680bc 100644
--- a/lua.scripts.api.manual/dtutils/check_os/index.html
+++ b/lua.scripts.api.manual/dtutils/check_os/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/deprecated/index.html b/lua.scripts.api.manual/dtutils/deprecated/index.html
index ef872c2..668c8a6 100644
--- a/lua.scripts.api.manual/dtutils/deprecated/index.html
+++ b/lua.scripts.api.manual/dtutils/deprecated/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/details/index.html b/lua.scripts.api.manual/dtutils/details/index.html
index 54a6aac..f97065a 100644
--- a/lua.scripts.api.manual/dtutils/details/index.html
+++ b/lua.scripts.api.manual/dtutils/details/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/find_image_by_id/index.html b/lua.scripts.api.manual/dtutils/find_image_by_id/index.html
index 5d2122c..7c68f25 100644
--- a/lua.scripts.api.manual/dtutils/find_image_by_id/index.html
+++ b/lua.scripts.api.manual/dtutils/find_image_by_id/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/index.html b/lua.scripts.api.manual/dtutils/index.html
index d249510..b8d9894 100644
--- a/lua.scripts.api.manual/dtutils/index.html
+++ b/lua.scripts.api.manual/dtutils/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/join/index.html b/lua.scripts.api.manual/dtutils/join/index.html
index eb3e4e4..d28ef00 100644
--- a/lua.scripts.api.manual/dtutils/join/index.html
+++ b/lua.scripts.api.manual/dtutils/join/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/prequire/index.html b/lua.scripts.api.manual/dtutils/prequire/index.html
index dfd2a9e..1afcd3b 100644
--- a/lua.scripts.api.manual/dtutils/prequire/index.html
+++ b/lua.scripts.api.manual/dtutils/prequire/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/spairs/index.html b/lua.scripts.api.manual/dtutils/spairs/index.html
index ffdc068..969a5d7 100644
--- a/lua.scripts.api.manual/dtutils/spairs/index.html
+++ b/lua.scripts.api.manual/dtutils/spairs/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/dtutils/split/index.html b/lua.scripts.api.manual/dtutils/split/index.html
index 3dd3bfd..9b7c884 100644
--- a/lua.scripts.api.manual/dtutils/split/index.html
+++ b/lua.scripts.api.manual/dtutils/split/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.api.manual/index.html b/lua.scripts.api.manual/index.html
index e2351e3..6b90388 100644
--- a/lua.scripts.api.manual/index.html
+++ b/lua.scripts.api.manual/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/index.html b/lua.scripts.manual/index.html
index 1904d86..8a37cd4 100644
--- a/lua.scripts.manual/index.html
+++ b/lua.scripts.manual/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/installation/index.html b/lua.scripts.manual/installation/index.html
index 1c1690a..0497d7b 100644
--- a/lua.scripts.manual/installation/index.html
+++ b/lua.scripts.manual/installation/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/overview/index.html b/lua.scripts.manual/overview/index.html
index 1fd2b2b..54c73ed 100644
--- a/lua.scripts.manual/overview/index.html
+++ b/lua.scripts.manual/overview/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/autogrouper/index.html b/lua.scripts.manual/scripts/contrib/autogrouper/index.html
index 4178f6c..c3918fe 100644
--- a/lua.scripts.manual/scripts/contrib/autogrouper/index.html
+++ b/lua.scripts.manual/scripts/contrib/autogrouper/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/autostyle/index.html b/lua.scripts.manual/scripts/contrib/autostyle/index.html
index 004154d..b777496 100644
--- a/lua.scripts.manual/scripts/contrib/autostyle/index.html
+++ b/lua.scripts.manual/scripts/contrib/autostyle/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/clear_gps/index.html b/lua.scripts.manual/scripts/contrib/clear_gps/index.html
index e586960..86ac0d1 100644
--- a/lua.scripts.manual/scripts/contrib/clear_gps/index.html
+++ b/lua.scripts.manual/scripts/contrib/clear_gps/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/collecthelper/index.html b/lua.scripts.manual/scripts/contrib/collecthelper/index.html
index a41f2c5..7c5c0b8 100644
--- a/lua.scripts.manual/scripts/contrib/collecthelper/index.html
+++ b/lua.scripts.manual/scripts/contrib/collecthelper/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags/index.html b/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags/index.html
index c507599..14dff3e 100644
--- a/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags/index.html
+++ b/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/cr2hdr/index.html b/lua.scripts.manual/scripts/contrib/cr2hdr/index.html
index 576edbd..f337174 100644
--- a/lua.scripts.manual/scripts/contrib/cr2hdr/index.html
+++ b/lua.scripts.manual/scripts/contrib/cr2hdr/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/enfuseadvanced/index.html b/lua.scripts.manual/scripts/contrib/enfuseadvanced/index.html
index d183ef8..1980238 100644
--- a/lua.scripts.manual/scripts/contrib/enfuseadvanced/index.html
+++ b/lua.scripts.manual/scripts/contrib/enfuseadvanced/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/exportlut/index.html b/lua.scripts.manual/scripts/contrib/exportlut/index.html
index 58f1697..e8b249b 100644
--- a/lua.scripts.manual/scripts/contrib/exportlut/index.html
+++ b/lua.scripts.manual/scripts/contrib/exportlut/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/ext_editor/index.html b/lua.scripts.manual/scripts/contrib/ext_editor/index.html
index ca64ec4..4f42bdf 100644
--- a/lua.scripts.manual/scripts/contrib/ext_editor/index.html
+++ b/lua.scripts.manual/scripts/contrib/ext_editor/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/face_recognition/index.html b/lua.scripts.manual/scripts/contrib/face_recognition/index.html
index e9f9d52..2bd65a3 100644
--- a/lua.scripts.manual/scripts/contrib/face_recognition/index.html
+++ b/lua.scripts.manual/scripts/contrib/face_recognition/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/fujifilm_dynamic_range/index.html b/lua.scripts.manual/scripts/contrib/fujifilm_dynamic_range/index.html
index c204a0c..13a5dd2 100644
--- a/lua.scripts.manual/scripts/contrib/fujifilm_dynamic_range/index.html
+++ b/lua.scripts.manual/scripts/contrib/fujifilm_dynamic_range/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/fujifilm_ratings/index.html b/lua.scripts.manual/scripts/contrib/fujifilm_ratings/index.html
index d31c881..6479ac9 100644
--- a/lua.scripts.manual/scripts/contrib/fujifilm_ratings/index.html
+++ b/lua.scripts.manual/scripts/contrib/fujifilm_ratings/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/geojson_export/index.html b/lua.scripts.manual/scripts/contrib/geojson_export/index.html
index c9a1aea..62d85d9 100644
--- a/lua.scripts.manual/scripts/contrib/geojson_export/index.html
+++ b/lua.scripts.manual/scripts/contrib/geojson_export/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/geotoolbox/index.html b/lua.scripts.manual/scripts/contrib/geotoolbox/index.html
index b26128d..830b709 100644
--- a/lua.scripts.manual/scripts/contrib/geotoolbox/index.html
+++ b/lua.scripts.manual/scripts/contrib/geotoolbox/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/gimp/index.html b/lua.scripts.manual/scripts/contrib/gimp/index.html
index d0289df..110564d 100644
--- a/lua.scripts.manual/scripts/contrib/gimp/index.html
+++ b/lua.scripts.manual/scripts/contrib/gimp/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/gpx_export/index.html b/lua.scripts.manual/scripts/contrib/gpx_export/index.html
index dc765ee..6100d84 100644
--- a/lua.scripts.manual/scripts/contrib/gpx_export/index.html
+++ b/lua.scripts.manual/scripts/contrib/gpx_export/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/hdrmerge/index.html b/lua.scripts.manual/scripts/contrib/hdrmerge/index.html
index 75c3454..67d7b3b 100644
--- a/lua.scripts.manual/scripts/contrib/hdrmerge/index.html
+++ b/lua.scripts.manual/scripts/contrib/hdrmerge/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/hugin/index.html b/lua.scripts.manual/scripts/contrib/hugin/index.html
index f7d338e..bfea866 100644
--- a/lua.scripts.manual/scripts/contrib/hugin/index.html
+++ b/lua.scripts.manual/scripts/contrib/hugin/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/image_stack/index.html b/lua.scripts.manual/scripts/contrib/image_stack/index.html
index 2fdc8ea..f175d53 100644
--- a/lua.scripts.manual/scripts/contrib/image_stack/index.html
+++ b/lua.scripts.manual/scripts/contrib/image_stack/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/image_time/index.html b/lua.scripts.manual/scripts/contrib/image_time/index.html
index 5202dc9..8c47177 100644
--- a/lua.scripts.manual/scripts/contrib/image_time/index.html
+++ b/lua.scripts.manual/scripts/contrib/image_time/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/index.html b/lua.scripts.manual/scripts/contrib/index.html
index 9ceefd2..d50f1bb 100644
--- a/lua.scripts.manual/scripts/contrib/index.html
+++ b/lua.scripts.manual/scripts/contrib/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
@@ -3327,6 +3337,13 @@
 		    rate_group
 		</span>
 		
+	    </a>
+        </li><li>
+            <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/">
+		<span>
+		    rename_images
+		</span>
+		
 	    </a>
         </li><li>
             <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/">
diff --git a/lua.scripts.manual/scripts/contrib/index.xml b/lua.scripts.manual/scripts/contrib/index.xml
index d8c94fe..c4792af 100644
--- a/lua.scripts.manual/scripts/contrib/index.xml
+++ b/lua.scripts.manual/scripts/contrib/index.xml
@@ -338,6 +338,17 @@ I use the following shortcuts:
  Reject group: Ctrl+R Rate group 1: Ctrl+1 Rate group 2: Ctrl+2 Rate group 3: Ctrl+3 Rate group 4: Ctrl+4 Rate group 5: Ctrl+5 Rate group 0: Ctrl+0  🔗Additional Software Required 🔗Limitations 🔗Author Dom H - dom@hxy.</description>
     </item>
     
+    <item>
+      <title>rename_images</title>
+      <link>https://darktable-org.github.io/luadocs/lua.scripts.manual/scripts/contrib/rename_images/</link>
+      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
+      
+      <guid>https://darktable-org.github.io/luadocs/lua.scripts.manual/scripts/contrib/rename_images/</guid>
+      <description>🔗Name rename_images.lua - rename one or more image files
+🔗Description Rename an image or images according to a pattern built by the user. It is possible to specify a different directory in the rename pattern, which will result in a move as well as a rename. The database will be updated to reflect the new name/location of the image.
+🔗Usage  require this script from your luarc file or start it from script_manager select an image or images enter a renaming pattern click the button to rename the files  🔗Additional Software Required 🔗Limitations 🔗Author Bill Ferguson - wpferguson@gmail.</description>
+    </item>
+    
     <item>
       <title>rename_tags</title>
       <link>https://darktable-org.github.io/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/</link>
diff --git a/lua.scripts.manual/scripts/contrib/kml_export/index.html b/lua.scripts.manual/scripts/contrib/kml_export/index.html
index d776dd8..d472454 100644
--- a/lua.scripts.manual/scripts/contrib/kml_export/index.html
+++ b/lua.scripts.manual/scripts/contrib/kml_export/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/labelstotags/index.html b/lua.scripts.manual/scripts/contrib/labelstotags/index.html
index ba66d0e..659934d 100644
--- a/lua.scripts.manual/scripts/contrib/labelstotags/index.html
+++ b/lua.scripts.manual/scripts/contrib/labelstotags/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/openinexplorer/index.html b/lua.scripts.manual/scripts/contrib/openinexplorer/index.html
index a4909a3..969deac 100644
--- a/lua.scripts.manual/scripts/contrib/openinexplorer/index.html
+++ b/lua.scripts.manual/scripts/contrib/openinexplorer/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/passport_guide/index.html b/lua.scripts.manual/scripts/contrib/passport_guide/index.html
index ed24daa..93b30da 100644
--- a/lua.scripts.manual/scripts/contrib/passport_guide/index.html
+++ b/lua.scripts.manual/scripts/contrib/passport_guide/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/pdf_slideshow/index.html b/lua.scripts.manual/scripts/contrib/pdf_slideshow/index.html
index affcb3e..668ebb0 100644
--- a/lua.scripts.manual/scripts/contrib/pdf_slideshow/index.html
+++ b/lua.scripts.manual/scripts/contrib/pdf_slideshow/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/photils/index.html b/lua.scripts.manual/scripts/contrib/photils/index.html
index 73d8417..1af8a5c 100644
--- a/lua.scripts.manual/scripts/contrib/photils/index.html
+++ b/lua.scripts.manual/scripts/contrib/photils/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/quicktag/index.html b/lua.scripts.manual/scripts/contrib/quicktag/index.html
index 3ae47e9..4c94dbd 100644
--- a/lua.scripts.manual/scripts/contrib/quicktag/index.html
+++ b/lua.scripts.manual/scripts/contrib/quicktag/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/rate_group/index.html b/lua.scripts.manual/scripts/contrib/rate_group/index.html
index a035fc0..08e29ad 100644
--- a/lua.scripts.manual/scripts/contrib/rate_group/index.html
+++ b/lua.scripts.manual/scripts/contrib/rate_group/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
@@ -3124,7 +3134,7 @@
     </div>
     <div class="col-6">
     
-	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="prev">rename_tags &gt;</a>
+	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="prev">rename_images &gt;</a>
 	
     </div>
 </div>
@@ -3174,7 +3184,7 @@ like the below:</p>
     </div>
     <div class="col-6">
     
-	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="prev">rename_tags &gt;</a>
+	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="prev">rename_images &gt;</a>
 	
     </div>
 </div>
diff --git a/lua.scripts.manual/scripts/contrib/rename-tags/index.html b/lua.scripts.manual/scripts/contrib/rename-tags/index.html
index 2f124a4..08711c2 100644
--- a/lua.scripts.manual/scripts/contrib/rename-tags/index.html
+++ b/lua.scripts.manual/scripts/contrib/rename-tags/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class=" active">
           rename_tags
       </a>
@@ -3119,7 +3129,7 @@
 <div class="prev-next row">
     <div class="col-6">
     
-	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rate_group/" class="next">&lt; rate_group</a>
+	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="next">&lt; rename_images</a>
 	
     </div>
     <div class="col-6">
@@ -3162,7 +3172,7 @@ Bill Ferguson - <a href="mailto:wpferguson@gmail.com">wpferguson@gmail.com</a></
 <div class="prev-next row">
     <div class="col-6">
     
-	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rate_group/" class="next">&lt; rate_group</a>
+	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="next">&lt; rename_images</a>
 	
     </div>
     <div class="col-6">
diff --git a/lua.scripts.manual/scripts/contrib/rename_images/index.html b/lua.scripts.manual/scripts/contrib/rename_images/index.html
new file mode 100644
index 0000000..87d35bf
--- /dev/null
+++ b/lua.scripts.manual/scripts/contrib/rename_images/index.html
@@ -0,0 +1,3253 @@
+<!doctype html>
+<html lang="en">
+    <head>
+      <meta charset="utf-8">
+<meta http-equiv="x-ua-compatible" content="ie=edge">
+<title>darktable lua documentation - rename_images</title>
+<meta name="description" content="">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+
+
+
+
+
+
+
+
+      <link rel="stylesheet" href="/luadocs/css/style.min.ba92c80559309ba478d194c801c44249279ccb7ae545500013276e3d02b75586.css">
+      
+
+<script src="/luadocs/js/jquery.js"></script>
+<script src="/luadocs/js/popper.js" type="module"></script>
+<script src="/luadocs/js/bootstrap.js"></script>
+<script src="/luadocs/js/lunr.js"></script>
+<script src="/luadocs/js/app.js"></script>
+
+
+    </head>
+    <body>
+        
+
+        <header class="navbar navbar-expand-lg sticky-top  navbar-dark bg-dark">
+   <a class="navbar-brand" href="/luadocs" rel="home" title="darktable lua documentation">
+	darktable lua documentation
+    </a>
+    <button class="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarSupportedContent" aria-controls="navbarSupportedContent" aria-expanded="false" aria-label="Toggle navigation">
+        <span class="navbar-toggler-icon"></span>
+    </button>
+
+    <div class="collapse navbar-collapse" id="navbarSupportedContent">
+        <ul class="navbar-nav ml-auto">
+	    
+	</ul>    
+        <ul>
+           <form class="form-inline my-2 my-lg-0">
+                <input id="search-input" class="form-control mr-sm-2" type="search" placeholder="Search" autocomplete="off" aria-label="Search">
+           </form>
+        </ul>
+
+
+    </div>
+</header>
+
+<div id="search-results" class="search-results">
+</div>
+
+
+
+        <div class="container-fluid">
+	    <div class="row">
+		<nav class="navigation col-sm-12 order-sm-12 col-md-3 order-md-1">
+		    <ul>
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/" class="">
+          Lua Scripts Manual
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/overview/" class="">
+          overview
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/installation/" class="">
+          installation
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/troubleshooting/" class="">
+          troubleshooting
+      </a>
+
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/" class="">
+          scripts
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/overview/" class="">
+          overview
+      </a>
+
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/" class="">
+          contrib
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/autogrouper/" class="">
+          AutoGrouper
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/autostyle/" class="">
+          autostyle
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/clear_gps/" class="">
+          clear_GPS
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/collecthelper/" class="">
+          CollectHelper
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/copy_attach_detach_tags/" class="">
+          copy_attach_detach_tags
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/cr2hdr/" class="">
+          cr2hdr
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/enfuseadvanced/" class="">
+          enfuseAdvanced
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/exportlut/" class="">
+          exportLUT
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/ext_editor/" class="">
+          ext_editor
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/face_recognition/" class="">
+          face_recognition
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/fujifilm_dynamic_range/" class="">
+          fujifilm_dynamic_range
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/fujifilm_ratings/" class="">
+          fujifilm_ratings
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/geojson_export/" class="">
+          geoJSON_export
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/geotoolbox/" class="">
+          geoToolbox
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/gimp/" class="">
+          gimp
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/gpx_export/" class="">
+          gpx_export
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/hdrmerge/" class="">
+          HDRMerge
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/hugin/" class="">
+          hugin
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/image_stack/" class="">
+          image_stack
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/image_time/" class="">
+          image_time
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/kml_export/" class="">
+          kml_export
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/labelstotags/" class="">
+          LabelsToTags
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/openinexplorer/" class="">
+          OpenInExplorer
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/passport_guide/" class="">
+          passport_guide
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/pdf_slideshow/" class="">
+          pdf_slideshow
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/photils/" class="">
+          photils
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/quicktag/" class="">
+          quicktag
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rate_group/" class="">
+          rate_group
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class=" active">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
+          rename_tags
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rl_out_sharp/" class="">
+          RL_out_sharp
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/select_untagged/" class="">
+          select_untagged
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/slideshowmusic/" class="">
+          slideshowMusic
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/transfer_hierarchy/" class="">
+          transfer_hierarchy
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/video_ffmpeg/" class="">
+          video_ffmpeg
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/" class="">
+          examples
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/api_version/" class="">
+          api_version
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/darkroom_demo/" class="">
+          darkroom_demo
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/gettextexample/" class="">
+          gettextExample
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/hello_world/" class="">
+          hello_world
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/lighttable_demo/" class="">
+          lighttable_demo
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/moduleexample/" class="">
+          moduleExample
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/multi_os/" class="">
+          multi_os
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/panels_demo/" class="">
+          panels_demo
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/preferenceexamples/" class="">
+          preferenceExample
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/printexamples/" class="">
+          printExamples
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/examples/running_os/" class="">
+          running_os
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/" class="">
+          official
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/check_for_updates/" class="">
+          check_for_updates
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/copy_paste_metadata/" class="">
+          copy_paste_metadata
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/delete_long_tags/" class="">
+          delete_long_tags
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/delete_unused_tags/" class="">
+          delete_unused_tags
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/enfuse/" class="">
+          enfuse
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/generate_image_txt/" class="">
+          generate_image_txt
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/image_path_in_ui/" class="">
+          image_path_in_ui
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/import_filter_manager/" class="">
+          import_filter_manager
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/import_filters/" class="">
+          import_filters
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/save_selection/" class="">
+          save_selection
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/official/selection_to_pdf/" class="">
+          selection_to_pdf
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/tools/" class="">
+          tools
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/tools/executable_manager/" class="">
+          executable_manager
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/tools/gen_i18n_mo/" class="">
+          gen_i18n_mo
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/tools/get_lib_manpages/" class="">
+          get_lib_manpages
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/tools/get_libdoc/" class="">
+          get_libdoc
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.manual/scripts/tools/script_manager/" class="">
+          script_manager
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   </ul>
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/" class="">
+          Lua Scripts Libraries API Manual
+      </a>
+
+   <ul>
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/" class="">
+          dtutils
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/details/" class="">
+          details
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/check_min_api_version/" class="">
+          check_min_api_version
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/check_os/" class="">
+          check_os
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/deprecated/" class="">
+          deprecated
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/find_image_by_id/" class="">
+          find_image_by_id
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/join/" class="">
+          join
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/prequire/" class="">
+          prequire
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/spairs/" class="">
+          spairs
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils/split/" class="">
+          split
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.debug/" class="">
+          dtutils.debug
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.debug/details/" class="">
+          details
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.debug/dprint/" class="">
+          dprint
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.debug/new_tracepoint/" class="">
+          new_tracepoint
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.debug/terse_dump/" class="">
+          terse_dump
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.debug/tracepoint/" class="">
+          tracepoint
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/" class="">
+          dtutils.file
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/details/" class="">
+          details
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/check_if_bin_exists/" class="">
+          check_if_bin_exists
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/check_if_file_exists/" class="">
+          check_if_file_exists
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/chop_filetype/" class="">
+          chop_filetype
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/create_unique_filename/" class="">
+          create_unique_filename
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/executable_path_widget/" class="">
+          executable_path_widget
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/file_copy/" class="">
+          file_copy
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/file_move/" class="">
+          file_move
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/filename_increment/" class="">
+          filename_increment
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_basename/" class="">
+          get_basename
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_executable_path_preference/" class="">
+          get_executable_path_preference
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_filename/" class="">
+          get_filename
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_filetype/" class="">
+          get_filetype
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/get_path/" class="">
+          get_path
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/mkdir/" class="">
+          mkdir
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/rmdir/" class="">
+          rmdir
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/sanitize_filename/" class="">
+          sanitize_filename
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/set_executable_path_preference/" class="">
+          set_executable_path_preference
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/split_filepath/" class="">
+          split_filepath
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.file/test_file/" class="">
+          test_file
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.log/" class="">
+          dtutils.log
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.log/details/" class="">
+          details
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.log/caller/" class="">
+          caller
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.log/engine/" class="">
+          engine
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.log/log_level/" class="">
+          log_level
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.log/msg/" class="">
+          msg
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.string/" class="">
+          dtutils.string
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.string/details/" class="">
+          details
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.string/escape_xml_characters/" class="">
+          escape_xml_characters
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.string/is_not_sanitized/" class="">
+          is_not_sanitized
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.string/sanitize/" class="">
+          sanitize
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.string/sanitize_lua/" class="">
+          sanitize_lua
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.string/strip_accents/" class="">
+          strip_accents
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.string/urlencode/" class="">
+          urlencode
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.system/" class="">
+          dtutils.system
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.system/details/" class="">
+          details
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.system/external_command/" class="">
+          external_command
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.system/launch_default_app/" class="">
+          launch_default_app
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.scripts.api.manual/dtutils.system/windows_command/" class="">
+          windows_command
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/" class="">
+          Lua API Manual
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/version/" class="">
+          Lua API Version
+      </a>
+
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/" class="">
+          darktable
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/overview/" class="">
+          overview
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.collection/" class="">
+          darktable.collection
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.configuration/" class="">
+          darktable.configuration
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.control/" class="">
+          darktable.control
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.database/" class="">
+          darktable.database
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.debug/" class="">
+          darktable.debug
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.films/" class="">
+          darktable.films
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.gettext/" class="">
+          darktable.gettext
+      </a>
+
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/" class="">
+          darktable.gui
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/overview/" class="">
+          darktable.gui overview
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/action/" class="">
+          darktable.gui.action
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/action_images/" class="">
+          darktable.gui.action_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/create_job/" class="">
+          darktable.gui.create_job
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/current_view/" class="">
+          darktable.gui.current_view
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/hovered/" class="">
+          darktable.gui.hovered
+      </a>
+
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/" class="">
+          darktable.gui.libs
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/overview/" class="">
+          darktable.gui.libs overview
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/backgroundjobs/" class="">
+          darktable.gui.libs.backgroundjobs
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/camera/" class="">
+          darktable.gui.libs.camera
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/collect/" class="">
+          darktable.gui.libs.collect
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/colorlabels/" class="">
+          darktable.gui.libs.colorlabels
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/colorpicker/" class="">
+          darktable.gui.libs.colorpicker
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/copy_history/" class="">
+          darktable.gui.libs.copy_history
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/darktable_label/" class="">
+          darktable.gui.libs.darktable_label
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/export/" class="">
+          darktable.gui.libs.export
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/filmstrip/" class="">
+          darktable.gui.libs.filmstrip
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/filter/" class="">
+          darktable.gui.libs.filter
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/geotagging/" class="">
+          darktable.gui.libs.geotagging
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/global_toolbox/" class="">
+          darktable.gui.libs.global_toolbox
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/hinter/" class="">
+          darktable.gui.libs.hinter
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/histogram/" class="">
+          darktable.gui.libs.histogram
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/history/" class="">
+          darktable.gui.libs.history
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/image/" class="">
+          darktable.gui.libs.image
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/import/" class="">
+          darktable.gui.libs.import
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/lighttable_mode/" class="">
+          darktable.gui.libs.lighttable_mode
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/live_view/" class="">
+          darktable.gui.libs.live_view
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/location/" class="">
+          darktable.gui.libs.location
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/map_settings/" class="">
+          darktable.gui.libs.map_settings
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/masks/" class="">
+          darktable.gui.libs.masks
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/metadata/" class="">
+          darktable.gui.libs.metadata
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/metadata_view/" class="">
+          darktable.gui.libs.metadata_view
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/modulegroups/" class="">
+          darktable.gui.libs.modulegroups
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/module_toolbox/" class="">
+          darktable.gui.libs.module_toolbox
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/navigation/" class="">
+          darktable.gui.libs.navigation
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/print_settings/" class="">
+          darktable.gui.libs.print_settings
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/ratings/" class="">
+          darktable.gui.libs.ratings
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/recentcollect/" class="">
+          darktable.gui.libs.recentcollect
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/select/" class="">
+          darktable.gui.libs.select
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/session/" class="">
+          darktable.gui.libs.session
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/snapshots/" class="">
+          darktable.gui.libs.snapshots
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/styles/" class="">
+          darktable.gui.libs.styles
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/tagging/" class="">
+          darktable.gui.libs.tagging
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/viewswitcher/" class="">
+          darktable.gui.libs.viewswitcher
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/libs/view_toolbox/" class="">
+          darktable.gui.libs.view_toolbox
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/panel_get_size/" class="">
+          darktable.gui.panel_get_size
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/panel_hide/" class="">
+          darktable.gui.panel_hide
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/panel_hide_all/" class="">
+          darktable.gui.panel_hide_all
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/panel_set_size/" class="">
+          darktable.gui.panel_set_size
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/panel_show/" class="">
+          darktable.gui.panel_show
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/panel_show_all/" class="">
+          darktable.gui.panel_show_all
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/panel_visible/" class="">
+          darktable.gui.panel_visible
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/selection/" class="">
+          darktable.gui.selection
+      </a>
+
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/views/" class="">
+          darktable.gui.views
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/views/overview/" class="">
+          darktable.gui.views overview
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/views/darkroom/" class="">
+          darktable.gui.views.darkroom
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/views/lighttable/" class="">
+          darktable.gui.views.lighttable
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/views/map/" class="">
+          darktable.gui.views.map
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/views/print/" class="">
+          darktable.gui.views.print
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/views/slideshow/" class="">
+          darktable.gui.views.slideshow
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/gui/views/tethering/" class="">
+          darktable.gui.views.tethering
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   </ul>
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.guides/" class="">
+          darktable.guides
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.new_format/" class="">
+          darktable.new_format
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.new_storage/" class="">
+          darktable.new_storage
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.new_widget/" class="">
+          darktable.new_widget
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.password/" class="">
+          darktable.password
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.preferences/" class="">
+          darktable.preferences
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.print/" class="">
+          darktable.print
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.print_error/" class="">
+          darktable.print_error
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.print_hinter/" class="">
+          darktable.print_hinter
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.print_log/" class="">
+          darktable.print_log
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.print_toast/" class="">
+          darktable.print_toast
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.register_event/" class="">
+          darktable.register_event
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.destroy_event/" class="">
+          darktable.destroy_event
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.register_lib/" class="">
+          darktable.register_lib
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.register_storage/" class="">
+          darktable.register_storage
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.destroy_storage/" class="">
+          darktable.destroy_storage
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.styles/" class="">
+          darktable.styles
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/darktable/darktable.tags/" class="">
+          darktable.tags
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/" class="">
+          types
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/overview/" class="">
+          overview
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/_pdf_mode_t/" class="">
+          _pdf_mode_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/_pdf_pages_t/" class="">
+          _pdf_pages_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/comp_type_t/" class="">
+          comp_type_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_collection_filter_t/" class="">
+          dt_collection_filter_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_collection_properties_t/" class="">
+          dt_collection_properties_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_collection_rating_comperator_t/" class="">
+          dt_collection_rating_comperator_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_collection_sort_order_t/" class="">
+          dt_collection_sort_order_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_collection_sort_t/" class="">
+          dt_collection_sort_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_exr_compression_t/" class="">
+          dt_imageio_exr_compression_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_j2k_format_t/" class="">
+          dt_imageio_j2k_format_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_j2k_preset_t/" class="">
+          dt_imageio_j2k_preset_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_copy/" class="">
+          dt_imageio_module_format_data_copy
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_exr/" class="">
+          dt_imageio_module_format_data_exr
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_j2k/" class="">
+          dt_imageio_module_format_data_j2k
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_jpeg/" class="">
+          dt_imageio_module_format_data_jpeg
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_pdf/" class="">
+          dt_imageio_module_format_data_pdf
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_pfm/" class="">
+          dt_imageio_module_format_data_pfm
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_png/" class="">
+          dt_imageio_module_format_data_png
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_ppm/" class="">
+          dt_imageio_module_format_data_ppm
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_tiff/" class="">
+          dt_imageio_module_format_data_tiff
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_data_webp/" class="">
+          dt_imageio_module_format_data_webp
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_format_t/" class="">
+          dt_imageio_module_format_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_disk/" class="">
+          dt_imageio_module_storage_data_disk
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_email/" class="">
+          dt_imageio_module_storage_data_email
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_gallery/" class="">
+          dt_imageio_module_storage_data_gallery
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_latex/" class="">
+          dt_imageio_module_storage_data_latex
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_storage_data_piwigo/" class="">
+          dt_imageio_module_storage_data_piwigo
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_imageio_module_storage_t/" class="">
+          dt_imageio_module_storage_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lib_collect_mode_t/" class="">
+          dt_lib_collect_mode_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lib_collect_params_rule_t/" class="">
+          dt_lib_collect_params_rule_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lighttable_layout_t/" class="">
+          dt_lighttable_layout_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_align_t/" class="">
+          dt_lua_align_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_backgroundjob_t/" class="">
+          dt_lua_backgroundjob_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_cairo_t/" class="">
+          dt_lua_cairo_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_ellipsize_mode_t/" class="">
+          dt_lua_ellipsize_mode_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_film_t/" class="">
+          dt_lua_film_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_image_t/" class="">
+          dt_lua_image_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_lib_t/" class="">
+          dt_lua_lib_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_orientation_t/" class="">
+          dt_lua_orientation_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_snapshot_t/" class="">
+          dt_lua_snapshot_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_tag_t/" class="">
+          dt_lua_tag_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_lua_view_t/" class="">
+          dt_lua_view_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_pdf_stream_encoder_t/" class="">
+          dt_pdf_stream_encoder_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_style_item_t/" class="">
+          dt_style_item_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_style_t/" class="">
+          dt_style_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_ui_container_t/" class="">
+          dt_ui_container_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/dt_ui_panel_t/" class="">
+          dt_ui_panel_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/hint_t/" class="">
+          hint_t
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_box/" class="">
+          lua_box
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_button/" class="">
+          lua_button
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_check_button/" class="">
+          lua_check_button
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_combobox/" class="">
+          lua_combobox
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_container/" class="">
+          lua_container
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_entry/" class="">
+          lua_entry
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_file_chooser_button/" class="">
+          lua_file_chooser_button
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_label/" class="">
+          lua_label
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_os_type/" class="">
+          lua_os_type
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_pref_type/" class="">
+          lua_pref_type
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_section_label/" class="">
+          lua_section_label
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_separator/" class="">
+          lua_separator
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_slider/" class="">
+          lua_slider
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_stack/" class="">
+          lua_stack
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_text_view/" class="">
+          lua_text_view
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/lua_widget/" class="">
+          lua_widget
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/types/snapshot_direction_t/" class="">
+          snapshot_direction_t
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li class="parent">
+      <i class="fa fa-plus-square toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/" class="">
+          events
+      </a>
+
+   <ul>
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/overview/" class="">
+          overview
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/darkroom-image-history-changed/" class="">
+          darkroom-image-history-changed
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/darkroom-image-loaded/" class="">
+          darkroom-image-loaded
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/exit/" class="">
+          exit
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/global_toolbox-grouping_toggle/" class="">
+          global_toolbox-grouping_toggle
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/global_toolbox-overlay_toggle/" class="">
+          global_toolbox-overlay_toggle
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/intermediate-export-image/" class="">
+          intermediate-export-image
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/mouse-over-image-changed/" class="">
+          mouse-over-image-changed
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/post-import-film/" class="">
+          post-import-film
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/post-import-image/" class="">
+          post-import-image
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/pre-import/" class="">
+          pre-import
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/selection-changed/" class="">
+          selection-changed
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/shortcut/" class="">
+          shortcut
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/events/view-changed/" class="">
+          view_changed
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
+      <a href="/luadocs/lua.api.manual/attributes/" class="">
+          attributes
+      </a>
+
+   </li>
+   </ul>
+   </li>
+   </ul>
+
+		</nav>
+		<div class="content col-sm-12 order-sm-1 col-md-9 mx-md-auto order-md-12">
+		    
+
+
+
+<div class="crumbs">
+    <span class="crumb">
+	
+
+
+
+<a href='/luadocs/'>Home</a> / <a href='/luadocs/lua.scripts.manual/'>Lua Scripts Manual</a> / <a href='/luadocs/lua.scripts.manual/scripts/'>scripts</a> / <a href='/luadocs/lua.scripts.manual/scripts/contrib/'>contrib</a> / rename_images
+    </span>
+</div>
+
+<div class="prev-next row">
+    <div class="col-6">
+    
+	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rate_group/" class="next">&lt; rate_group</a>
+	
+    </div>
+    <div class="col-6">
+    
+	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="prev">rename_tags &gt;</a>
+	
+    </div>
+</div>
+
+
+<article role="main">
+
+    <h1 class="title">
+        rename_images
+    </h1>
+
+    
+
+    <h2 id="name"><a href="#name">🔗</a>Name</h2>
+<p>rename_images.lua - rename one or more image files</p>
+<h2 id="description"><a href="#description">🔗</a>Description</h2>
+<p>Rename an image or images according to a pattern built by
+the user.  It is possible to specify a different directory
+in the rename pattern, which will result in a move as well as
+a rename.  The database will be updated to reflect the new
+name/location of the image.</p>
+<h2 id="usage"><a href="#usage">🔗</a>Usage</h2>
+<ul>
+<li>require this script from your luarc file or start it from script_manager</li>
+<li>select an image or images</li>
+<li>enter a renaming pattern</li>
+<li>click the button to rename the files</li>
+</ul>
+<h2 id="additional-software-required"><a href="#additional-software-required">🔗</a>Additional Software Required</h2>
+<h2 id="limitations"><a href="#limitations">🔗</a>Limitations</h2>
+<h2 id="author"><a href="#author">🔗</a>Author</h2>
+<p>Bill Ferguson - <a href="mailto:wpferguson@gmail.com">wpferguson@gmail.com</a></p>
+
+
+    
+</article>
+
+<div class="prev-next row">
+    <div class="col-6">
+    
+	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rate_group/" class="next">&lt; rate_group</a>
+	
+    </div>
+    <div class="col-6">
+    
+	<a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="prev">rename_tags &gt;</a>
+	
+    </div>
+</div>
+
+
+
+      </div>
+	    </div>
+
+            
+
+        </div>
+
+
+    </body>
+</html>
+
+<script>
+(function($) {
+  
+
+  $.fn.scrollToMiddle = function(options) {
+    var settings = $.extend({
+        duration: 0
+    }, options );
+
+    return this.each(function() {
+      var $el = $(this);
+      var elOffset = $el.offset().top;
+      var elHeight = $el.height();
+      var windowHeight = $(window).height();
+      var offset;
+      if (elHeight < windowHeight) {
+        offset = elOffset - ((windowHeight / 2) - (elHeight / 2));
+      }
+      else {
+        offset = elOffset;
+      }
+      $('.navigation').scrollTop(offset);
+    });
+  };
+}(jQuery));
+
+$('.navigation').css('opacity', '0');
+ $(document).ready(function(){
+     $('.parent ul').hide();
+     $('.navigation').css('opacity', 1.0);
+     $('.active').parents('ul').show();
+     $('.active').siblings('ul').show();
+     $('.active').children('i.toggle').removeClass("fa-plus-squre").addClass("fa-minus-square-o");
+     $('.active').parents('li').children('.toggle').removeClass("fa-plus-square").addClass("fa-minus-square-o");
+     $('.active').scrollToMiddle();
+
+     $('.toggle').on('click', function (e) {
+       e.stopPropagation();
+       $(this).siblings('ul').slideToggle();
+
+       if($(this).hasClass("fa-plus-square")) {
+           $(this).addClass("fa-minus-square-o");
+           $(this).removeClass("fa-plus-square");
+       }
+       else {
+           $(this).addClass("fa-plus-square");
+           $(this).removeClass("fa-minus-square-o");
+       }
+     });
+ });
+
+</script>
+
diff --git a/lua.scripts.manual/scripts/contrib/rl_out_sharp/index.html b/lua.scripts.manual/scripts/contrib/rl_out_sharp/index.html
index 1376159..f396f4e 100644
--- a/lua.scripts.manual/scripts/contrib/rl_out_sharp/index.html
+++ b/lua.scripts.manual/scripts/contrib/rl_out_sharp/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/select_untagged/index.html b/lua.scripts.manual/scripts/contrib/select_untagged/index.html
index bc85a9e..18df19c 100644
--- a/lua.scripts.manual/scripts/contrib/select_untagged/index.html
+++ b/lua.scripts.manual/scripts/contrib/select_untagged/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/slideshowmusic/index.html b/lua.scripts.manual/scripts/contrib/slideshowmusic/index.html
index e81f52e..1acb45d 100644
--- a/lua.scripts.manual/scripts/contrib/slideshowmusic/index.html
+++ b/lua.scripts.manual/scripts/contrib/slideshowmusic/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/transfer_hierarchy/index.html b/lua.scripts.manual/scripts/contrib/transfer_hierarchy/index.html
index c891d4c..8e2606d 100644
--- a/lua.scripts.manual/scripts/contrib/transfer_hierarchy/index.html
+++ b/lua.scripts.manual/scripts/contrib/transfer_hierarchy/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/contrib/video_ffmpeg/index.html b/lua.scripts.manual/scripts/contrib/video_ffmpeg/index.html
index 133fb0e..c794d80 100644
--- a/lua.scripts.manual/scripts/contrib/video_ffmpeg/index.html
+++ b/lua.scripts.manual/scripts/contrib/video_ffmpeg/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/api_version/index.html b/lua.scripts.manual/scripts/examples/api_version/index.html
index e43e82a..d9eeaf5 100644
--- a/lua.scripts.manual/scripts/examples/api_version/index.html
+++ b/lua.scripts.manual/scripts/examples/api_version/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/darkroom_demo/index.html b/lua.scripts.manual/scripts/examples/darkroom_demo/index.html
index 4176c5f..8ed6136 100644
--- a/lua.scripts.manual/scripts/examples/darkroom_demo/index.html
+++ b/lua.scripts.manual/scripts/examples/darkroom_demo/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/gettextexample/index.html b/lua.scripts.manual/scripts/examples/gettextexample/index.html
index f600482..49b15f8 100644
--- a/lua.scripts.manual/scripts/examples/gettextexample/index.html
+++ b/lua.scripts.manual/scripts/examples/gettextexample/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/hello_world/index.html b/lua.scripts.manual/scripts/examples/hello_world/index.html
index 4137e17..73ab863 100644
--- a/lua.scripts.manual/scripts/examples/hello_world/index.html
+++ b/lua.scripts.manual/scripts/examples/hello_world/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/index.html b/lua.scripts.manual/scripts/examples/index.html
index f86bf81..d7d3d6b 100644
--- a/lua.scripts.manual/scripts/examples/index.html
+++ b/lua.scripts.manual/scripts/examples/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/lighttable_demo/index.html b/lua.scripts.manual/scripts/examples/lighttable_demo/index.html
index 2b93bc5..d7b1d69 100644
--- a/lua.scripts.manual/scripts/examples/lighttable_demo/index.html
+++ b/lua.scripts.manual/scripts/examples/lighttable_demo/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/moduleexample/index.html b/lua.scripts.manual/scripts/examples/moduleexample/index.html
index bc76e88..962eb29 100644
--- a/lua.scripts.manual/scripts/examples/moduleexample/index.html
+++ b/lua.scripts.manual/scripts/examples/moduleexample/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/multi_os/index.html b/lua.scripts.manual/scripts/examples/multi_os/index.html
index e458e85..d75b478 100644
--- a/lua.scripts.manual/scripts/examples/multi_os/index.html
+++ b/lua.scripts.manual/scripts/examples/multi_os/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/panels_demo/index.html b/lua.scripts.manual/scripts/examples/panels_demo/index.html
index 3732c43..6a4a1af 100644
--- a/lua.scripts.manual/scripts/examples/panels_demo/index.html
+++ b/lua.scripts.manual/scripts/examples/panels_demo/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/preferenceexamples/index.html b/lua.scripts.manual/scripts/examples/preferenceexamples/index.html
index c95f87b..45f0325 100644
--- a/lua.scripts.manual/scripts/examples/preferenceexamples/index.html
+++ b/lua.scripts.manual/scripts/examples/preferenceexamples/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/printexamples/index.html b/lua.scripts.manual/scripts/examples/printexamples/index.html
index e9af1dd..9aa1c00 100644
--- a/lua.scripts.manual/scripts/examples/printexamples/index.html
+++ b/lua.scripts.manual/scripts/examples/printexamples/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/examples/running_os/index.html b/lua.scripts.manual/scripts/examples/running_os/index.html
index 548083b..b6f087e 100644
--- a/lua.scripts.manual/scripts/examples/running_os/index.html
+++ b/lua.scripts.manual/scripts/examples/running_os/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/index.html b/lua.scripts.manual/scripts/index.html
index 3896084..5c1e41f 100644
--- a/lua.scripts.manual/scripts/index.html
+++ b/lua.scripts.manual/scripts/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/check_for_updates/index.html b/lua.scripts.manual/scripts/official/check_for_updates/index.html
index 691caf4..53c1bb8 100644
--- a/lua.scripts.manual/scripts/official/check_for_updates/index.html
+++ b/lua.scripts.manual/scripts/official/check_for_updates/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/copy_paste_metadata/index.html b/lua.scripts.manual/scripts/official/copy_paste_metadata/index.html
index 467775c..cb2cac0 100644
--- a/lua.scripts.manual/scripts/official/copy_paste_metadata/index.html
+++ b/lua.scripts.manual/scripts/official/copy_paste_metadata/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/delete_long_tags/index.html b/lua.scripts.manual/scripts/official/delete_long_tags/index.html
index 5565101..f1c1803 100644
--- a/lua.scripts.manual/scripts/official/delete_long_tags/index.html
+++ b/lua.scripts.manual/scripts/official/delete_long_tags/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/delete_unused_tags/index.html b/lua.scripts.manual/scripts/official/delete_unused_tags/index.html
index a70326f..b493f8f 100644
--- a/lua.scripts.manual/scripts/official/delete_unused_tags/index.html
+++ b/lua.scripts.manual/scripts/official/delete_unused_tags/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/enfuse/index.html b/lua.scripts.manual/scripts/official/enfuse/index.html
index 15d3a93..cdae87b 100644
--- a/lua.scripts.manual/scripts/official/enfuse/index.html
+++ b/lua.scripts.manual/scripts/official/enfuse/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/generate_image_txt/index.html b/lua.scripts.manual/scripts/official/generate_image_txt/index.html
index 2b1e3a4..1c3459b 100644
--- a/lua.scripts.manual/scripts/official/generate_image_txt/index.html
+++ b/lua.scripts.manual/scripts/official/generate_image_txt/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/image_path_in_ui/index.html b/lua.scripts.manual/scripts/official/image_path_in_ui/index.html
index b95fa67..bb3e407 100644
--- a/lua.scripts.manual/scripts/official/image_path_in_ui/index.html
+++ b/lua.scripts.manual/scripts/official/image_path_in_ui/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/import_filter_manager/index.html b/lua.scripts.manual/scripts/official/import_filter_manager/index.html
index 8f844fe..6df019a 100644
--- a/lua.scripts.manual/scripts/official/import_filter_manager/index.html
+++ b/lua.scripts.manual/scripts/official/import_filter_manager/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/import_filters/index.html b/lua.scripts.manual/scripts/official/import_filters/index.html
index de0aed9..c4dece2 100644
--- a/lua.scripts.manual/scripts/official/import_filters/index.html
+++ b/lua.scripts.manual/scripts/official/import_filters/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/index.html b/lua.scripts.manual/scripts/official/index.html
index 8dd2fe9..91c1723 100644
--- a/lua.scripts.manual/scripts/official/index.html
+++ b/lua.scripts.manual/scripts/official/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/save_selection/index.html b/lua.scripts.manual/scripts/official/save_selection/index.html
index 70ec0e3..6ff07a1 100644
--- a/lua.scripts.manual/scripts/official/save_selection/index.html
+++ b/lua.scripts.manual/scripts/official/save_selection/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/official/selection_to_pdf/index.html b/lua.scripts.manual/scripts/official/selection_to_pdf/index.html
index d6ee805..72b0912 100644
--- a/lua.scripts.manual/scripts/official/selection_to_pdf/index.html
+++ b/lua.scripts.manual/scripts/official/selection_to_pdf/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/overview/index.html b/lua.scripts.manual/scripts/overview/index.html
index ea6544c..295b805 100644
--- a/lua.scripts.manual/scripts/overview/index.html
+++ b/lua.scripts.manual/scripts/overview/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/tools/executable_manager/index.html b/lua.scripts.manual/scripts/tools/executable_manager/index.html
index 002e8d7..303f137 100644
--- a/lua.scripts.manual/scripts/tools/executable_manager/index.html
+++ b/lua.scripts.manual/scripts/tools/executable_manager/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/tools/gen_i18n_mo/index.html b/lua.scripts.manual/scripts/tools/gen_i18n_mo/index.html
index 7fd1766..76027a0 100644
--- a/lua.scripts.manual/scripts/tools/gen_i18n_mo/index.html
+++ b/lua.scripts.manual/scripts/tools/gen_i18n_mo/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/tools/get_lib_manpages/index.html b/lua.scripts.manual/scripts/tools/get_lib_manpages/index.html
index 253a69c..3e96e1c 100644
--- a/lua.scripts.manual/scripts/tools/get_lib_manpages/index.html
+++ b/lua.scripts.manual/scripts/tools/get_lib_manpages/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/tools/get_libdoc/index.html b/lua.scripts.manual/scripts/tools/get_libdoc/index.html
index 19d309e..5fbe6ea 100644
--- a/lua.scripts.manual/scripts/tools/get_libdoc/index.html
+++ b/lua.scripts.manual/scripts/tools/get_libdoc/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/tools/index.html b/lua.scripts.manual/scripts/tools/index.html
index 73ac8e0..18e8574 100644
--- a/lua.scripts.manual/scripts/tools/index.html
+++ b/lua.scripts.manual/scripts/tools/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/scripts/tools/script_manager/index.html b/lua.scripts.manual/scripts/tools/script_manager/index.html
index 87d362e..6c65d50 100644
--- a/lua.scripts.manual/scripts/tools/script_manager/index.html
+++ b/lua.scripts.manual/scripts/tools/script_manager/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/lua.scripts.manual/troubleshooting/index.html b/lua.scripts.manual/troubleshooting/index.html
index 1927069..6bfc2a0 100644
--- a/lua.scripts.manual/troubleshooting/index.html
+++ b/lua.scripts.manual/troubleshooting/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/search/index.html b/search/index.html
index e0e0e03..aa941cc 100644
--- a/search/index.html
+++ b/search/index.html
@@ -410,6 +410,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>
diff --git a/sitemap.xml b/sitemap.xml
index 1341fe3..dbe6cd5 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -990,6 +990,10 @@
     <loc>https://darktable-org.github.io/luadocs/lua.scripts.manual/scripts/contrib/rate_group/</loc>
   </url>
   
+  <url>
+    <loc>https://darktable-org.github.io/luadocs/lua.scripts.manual/scripts/contrib/rename_images/</loc>
+  </url>
+  
   <url>
     <loc>https://darktable-org.github.io/luadocs/lua.api.manual/darktable/gui/libs/navigation/</loc>
   </url>
diff --git a/tags/index.html b/tags/index.html
index 46d12e0..d8aa955 100644
--- a/tags/index.html
+++ b/tags/index.html
@@ -411,6 +411,16 @@
       <i class="no-toggle"></i>
    
 
+      <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename_images/" class="">
+          rename_images
+      </a>
+
+   </li>
+   
+   <li>
+      <i class="no-toggle"></i>
+   
+
       <a href="/luadocs/lua.scripts.manual/scripts/contrib/rename-tags/" class="">
           rename_tags
       </a>