General

• So, I have seen a bunch of different ways to spell darktable. Which one is right?¶

  There is only one way, and that is “darktable”. All lower case, in one word, except when starting a sentence.

• What’s the best way to contact the developers/report bugs?¶

  For fast discussions and short questions it’s best to visit us in IRC (on irc.oftc.net, channel #darktable), especially in the Western European evening hours. If you don’t want to use IRC, don’t know what it is or want something less transient you can use our mailing lists. See our contact page. For Issues/bugs, please use GitHub Issues

• After updating my system I suddenly see red borders and giant buttons everywhere!¶

  darktable uses GTK3 to create its GUI. We make heavy use of styling to change the look to what you are used to. Unfortunately there were several incompatible changes in the past with how GTK3 handles that. As a result darktable needs to be compiled for the same version of the library as what it’s being used with later. Otherwise you risk GTK3 not supporting the stylesheet darktable uses. When you see those red borders that’s exactly what’s happening.

  • Most of the time this happens when using third party package repos like Pascal’s PPA on Ubuntu. When upgrading the base system the PPA gets disabled while the old darktable package is still installed. Just make sure to re-enable it, point it to the right distro release version and update darktable. That should fix the problem.
  • If you compiled darktable yourself make sure to remove both the installed files as well as your build/ folder before re-compiling.
  • If you use your system’s official darktable package you should file a bug report against the distribution and ask them to build a new package.
  • It is possible to customize the look of darktable by following these steps:
    • creating a CSS file (for example mytheme.css) on following folder:
      • 2.4.x and 2.6.x releases: ~/.config/darktable/
      • On 3.0.x release: ~/.config/darktable/themes (themes folder needs to be created if it doesn’t exist)
    • then add the following line on the beginning of the created css file: @import url("/path/to/darktable.css");, where the /path/to/darktable.css is the path… to the default darktable CSS (or one of the other themes you want to edit).
    • last step is to copy parts of the pointed css you want to edit and adjust settings as you want.
  • Be aware: darktable 3.0 brings a whole new UI, so 3.0 CSS themes are not compatible with previous releases, and previous 2.4 and 2.6 themes are not compatible with darktable 3.0.

  Since darktable 3.2, released in august 2020, CSS tweaks are far easier. Forget the steps described just above for that and just go into the preferences window. In the general tab: select your theme, check modify selected theme with tweaks below and add your tweaks in text field below. That’s all!

  By the way, CSS file should be easier to read and lot of comments will help you find faster CSS part you want to tweak and so copy/modify in preferences.

• How do I rename files on my hard disk?¶

  Use your file manager (or the command line). Image renaming is not a feature we are developing for darktable. Make sure to first remove the files from darktable’s library, then rename them (and the associated sidecar) and re-import them afterwards.

• Will you add file manager capabilities in the future?¶

  No.

• How do I change the order in which modules are applied to an image?¶

  See the user manual for more details.

• Modules? What modules?¶

  See the section below about the manual, book and tutorial videos.

• darktable crashes with SIGILL. What’s up?¶

  Due to the large number of mathematically intense operations which the Image Operators (IOPs) perform, the minimum requirement for a CPU to run darktable is one which supports SSE2. If your cpu does not support SSE2 more than fifteen years after the feature’s introduction, then it really is time to upgrade. Please see the Wikipedia page for more details on SSE2-capable CPUs.

• How do I open images? I only see a grey canvas.¶

  You have to import a single image or a film roll (directory) using the buttons on the left side of the lighttable Add to Library.

• Ok, I imported some images, but I still don’t see anything, though after importing a single image it is shown in darkroom mode.¶

  Try to set the display filter in the top panel to “all” and check the “initial rating when importing filmrolls” setting in the preference pane (the small gear wheel at the top).

• How do I save my changes?¶

  You don’t have to. Everything you do is immediately saved. You can just quit darktable and go on editing later. Once you are done you have to export your final image (while in lighttable mode) using the export module.

• What happened to the demosaic module in darkroom? How can I select more demosaicing algorithms?¶

  We moved the demosaicing into our internal pixel pipeline. The benefit is that it is faster and more accurate. The downside is that we have to implement the demosaicing algorithms ourselves. Since the differences are really small with real world photos we didn’t bother to port more than PPG and AMaZE. If anyone feels the need for more choice we will gladly accept patches.

• This confuses me. Is there a manual?¶

  Yes, here. You might also want to read through the blog section of this website.

• My auto-applied presets aren’t enabled for pictures imported before upgrade to version 1.1 (or higher), what’s happening?¶

  This question is probably not affecting many people these days, but we kept it for historical reasons.

  This is intended. In the pre-1.1 era, modules that were enabled by default didn’t get recorded in the history stack, which meant that changing these presets would retroactively change your pictures. It was decided that this is totally broken behaviour and since darktable version 1.1 auto-enabled modules for newly imported pictures are saved in history stack. However this change left all old photos without any user-defined auto-applied presets enabled. To fix this you will have to manually edit them. We suggest making a style out of preset, filtering photos to which it should apply using collect module, then selecting all in resulting collection and applying the style, repeat for every needed preset.

• I attached and turned on my camera, but it doesn’t show up in darktable, what’s wrong?¶

  If the camera in question is supported by libgphoto2, then the most likely cause is that some other process is blocking the device.

  If you’re using Linux, check that your desktop environment hasn’t auto-mounted it.

  In case of OS X, there’s PTPCamera daemon which starts for every attached camera, so you must kill it before you can use the camera in darktable. Either run killall PTPCamera or implement more automated solution like described at the bottom of this page: https://micro-manager.org/wiki/GPhoto.

  On Windows the situation is a little more complicated. libgphoto2 doesn’t work with the default Windows drivers used for connecting them via USB. For tethering to work (in general for libgphoto2 and libusb to work):

  • Use this program to install USB driver on Windows for your camera
  • Follow the description.
  • When you run it, replace the current Windows camera driver with WinUSB driver.
  • Start darktable after replacing the driver.

  In rare cases that might break other software accessing the camera though! If you experience this, you can roll back, and remove the WinUSB driver following this description – but then your camera won’t work with darktable.

• So, darktable uses gphoto2 for tethering. Are there any more third party projects influencing what works in darktable and what’s not?¶

  Yes, there are two libraries we heavily rely on and which we point to quite often when people complain about darkable lacking something:

  • exiv2 is used for reading metadata from image files. If something isn’t shown correctly in the image information panel on the left side then please check with the command line tool exiv2 and report any problems upstream on their bug tracker – there isn’t much we can do to fix those things ourselves.
  • lensfun is used for lens correction. If the lens correction module isn’t showing your camera or lens, or a wrong one, then please report that to those folks.

Windows¶

darktable is developed for linux, but it was ported to build on Windows. The MSYS2 URCT environment is used to compile the program. Nightly builds are performed in github to ensure the program builds under windows against the current master code. If you experience problems, please check the next few known issues below specific to the Windows port. If you don’t find your answer or believe that you have found a new bug, please report it through our bug tracking system.

• Install file locations¶

  The install of darktable creates the following folders:

  • C:\Program files\darktable\ - the program files to run darktable
  • C:\Users\<username>\AppData\Local\darktable- configuration (darktablerc.txt), databases (data.db and library.db), styles, and backups files are stored here. If the user manual references .config/darktable/ , it means this location on Windows.

• How does the OpenCL support in darktable work on Windows?¶

  The Windows port of darktable fully supports OpenCL with all the performance benefits, assuming you have a GPU with appropriate OpenCL drivers installed. Popular NVIDIA and AMD GPUs are working fine, but please note that in some cases the default drivers which are installed/updated by Windows Update are not necessarily containing the OpenCL driver. The best solution is typically to install the driver directly from the GPU manufacturers (like) NVIDIA drivers or AMD drivers), and check the OpenCL support at the driver first.

  • You can always run an OpenCL test by launching C:\Program Files\darktable\bin\darktable-cltest.exe from a command line window, this will give you detailed information on your current OpenCL status.

