darktable page lede image
darktable page lede image

Star ratings and color labels

2.2.4. Star ratings and color labels

Star ratings and color labels help you to sort and rank images according to your own criteria. An image's star rating and its color labels are displayed in the thumbnail.

You can give a rating from zero to five stars to an image. The quality criteria which lead to a rating are fully up to you. Whenever you import images, each image receives a default rating which you can define in import options (see Section 8.2.1, “import”). You can later revise the rating at any time. You can also mark an image as rejected by pressing the icon or typing the R key. This will remove all stars. You can reverse the rejection by applying a new star rating.

There are several ways to change a rating. While hovering the cursor over an image thumbnail, you can press a number key 0 – 5 for the number of stars, or type R to reject an image; this is probably the fastest way when rating your images on first inspection of a film roll.

You can also directly click on the stars displayed in the thumbnails; click the x to reject, click the fifth star to get a rating of five stars, etc. Clicking either the x or the first star for a second time resets the image rating to unranked, or zero stars. The latter behavior can be changed in the lighttable options dialog (see Section 8.3, “Lighttable”).

To rate one or more images at once, select those images (see Section 2.3.7, “Select”) and then press the key for your rating, or click the desired star rating in the bottom panel of the lighttable view.

Color labels are another way to sort images, and can be used as an alternative to star ratings or work alongside star ratings. Each image can carry any combination of one or more color labels in red, yellow, green, blue, and purple.

You can set the color labels for a single image by hovering your cursor over the thumbnail and pressing the function keys F1 – F5, which correspond with the labels in the order given above.

To toggle the color labels of one or more images, select the desired images (see Section 2.3.7, “Select”) and then press the corresponding color button in the bottom panel. To remove all labels from the selected images, press the grey button.