Warning, /documentation/digikam-doc/setup_application/views_settings.rst is written in an unsupported language. File is not indexed.
0001 .. meta:: 0002 :description: digiKam Views Settings 0003 :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, setup, configure, icon-view, tree-view, preview, full-screen, mime-type, categories 0004 0005 .. metadata-placeholder 0006 0007 :authors: - digiKam Team 0008 0009 :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html) 0010 0011 .. _views_settings: 0012 0013 Views Settings 0014 ============== 0015 0016 .. contents:: 0017 0018 With this settings page, you can customize by the following groups of settings for the Views of digiKam as Albums tree-view, Tags tree-view, icon-view, preview, full-screen, etc. 0019 0020 .. _iconview_settings: 0021 0022 Icon Settings 0023 ------------- 0024 0025 .. figure:: images/setup_album_iconview.webp 0026 :alt: 0027 :align: center 0028 0029 The digiKam Icon-View Configuration Page 0030 0031 The first series of settings on the left side of this view allows to customize the technical information shown below the icon thumbnail, as the filename, the file size, the creation date, the image dimensions, and the aspect ratio. 0032 0033 The **Show file modification date** option shows the file modification date only if it's different from the creation date. This function is useful to identify quickly which items have been modified. 0034 0035 On the right side, the options allows to customize other properties to show over and below the icon thumbnail, as the **Image Format**, the **Title**, the **Caption**, the **labels**, and the **Rating**. 0036 0037 The **Show rotation overlay buttons** option shows overlay buttons over the image thumbnail to be able to process left or right image rotation. 0038 0039 The **Show fullscreen overlay button** option shows an overlay button over the image thumbnail to open it in fullscreen mode. 0040 0041 The **Show Geolocation Indicator** option shows an icon over the image thumbnail if the item has geolocation information. 0042 0043 An example of an icon-view item is given below: 0044 0045 .. figure:: images/setup_album_iconview_item.webp 0046 :width: 500px 0047 :alt: 0048 :align: center 0049 0050 An Icon-View Item Example **Using Large Thumbnail Size** Option 0051 0052 On the bottom side of this settings panel, you can tune the behavior of the icon with user actions. 0053 0054 .. _thumbnails_action: 0055 0056 The **Thumbnail click action** option allows to choose what should happen when you click on a thumbnail. Four settings are available: 0057 0058 - **Show preview** to display the item in Preview Mode :kbd:`F3`. 0059 0060 - **Start image editor** to open the image in a separate Image Editor window :kbd:`F4`. 0061 0062 - **Show on Light Table** top open the image in a separate Light Table window. 0063 0064 - **Open with Default Application** to open item in default desktop application. 0065 0066 .. _iconview_font: 0067 0068 The **Icon View font** option allows to select the font used to display text under icon-view items. 0069 0070 .. _thumbnails_resolution: 0071 0072 The **Use large thumbnail size for high screen resolution** option renders the icon-view items with large thumbnail size, for example in case of 4K monitor is used. By default this option is turned off and the maximum thumbnail size is limited to 256 x 256 pixels. When this option is enabled, the thumbnail size can be extended to 512 x 512 pixels. This option will store more data in the thumbnail database and will use more system memory. digiKam needs to be restarted for the option to take effect and the :ref:`Rebuild Thumbnails <maintenance_thumbnails>` option from the **Maintenance Tools** dialog needs to be processed over all collections. 0073 0074 .. _treeview_settings: 0075 0076 Tree View Settings 0077 ------------------ 0078 0079 These settings allows to customize the tree views of the Left and Right Sidebar. 0080 0081 The **Tree View icon size** option configures the size in pixels of the Tree View icons in digiKam's sidebars. Use large value for HiDPI screen. 0082 0083 The **People Tree View icon size** option configures the size in pixels of the Tree View icons in digiKam's people sidebar. 0084 0085 .. _treeview_font: 0086 0087 The **Tree View font** option sets the font used to display text in nested album hierarchies. 0088 0089 The option **Show a count of items in Tree Views** will display the number of items inside a folder or assigned to a tag behind the album/tag name. The count shown depends on whether the subfolders/-tags are folded out or not and on the :menuselection:`View --> Include Album Sub-Tree` and the :menuselection:`View --> Include Tag Sub-Tree` settings in the main menu. 0090 0091 .. figure:: images/setup_album_treeview.webp 0092 :alt: 0093 :align: center 0094 0095 The digiKam Tree-View Configuration Page 0096 0097 .. _preview_settings: 0098 0099 Preview Settings 0100 ---------------- 0101 0102 Instead of opening the image in the editor, the digiKam preview mode :kbd:`F3` will show the image within the main window in the Image Area. The advantage of the preview is that it is faster than opening the image editor and that the icons of the other images remain visible so that you are able to review the list of current images quickly. Depending on your computer features, you can customize the best way to load images into the preview. Raw files can be processed differently, as this kind of container can require long computation. 0103 0104 The option **Preview shows embedded view if available** will try to open a small version of the photograph embedded in the file. It will be found in all RAW files and can be found in all files that support IPTC or XMP like PNG, JPEG, TIFF, JPEG2000, PGF. If an embedded preview cannot be found some image decoders (JPEG, JPEG2000, and PGF, WebP) are able to create a reduced version of the photograph by themselves which is still faster than using the whole image. Depending on the size of the image, the size of the embedded preview and the size available for the preview on your screen the effect of this option can be visible or not. 0105 0106 The option **Preview shows the full image** will always use the full image data for the preview regardless of whether there is a reduced version embedded in the file or not. This can result in a better quality of the preview but is usually slower. 0107 0108 Only if the last option is checked, the drop down field to the right of **Raw images** is accessible. It offers three options: with **Automatic** selected, the Libraw decoder will decode the RAW data automatically without any adjustments from the user. This may lead to weird results sometimes. The algorithm also takes screen resolution and CPU speed into account to achieve an optimum regarding speed and rendering quality. **Embedded preview** will try to use the (JPEG) preview embedded in RAW files. **Raw data in half size** will show unprocessed RAW data in reduced size. 0109 0110 The option **Preview image is converted to 8 bits for a faster viewing** must be unchecked if you do not want to convert a 16 bits preview image to 8 bits. This will improve performances. 0111 0112 The option **Preview image is always scaled to fit to window** will enlarge the image to always fit the free space available on the canvas. More precisely, fit to window want means that it would scale larger images smaller to fit, as well as scale smaller images larger to fit. For small image, the enlargement can introduce artifacts. If you don't like to see small images enlarged, leave this option off. 0113 0114 The option **Show icons and text over preview** will show elements for rotation, face tags, full screen mode, etc. in the top left corner of the image preview and a text indicating which data the preview is showing in the top right corner. 0115 0116 .. figure:: images/setup_album_preview.webp 0117 :alt: 0118 :align: center 0119 0120 The digiKam Preview Configuration Page 0121 0122 Full-Screen Settings 0123 -------------------- 0124 0125 The options in this tab apply only to the Full Screen Mode you can access via the Full Screen button on the Toolbar or via :menuselection:`View --> Full Screen Mode` :kbd:`Ctrl-Shift-F` in the main menu or the context menu. It does not apply to the Full Screen Mode you access by clicking the “Show Fullscreen” icon either on a thumbnail or on the preview. 0126 0127 .. figure:: images/setup_album_fullscreen.webp 0128 :alt: 0129 :align: center 0130 0131 The digiKam Full-Screen Configuration Page 0132 0133 If first option is activated the only way to leave the Full Screen Mode is the context menu, the keyboard shortcut :kbd:`Ctrl-Shift-F`. You can work on the images also by choosing functions from the context menu of an icon or the preview. 0134 0135 .. _mime_types_settings: 0136 0137 Mime Types Settings 0138 ------------------- 0139 0140 digiKam can understand lots of different image file types as well as some video and audio formats. To control which types of files digiKam will try to display you can add or remove file extensions from these lists. Any files that are in the digiKam Album folders that do not match these extensions will be ignored by digiKam. 0141 0142 .. note:: 0143 0144 The default settings can be easily restored by clicking on the update buttons to the right of each category. 0145 0146 .. figure:: images/setup_album_mimetypes.webp 0147 :alt: 0148 :align: center 0149 0150 The digiKam Mime-Type Configuration Page 0151 0152 You can add the extensions of image files (including RAW files) to be displayed in the Album view. Just put **xyz abc** to display files with the **xyz** and **abc** extensions in your Album view. You can also remove file formats that are shown by default by putting a minus sign in front of the extension: e.g. **-gif** would remove all GIF files from your Album view and any trace of them in your database. They would not be deleted, just not shown in digiKam. 0153 0154 .. warning:: 0155 0156 Removing files from the database means losing all of their tags and ratings. 0157 0158 Album Categories Settings 0159 ------------------------- 0160 0161 In the Album View you can choose from :menuselection:`View --> Sort Albums --> By Category` to have the Albums in the Album Tree of the Left Sidebar sorted by category. Here you can manage these categories, which is **Add** or **Remove** categories or rename them by using the **Replace** button. To assign categories to an Album you got to use the Album Properties dialog. 0162 0163 .. figure:: images/setup_album_categories.webp 0164 :alt: 0165 :align: center 0166 0167 The digiKam Album Categories Configuration Page