• I cannot see the Print module in the Windows version. How can I print my images?¶

  The darktable windows packaging can not print. The Print module in darktable is using CUPS on all operating systems, but that is not available on Windows. This means there was no easy way to port that functionality, and it will require further efforts to find a proper solution for printing in the Windows version as well. Until that time you can use your favorite image printing software separately to print the exported images.

• I read in the manual about changing some configuration setting, which supposed to be located in the user config directory. Where is the config file in the Windows version?¶

  The configuration file of darktable is located at C:\Users\[username]\AppData\Local\darktable\darktablerc. If you change it please use a text editor which can handle Unix line endings, like Notepad++ or similar.

• I have started darktable and its user interface is Finnish/Italian/Urdu/etc. How can I change the language of the user interface to English?¶

  By default darktable uses your operating system’s language and if a localization is available in that language it will start using that localization for the user interface. You can override that and switch to an English user interface in multiple ways:

  • You can launch darktable using the command line darkable --conf ui_last/gui_language=C
  • You can change the darktable shortcut at the Start Menu and append --conf ui_last/gui_language=C to the Target field
  • You can change this setting in the configuration file itself. Open with an editor the configuration file of darktable C:\Users\[username]\AppData\Local\darktable\darktablerc, find the line ui_last/gui_language= and modify it to ui_last/gui_language=C. Please use a text editor which can handle Unix line endings, like Notepad++ or similar

