Darktable keyboard shortcuts - best practices

Software darktable
21

Wasn’t meant as criticism, sorry.

22

That’s also useful, thanks.

Or maybe I just don’t understand how it works well enough. As you see the are a lot of things that I didn’t know or had misunderstood.

23

There are also not enough people reviewing (or perhaps you include that in writing). This is not a criticism of anyone, but when doc PRs sit for months without review it is difficult to feel motivated to write more.

3 Likes
24

Also because the bigger we make it (the shortcuts section specifically) the more people will give up reading it. I don’t know how to make it both comprehensive and easy to understand (and I still don’t understand a lot of it myself). So I tried to find a happy medium. IMO if we’re going to add more to it, we might be better off creating a separate “advanced use” page or something.

1 Like
25

In some ways, reviewing is harder than writing, because we still need to verify what’s written and engage in back-and-forth when things aren’t clear. I will try to find some time before the next release to do some more reviews / write some more content.

1 Like
26

Absolutely agree. No-one should feel pressured into reviewing!

27

Apologies if this is known to many, but it’s not clear to me.

If I wanted to try to improve some parts of docs, would I just go the PR way or is there a different process in place?

This page explains how the docs should be written, but not how contributions should be delivered.

28

Yes, a PR is the way to go.

1 Like
29

There is a step-by-step guide here: A plea for help writing the docs - #22 by hatsnp

And a list of darktable issues needing docs can be found here: Pull requests · darktable-org/darktable · GitHub

2 Likes
30

Thanks.

If they are not already there (and I did not find them) I would add these pointers to the docs so that this information is more discoverable.

31

Why not make that your first PR?

32

:+1:

33
2 Likes
34

One small additional tweak: Set a shortcut for the search bar (I chose STRG+F; I never use it to hide the bottom bar). This saves me fiddeling with the mouse to get to the search bar (action is named “search modules”).

3 Likes
35

I use Ctrl-L for that, like the browser’s address bar.

2 Likes
36

I use / because I am nerdier :stuck_out_tongue:

2 Likes
37

I tried to set up a shortcut 1 for two actions:
for: 1=views/thumbtable/rating;one
and another for: 1=iop/blend/shapes/add circle

But darktable does not seem to like that and omits one of them. Individually those work.

It is - as far as I understood - perfectly possible to apply the same shortcut to different views.

Is it meant to be that the shortcuts I tried are not allowed together?

Kind regards, Jetze

1 Like
38

I think the rating shortcuts might be global (affect multiple views)

1 Like
39

You can rate items while in the darkroom, so I would say that the two shortcuts are incompatible. When you are in the darkroom and you press one, what should happen? Rate the image or add a circle to the drawn mask?

Edit: I think that views/thumbtable/ is a bit of a misnomer for the action, as the thumbtable is actually displayed in the darkroom view. Maybe it should be renamed?

1 Like
40

Thanks both for replies. I guess you both are right. I never rate in darkroom but that’s only me.

How to see/know a shortcut is global or not?

Kind regards, Jetze