Chapter 2. Lighttable

The lighttable is where you manage all your images, ratings, export and much more.

2.1. Overview

In the central view, your images are shown as thumbnails, surrounded by a frame. When the mouse is over an image, its rating and color labels are shown in the frame, along with an indicator of whether the image has already been altered in darkroom. Also, when the mouse hovers over an image frame, image information (EXIF data, metadata) is shown in the image information panel at the bottom left.

While the mouse is over an image frame, there are a number of actions you can perform. Here is a table of keyboard shortcuts and assigned actions.

0 – 5 set the rating of the image; if an image has 1 star and you hit the 1 key, the image will be unrated. Pressing r rejects the image.
F1 – F5 set a color label
ctrl-c copy the history stack
ctrl-v paste the copied history stack
d open in darkroom view for developing
z fully zoom into the image while the key is pressed
ctrl-z fully zoom into the image and show areas in focus

The overlay button located in the upper panel activates the permanent display of star ratings and image-changed indicator on all thumbnails. By default these overlays are only visible on the thumbnail under the mouse cursor. An overlay button is also available in the other views where it affects the filmstrip accordingly (see Section 1.2.3, “Filmstrip” and Section 3.3.9.7, “Filmstrip”).

Pressing the button on the right side of the bottom panel lets you define the color profile of your monitor. You can either set this to system display profile (default) and let darktable enquire the system's display profile, or alternatively set it to one of the ICC profiles located in $DARKTABLE/share/darktable/color/out and $HOME/.config/darktable/color/out. $DARKTABLE is used here to represent your chosen darktable installation directory and $HOME your home directory. For more details on color management see Section 3.2.10, “Color management”.

In the center of the bottom panel you have an option to choose between zoomable lighttable view or filemanager view of the thumbnails. In zoomable lighttable view, scroll with your mouse wheel to zoom in and out. Moving the mouse while pressing the left mouse button allows you to navigate through your collection. In filemanager view, you can can change the number of images in each row, using the slider next to the filemanager option, or by using ctrl-(mouse wheel). Use your mouse wheel to navigate through your collection.

In both modes you can navigate left/right/up/down through your collection using ←/→/↑/↓. Pressing g in filemanager mode goes to the top, shift-g to the bottom, PageUp brings you one page up and PageDown one page down.

You can select the image under the pointer by left-clicking on its thumbnail or by pressing return. A range of images is selected by clicking on the first one and then shift-clicking on the last one. Images are added or removed from your selection by ctrl-clicking on their thumbnails or pressing space.

To locate where you are in a collection, there are indicators at the extreme borders of the window: left/right for your position when you are in filemanager mode, left/right and top/bottom for your vertical and your horizontal position, respectively, when you are in the zoomable lighttable view.

While holding down the z key a fully zoomed preview of the image under the mouse cursor is displayed. You can use this feature for a quick inspection of image quality while rating and selecting images.

Holding down the ctlr-z key fully zooms into the image and additionally activates an analysis for sharp regions, detecting those parts of the image that are in focus. Areas of high sharpness are indicated by a red border – the higher the color intensity the better the sharpness. In case that no area of high sharpness is detected darktable indicates areas of moderate sharpness with a blue border. For this tool to work the input image needs to hold an embedded JPEG thumbnail which is the case for most raw files.

Sometimes pressing z or ctrl-z may not reveal an immediate effect – in that case please click into the center area and press the corresponding key again.

Fully zoomed-in image view while holding down the ctrl-z key with indication of the sharp areas in focus. Sharpness detection is based on an embedded JPEG thumbnail of the original raw file independent of any processing steps within darktable.