• I read a lot of information in the manual to turn on some debug settings, but I cannot see any debug information. Where can I find those debug logs?¶

  The Windows version of darktable (up to and including release 4.8.1) by default logs its debug information to the following places (This is a hidden folder in Windows, therefore copy and paste the link to windows explorer for access):

  Windows 10: C:\Users\[username]\AppData\Local\Microsoft\Windows\INetCache\darktable\darktable-log.txt

  Windows 7: C:\Users\[username]\AppData\Local\Microsoft\Windows\Temporary Internet Files\darktable\darktable-log.txt

  Since darktable 5.0 the default location is: C:\Users\[username]\Documents\Darktable\darktable-log.txt

• I export my image with a filename which contains some non-English characters, and it’s not working perfectly, what can I do?¶

  Windows handles path names very differently than Unix-like systems. One of the biggest challenges of porting to Windows was making sure that path and file name handling works both on original Unix-like operating systems and also on Windows. While we have tested the Windows port with various Unicode path and file names, it still can happen that it won’t work in all cases, mostly due to external libraries used by darktable. In such cases you can fall back using plain ASCII characters in path and file names, but please also file a bug report.

• I was working with darktable and it suddenly just crashed! What should I do?¶

  Don’t panic, sometimes it happens. If you can reproduce the crash, please file a bug report, and send the so called “backtrace” file as well. You can find the location of this backtrace file in the folder where the crash dialog indicates. Generating a log of the crash can also aid in discovering the cause. The simplest way is to start Windows Command Prompt (cmd), navigate to C:\Program files\darktable\bin and start darktable via darktable.exe -d common or darktable -d opencl or darktable -d perf or to see all the options darktable -h. The log file will be generated in the hidden path listed above.

Known Windows issues¶

• OpenCL will speed up the processing in darktable. Sometimes Windows 11 preinstalls an OpenCL Compatibility app and it causes faults on darktable. Uninstall the OpenCL Compatibility from Windows or start darktable using darktable --disable-opencl.

• Windows 11 Pro security blocks installs. To resolve, go to Windows Security > App & Browsers Control > Exploit Protection Settings > Force Randomization and Set the Force Randomization for images (Mandatory ASLR) to “Off”, and reboot Windows.

Flatpak¶

• Where are the darktable files in flatpak?¶

  The darktable files live at: ~/.var/app/org.darktable.Darktable

• How do I start darktable from terminal?¶

  To start darktable from terminal use: flatpak run org.darktable.Darktable. You can also invoke options like: flatpak run org.darktable.Darktable -d perf

Mac¶

darktable is developed for linux, but it was ported to build on Mac. If you experience problems, please check the next few known issues below specific to the Mac port. If you don’t find your answer or believe that you have found a new bug, please report it through our bug tracking system.