darktable article lede image


People following the development of darktable might have heard that we added a grouping feature. Everyone who hasn’t heard of that yet: We added a grouping feature.

Now that everybody knows about it I should try to explain what it actually is and how it works/how to use it. For the technical specification you can have a look at the design specs.

![Grouping turned off](grouping_off.jpg)
Grouping turned off

The first change in the GUI that can be noticed is a little ‘G’ button. Well, first of all we have to notice that there are two kinds of ‘G’ in the GUI: one in the top toolbar, next to the preferences wheel. The other kind is on images frames which are part of a group, next to the yin-yang-edited symbol.

With the G in the toolbar you can change if images are shown in groups or not. This corresponds to the “‘G’ on” and “‘G’ off” sections in the grouping.txt file. The interesting case is when the toolbar G is turned on. Now you can expand grouped images by clicking on the G in the thumbnail frame and collapse the group again with another click. Once a group is expanded you can change the representative of the group by clicking its G. This will be the image that is shown when the group is collapsed.

![Grouping turned on](grouping_on.jpg)
Grouping turned on

If you want to play with that you obviously need grouped images in the first place. You get them either by importing files with the same base name and just different extensions (like “img_0001.CR2” and “img_0001.JPG”) or by duplicating an image. You can also just put images into a group manually by selecting them and hitting ctrl-g. If you expanded a group before hitting these keys the selected images will be added to the expanded group, otherwise a new group is created. Removing images from a group is done by selecting them and hitting ctrl-shift-g.

To select all images in an expanded group you can ctrl-click or shift-click the G of one image of the group.

![Grouping turned on and one group expanded](group_expanded.jpg)
Grouping turned on and one group expanded

So at the end of the day it all boils down to keep your lighttable nice and tidy by only allowing you to only see a single thumbnail for a logical group of images. Please keep in mind however that changes done to the representative of a group (by opening it in darkroom mode and working on it) are only applied to that one image, not all images in the group!

I know that this explanation is a little hard to follow if you didn’t play with the functionality in darktable yet. So just go and try it.

Filed under: Upcoming Feature
These are comments from the old website, archived as static HTML
  1. orbisvicis on Mon Sep 24 17:12:35 2012:
    I like the blender-like keyboard-shortcuts. This will probably help HDR editing.
  2. This will be very helpful. Thanks for this awesome software.
  3. Nice feature.... Thank you guys....
  4. I like this new feature, helpful also to group action pictures (multi-shot in nature or sports).

    I find a little hard to remember shortcut to manually group/ungroup images, so I think alternative way could be useful (right-click menu?)

    Thanks a lot for your work!

  5. @Ivan: I added buttons to the "selected image[s]" module.
  6. Ladislav Ezr on Thu Sep 27 13:09:09 2012:
    Would it be possible to use Luminance HDR backend with this and allow us to create HDR pictures in Darktable?
  7. In case you didn't discover it yet: we have our own HDR creation code in the Lighttable mode...
  8. Ladislav Ezr on Fri Sep 28 17:55:40 2012:
    > SMN

    Where? :O And in which version? O_o
  9. since version 1.0 I guess, may be even since 0.9.3. Go to the lighttable mode, select some images, check the right panel for the module "selected image[s]" and hit the "create HDR" button there...
  10. Ladislav Ezr on Sat Sep 29 16:12:27 2012:
    > SMN

    Ok, so I found that hidden switch and it's pretty useless, since it looks like picture with 256 colours and ping where white should be... (Canon 600D, Version 1.0.5)
  11. isn't it a bit harsh to call it "useless" only because it didn't work for you when you tried it for the first time?

    I'd like to point you to the user's mailing list if you have problems like this.
  12. Ladislav Ezr on Sun Sep 30 10:01:16 2012:
    > SMN

    Well, when photos I do for living are rendered with pink everywhere I call that app useless :P But you are right, everything else is 100% working.

    I will open bug as soon as possible. I did a little bit of googling and it seems that it should be fixed in 1.0.3? O_o Sunno, maybe the version in PPA Plus is just compiled with error.

    BTW this is exactly why there should be DONATE button, so devs could buy/rent different cameras and test them with Darktable...
  13. This feature sounds great! Just what I was looking for.

    Question: I have a bunch of RAW + JPEG imports that predate this feature, and the grouping doesn't seem to be automatically applied for those. Is there a way to group existing R+J after the fact? Or do I need to manually go back and group them with ctrl+g?
  14. I am afraid that you have to group them manually. Or remove them from darktable and reimport them. That should work, too.
  15. A "synchronization" option is missing for me the most. A photo copy of the settings applied to other existing image. Focus Bracketing option is very useful.
  16. Thanks guys, I found the solution intervene.
    Thanks for your software and are working on it. Great software!