Commons talk:DtMediaWiki

Installation guide for Lua dummies?

Salut @Trougnouf, I try to prepare a small introductory session for Darktable next Saturday in our Cologne Workshop. Coming from Lightroom, I'm quite happy that this plugin should do something similar to what LrMediaWiki does? Unfortunately I fail to understand what I need to do to install or use it. Beginning with dependencies (should I install anything or is it somehow bundled?), and – using a Mac – not finding a Darktable plugin directory, not knowing what a darktable luarc config file is and so on. Could you by any chance give me some hints if this plugin is recommended for non-developers and if yes, how to get hands on? Thanks a lot! Best regards and thanks for your work! Elya (talk) 17:01, 10 March 2024 (UTC)

Hi Elya,

I think that installing a darktable plugin requires some technical skill (not quite developer-level, but at least editing a text-file and using the terminal to instal the dependencies), and unfortunately I have never used a Mac so I am of limited help there. Though if you can manage to install it you would surely be able to help fellow darkktable-common users with more user-friendly instructions.

• The dependencies are not bundled. You would need Lua (I believe darktable currently uses Lua 5.4, and it is probably extra challenging on Mac because you might have to compile from sources), along with the "lua-sec", "lua-luajson", and "lua-multipart-post" libraries. I believe that you can install LuaRocks ( https://github.com/luarocks/luarocks/wiki/Documentation ) to install the different Lua libraries (note that Unix covers both Mac and Linux).

Once that is done you will need to

• Download dtMediaWiki on https://github.com/trougnouf/dtMediaWiki (click the green "Code" button, "Download zip", and extract the zip file s.t. you get a dtMediaWiki folder
• Find your darktable installation directory and copy the dtMediaWiki folder into the darktable/lua/contrib directory (create whatever directory is missing once you find the darktable directory).
• Finally you can activate the plugin by adding require "contrib/dtMediaWiki/dtMediaWiki" to your darktable/luarc file (you can do that part in the terminal by simply copying the command echo 'require "contrib/dtMediaWiki/dtMediaWiki"' >> ~/.config/darktable/luarc).

Hope this helps.

All the best,

--Trougnouf (talk) 17:59, 10 March 2024 (UTC)

Hi @Trougnouf, thanks for the quick reply! Although I'm quite tech-savvy, these "modern" dependency-based architecture of tools makes me nervous as I have the impression my computer gets filled with stuff I don't have under control and will never get rid off later ;-) I have to sleep a night over the decision … Just one more questions: can it be used at all on Windows? If not, it won't make sense to show it to my fellow workshop folks. Elya (talk) 18:14, 10 March 2024 (UTC)

Yes it can :) It should be easier on Windows (and Linux) because Lua comes pre-compiled.

Lua and its libraries take up an insignificant amount of space (approximately less than 1 MB I believe) but I understand fear of the unknown.

Happy workshop regardless of what you do.

--Trougnouf (talk) 18:37, 10 March 2024 (UTC)