Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

Docs: personal scripts and Flatpak luarc limitations not documented (5.6.0)

Offen
  • Stimmt etwas nicht?
#697 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
4/5
Geschätzter Aufwand
3-5 Tage
Anfängerfreundlichkeit
55/100
Issue-Typ
Dokumentation
Klarheit
Größtenteils klar
Aktivitätsstatus
Ruhig
Tech-Stack
lua
Bereich
documentation

Rechercherichtung

Beginnen Sie mit den Abschnitten Enabling und Flatpak der README, untersuchen Sie anschließend den Einstiegspunkt script_manager und die API-Dokumentation für dt.films.new und dt.database.import. Aktualisieren Sie die Dokumentation, um personal/ scripts, den Schlüssel darktablerc, Ladebeschränkungen von Flatpak, das Verhalten beim Bildimport und die LD_LIBRARY_PATH-Debugging-Umgehung abzudecken.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

Summary

Several behaviours that affect anyone writing personal Lua startup scripts under Darktable 5.6.0 (Flatpak, Linux) are undocumented or incorrect in the current README. Discovered through hands-on debugging. Submitting as a doc issue in case it is useful to others or to the maintainers for a README update.

1. Lua version is 5.4, not the host system version

Darktable 5.x bundles its own interpreter. The system lua -v (often 5.1 or 5.3) is irrelevant. Confirmed for 5.6.0 Flatpak:

flatpak run --command=find org.darktable.Darktable /app -name "liblua*.so.*"
# → /app/lib/liblua.so.5.4.6

goto, <const>, bitwise operators all work inside Darktable scripts.

2. require "myscript" in the user luarc silently fails under Flatpak

The README's "Enabling" section says to add require "myscript" to the user luarc. This works for native installs but silently does nothing under Flatpak.

Why: Darktable Flatpak ships a system luarc (/app/share/darktable/luarc) that loads tools/script_manager. Because script_manager detects it is running from the system data directory (system_based = true), the user's ~/.var/.../config/darktable/luarc is loaded via loadfile() rather than require(), and at that point the Lua package.path does not include the user lua/ directory. Any require "myscript" in the user luarc silently fails — no error, no load.

3. The correct approach: personal/ subfolder + darktablerc entry

script_manager scans USER_LUA_DIR but only processes scripts that are inside a named subfolder (the pattern requires at least one /). A .lua file placed directly in lua/ is silently ignored.

Working approach:

mkdir -p ~/.var/app/org.darktable.Darktable/config/darktable/lua/personal
cp myscript.lua ~/.var/app/org.darktable.Darktable/config/darktable/lua/personal/

Then add one line to darktablerc:

lua/script_manager/personal/myscript=TRUE

Key format: lua/script_manager/<folder>/<script-name-without-.lua>.

The script can also be enabled through the Darktable UI (Lua Scripts panel → personal folder → toggle), which writes the darktablerc entry automatically.

4. dt.films.new(path) creates empty film rolls — use dt.database.import(path) instead

dt.films.new(path) creates the film_roll database entry but does not scan for images. The resulting roll is empty. Darktable prunes empty film rolls on exit, so the call appears to succeed (no Lua error) but nothing persists after the session.

dt.database.import(path) is the correct call when the intent is to import images:

-- When given a directory path, returns a table of imported image objects
local ok, result = pcall(dt.database.import, path)
if ok then
    local n = type(result) == "table" and #result or (result ~= nil and 1 or 0)
    -- n images imported, film roll created with content
end

5. Minimal working template for a personal startup script

-- lua/personal/myscript.lua
-- Loaded by script_manager; runs when lighttable becomes active.

local dt = require "darktable"

local function run()
    -- dt.films, dt.database.import, etc. are all ready here
end

dt.register_event("myscript", "view-changed",
    function(event, old_view, new_view)
        if new_view.id == "lighttable" and
           (old_view == nil or old_view.id == "none") then
            pcall(run)
        end
    end
)

6. Debugging gotcha: Snap/Flatpak LD_LIBRARY_PATH crash

On systems with Snap installed, running flatpak run org.darktable.Darktable -d lua from a terminal may crash immediately:

symbol lookup error: /snap/core20/current/lib/x86_64-linux-gnu/libpthread.so.0:
    undefined symbol: __libc_pthread_init, version GLIBC_PRIVATE

Workaround:

env -u LD_LIBRARY_PATH flatpak run org.darktable.Darktable -d lua 2>&1 | grep lua

Suggested README additions

  • Note under the Flatpak section that require "myscript" only works for scripts inside the cloned lua-scripts repository; personal scripts need the personal/ subfolder + darktablerc approach.
  • A brief "Personal Scripts" subsection covering the above.
  • A note in the API docs (or script_manager docs) that dt.films.new() does not import images and dt.database.import() should be used instead.

Happy to help draft specific text if useful.

Vorherrschende Sprache
Lua
Sterne
220
Forks
141
Keine gemergten PRs in 30 T.

Entwicklungsumgebung

Dieses Projekt bietet weder Dev-Container noch Dockerfile noch Beitragsleitfaden – die Einrichtung liegt bei Ihnen. Beginnen Sie mit der README; die allgemeinen Schritte stehen in unserem Leitfaden für den ersten Beitrag.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus darktable-org/lua-scripts

Alle Issues in darktable-org/lua-scripts

Ähnliche Issues

Weitere Issues zu Lua

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.