Warning, /documentation/digikam-doc/setup_application/miscs_settings.rst is written in an unsupported language. File is not indexed.

0001 .. meta::
0002    :description: digiKam Miscellaneous Settings
0003    :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, setup, configure, miscs, behavior, appearance, spellcheck, localize, grouping, system, updates
0005 .. metadata-placeholder
0007    :authors: - digiKam Team
0009    :license: see Credits and License page for details (https://docs.digikam.org/en/credits_license.html)
0011 .. _miscs_settings:
0013 Miscellaneous Settings
0014 ======================
0016 .. contents::
0018 These settings group all application rules customizable by users but not covered in previous setting categories from the setup dialog.
0020 .. _behavior_settings:
0022 Behavior Settings
0023 -----------------
0025 Scan Operations
0026 ~~~~~~~~~~~~~~~
0028 .. figure:: images/setup_miscs_behavior.webp
0029     :alt:
0030     :align: center
0032     The digiKam Behavior Configuration Page
0034 Set the option **Scan for new items at startup** to force digiKam to scan all collections for new items to register new elements in database. The scan is performed in the background through the progress manager available in the statusbar when digiKam main interface is loaded. If your computer is fast enough, this will have no effect on usability of digiKam while scanning. If your collections are huge or if you use a remote database, this can introduce low latency, and it is recommended to disable this option and to plan a manual scan through the maintenance tool at the right moment.
0036 Set the option **Fast Scan** to significantly speed up the scan. New items, deleted and also renamed items are found. In order to find items that have been changed, this option must be deactivated.
0038 **Detect faces in newly added images** option will perform automatically a face detection on items imported to the collections.
0040 Set the option **Remove obsolete core database objects** to force digiKam to clean up the core database from obsolete item entries. Entries are only deleted if the connected item file was already removed, i.e. the database object wastes space. This option does not clean up other databases as the thumbnails or recognition db. For clean up routines for other databases, please use the maintenance tool. Take a care that option slow down startup stages.
0042 .. _genericrules_settings:
0044 Generic Rules
0045 ~~~~~~~~~~~~~
0047 With the **Confirm when moving items to trash** and **Confirm when permanently deleting items** settings you can set the verbosity of digiKam when you delete a photograph or an Album. See the :ref:`Deleting a Photograph <deleting_photograph>` and the :ref:`Deleting an Album <deleting_album>` sections for more details.
0049 The editorial changes done through the right sidebar can be quietly applied by digiKam when setting the **Do not confirm when applying changes in the right sidebar** option. Otherwise the changes must be applied by pressing the **Apply changes** button.
0051 The option **Show only face tags for assigning names in people sidebar** will restrict people tree-view contents to face tags available when you assign a name to an **Unconfirmed** face. If you want to learn more details about face management, take a look to :ref:`this section of the manual <people_view>`.
0053 The option **Expand current tree item with a single mouse click** allows to customize how the mouse button will be used to expand a nested album branch.
0055 With the **Scroll current item to center of thumbbar** setting, you can force thumbbar to center current selected item with mouse pointer on the center of visible area.
0057 The **Get album date source** option allows to adjust the album date depending on the option set when new items are found during scanning. Possible values are:
0059     - **From The Newest Item Date**: to take the date from the newest item hosted in album.
0060     - **From The Oldest Item Date**: to take the date from the oldest item hosted in album.
0061     - **From The Average Date**: to compute the date from an average of all items hosted in album.
0062     - **From The Folder Date**: to take the file system date.
0063     - **No Change Of Date**: do not modify the date.
0065 With the **String comparison type** setting, you can set the way in which strings are compared inside digiKam. This influences the sorting of the tree views. Possible values are:
0067     - **Natural** tries to compare strings in a way that regards some normal conventions. The result will be sort naturally even if they have a different number of digits inside.
0068     - **Normal** uses a more technical approach. Use this style if you want to entitle albums with ISO dates (as *201006* or *20090523*) and the albums should be sorted according to these dates.
0070 With the **Lower bound for minimum similarity** option, you can select the lower bound of the minimum similarity threshold for fuzzy and duplicates searches. The default value is 40. Selecting a lower value than 40 can make the search really slow.
0072 .. _updates_settings:
0074 Application Updates
0075 ~~~~~~~~~~~~~~~~~~~
0077 The **Updates** settings allows to tune how the check the online availability of a new application version. You can select **Only For Stable Releases** which are official versions safe to use in production. Another choice is **Weekly Pre-Releases** which is proposed to tests quickly new features but not recommended to use in production as bugs can remain.
0079 The option **Use Version With Debug Symbols** allows to download version including debug symbols. This version is more heavy but can help developers to trace dysfunctions in debugger.
0081 Finally, on the bottom, a **Check Now** button allow to send a request for an update. The **Last check** date is indicated on the left side. If a new version is available online, a dialog will appears as below.
0083 .. figure:: images/setup_update_new.webp
0084     :alt:
0085     :align: center
0087     Dialog under Windows When a new digiKam Version is Available Online
0089 From this dialog, press the **Download** button to process. A new progress dialog will appears as below.
0091 .. figure:: images/setup_update_download.webp
0092     :alt:
0093     :align: center
0095     Progress Dialog under Windows to Get the new Version Available Online
0097 When the download is complete, a checksum is computed to be sure that files is not corrupted. If all is fine, a new dialog appears as below.
0099 .. figure:: images/setup_update_install.webp
0100     :alt:
0101     :align: center
0103     Dialog under Windows When Install is Ready to be Processed
0105 Just press **Install** button to process the final stage. The current digiKam session will be closed and installer will be started.
0107 .. note::
0109     AppImage Linux bundle do not require installation on the system. File is downloaded and ready to use. The dialog propose to open desktop files-manager at the download place instead.
0111 .. _appearance_settings:
0113 Appearance Settings
0114 -------------------
0116 .. figure:: images/setup_miscs_appearance.webp
0117     :alt:
0118     :align: center
0120     The digiKam Appearance Configuration Page
0122 With the **Show splash screen at startup** setting, you can switch off the display of the splash screen when application loads. This may speed up the start time slightly.
0124 .. figure:: images/setup_splash_screen.webp
0125     :alt:
0126     :align: center
0128     The Splash Screen Visible at Startup of a digiKam Session
0130 With the **Use native file dialogs from system** setting, you can switch from the basic (but universal) open-file dialog included in the application to the more powerful open-file dialog provided by the desktop.
0132 +-------------------------------------------------------+------------------------------------------------------+
0133 |    .. figure:: images/setup_openfile_basic.webp       |    .. figure:: images/setup_openfile_native.webp     |
0134 |       :alt:                                           |        :alt:                                         |
0135 |       :align: center                                  |        :align: center                                |
0136 +-------------------------------------------------------+------------------------------------------------------+
0137 |       Basic Open-File Dialog under macOS              |        Native Open-File Dialog under macOS           |
0138 +-------------------------------------------------------+------------------------------------------------------+
0140 With the **Draw frames around grouped items** setting, a more visible decoration will be applied to the items grouped in icon-view.
0142 +-------------------------------------------------------+------------------------------------------------------+
0143 |    .. figure:: images/setup_grouped_noframe.webp      |    .. figure:: images/setup_grouped_frame.webp       |
0144 |       :alt:                                           |        :alt:                                         |
0145 |       :align: center                                  |        :align: center                                |
0146 +-------------------------------------------------------+------------------------------------------------------+
0147 |       Icon-View Grouped Items with no Frame           |        Icon-View Grouped Items with Frame            |
0148 +-------------------------------------------------------+------------------------------------------------------+
0150 With the **Sidebar tab title** setting, you can set how sidebars on the sides will show the tab titles. Use **Only For Active Tab** option only if you use a small screen resolution as with a laptop computer. Else **For All Tabs** will be a best choice to discover quickly all internal features of digiKam.
0152 With the **Widget style** setting, you can choose the default application window decoration and looks. **Breeze** style is the best choice for all desktop.
0154 With the **Icon theme** setting, you can choose the default application icon theme. Theme availability depends of desktop used to run digiKam. **Breeze** icons-set is the best choice for all desktop.
0156 Finally, the **Application font** option allow to customize the font to use everywhere in the application. Note that extra options exists also to customize fonts for the :ref:`album tree-view <treeview_font>`, the :ref:`icon-view <iconview_font>`, and the :ref:`tooltip <tooltip_font>`.
0158 .. _grouping_settings:
0160 Grouping Settings
0161 -----------------
0163 .. figure:: images/setup_miscs_grouping.webp
0164     :alt:
0165     :align: center
0167     The digiKam Grouping Configuration Page
0169 This section list the operations to perform on all grouped items depending on the usage context. Operations supported are:
0171     - **Metadata**: when you change information to store in files or in the database.
0172     - **Import/Export Tools**: to import and export items.
0173     - **Batch Queue Manager**: to process all items from a group.
0174     - **Light Table**: to display grouped items when reviewing by pair.
0175     - **Slideshow**: to show all grouped items on the screen.
0176     - **Renaming**: to all items from a group.
0177     - **Tools**: to post process all items from a group.
0179 For each case, you can select if digiKam can:
0181 - **No**: do nothing.
0182 - **yes**: operate items.
0183 - **Ask**: ask to confirm before to continue.
0185 For this last case, a dialog as below will appears during operation. You can remember your choice for the next time, this will adjust the operation settings accordingly.
0187 .. figure:: images/setup_operation_warning.webp
0188     :alt:
0189     :align: center
0191     The Dialog to Warn about Grouped Renaming File Operations
0193 .. _spellcheck_settings:
0195 Spellcheck Settings
0196 -------------------
0198 This section allows to control the spellchecking operations done in background in all text edit widgets.
0200 .. figure:: images/setup_miscs_spellcheck.webp
0201     :alt:
0202     :align: center
0204     The digiKam Spellcheck Configuration Page
0206 Spellcheck can be used on captions, titles, and other text-edit widgets to auto-detect the current language used in text and will propose alternative with miss-spelled words. With entries where alternative-language can be specified, the contextual language will be used to parse text. Spellcheck depends of open-source **Backends**, including **Language Dictionaries**, to operate sentence analysis. Availability of both are listed in this view for information. If you want to add new language or dictionaries, you need to install relevant packages on your system.
0208 .. figure:: images/setup_captions_spellcheck.webp
0209     :alt:
0210     :align: center
0212     The Titles Text Editor from Captions Tab with Spellcheck Feature
0214 The **Default Language** allow to set the language to spellcheck with the *x-default* entry from the alternative-language string. If you select **Auto-detect** value, the string contents will be parsed to determine the language automatically and select the right dictionary for spellchecking. Of course, in all cases the relevant dictionaries must be installed on your computer to see the spellchecking works properly.
0216 You can edit a list of words that Spellcheck must ignore during operations. digiKam already provide a list usual keywords to not verify.
0218 .. _localize_settings:
0220 Localize Settings
0221 -----------------
0223 The Configuration Page
0224 ~~~~~~~~~~~~~~~~~~~~~~
0226 This section allows to customize the rules to translate automatically strings from text editor widgets using online translator engine.
0228 .. figure:: images/setup_miscs_localize.webp
0229     :alt:
0230     :align: center
0232     The digiKam Localize Configuration Page
0234 A list of **Alternative Languages** supported by digiKam is provided where you can select your preferred entries hosted in text editor widgets.
0236 Another list allows to know the **Available Translator Languages**, supported by the selected **Online Translator** engine.
0238 As number of entries are huge for the both lists, a search engine is available and an option to show only the current selection.
0240 Using Strings Localization
0241 ~~~~~~~~~~~~~~~~~~~~~~~~~~
0243 In digiKam, the localization is available in special text editor widgets supporting alternative-languages feature. You can see this kind of widget in the :ref:`Captions tab <captions_view>` from **Right Sidebar** and in the :ref:`XMP Metadata Editor <xmp_editor>` for example.
0245 .. figure:: images/setup_captions_localize.webp
0246     :alt:
0247     :align: center
0249     The Captions Text Editor with Translation Feature
0251 Alternative-languages mean more than one translation available for one string. The **x-default** entry is the native language used as a reference for translations. Typically, it's common to use English words with x-default, but it's not mandatory. When you ask to translate the string, the online translators will be able to auto-detect the current language used with **x-default**.
0253 On the top of a text editor widget, you can select the translation entry for the string. The drop-down menu will only show your preferred languages set on the configuration page. The next button on the right allows clearing the current translated entry. The next drop-down button allows creating of a new translation entry using the configured online translator. Finally, the last button on the right side will show the Localize settings page to customize the translation behavior.
0255 .. _system_settings:
0257 System Settings
0258 ---------------
0260 This section allows to tune special low level configurations used by application. Only change these settings if you know what you do.
0262 .. figure:: images/setup_miscs_system.webp
0263     :alt:
0264     :align: center
0266     The digiKam System Configuration Page
0268 - **Use high DPI scaling from the screen factor**: with this option application will scale coordinates in device independent manner according to display scale factors provided by the operating system. It scales the graphical interface elements (buttons, text, etc.) with the Desktop settings. The digiKam graphical interface elements are therefore displayed larger by this factor and are therefore theoretically just as large as the graphical interface elements of the system.
0270 - **Use pixmaps with high DPI resolution**: with this option, pixmaps sizes used internally by application will have a device-independent layout geometry. It activates high-resolution icons, otherwise the elements in digiKam would look very blurry under high resolutions. Also, it's recommended to use this option in multi-screen context when resolutions are not the same.
0272 - **Disable hardware acceleration OpenCL**: this option will disable GPU accelerations, especially with faces management and image quality sorting. This option affect the `OpenCV <https://opencv.org/>`_ engine used in background for the intensive computation on images. To see the OpenCV configuration, go to :menuselection:`Help --> Components Information` menu entry, and :ref:`OpenCV section from the dialog <help_componentsinfo>`.
0274 - **Enable internal debug logging**: this option will turn on the debug traces on the console used to investigate dysfunctions. Under Linux and macOS, just start the application from a console to show the messages. Under Windows, you needs an extra Microsoft application named `DebugView <https://learn.microsoft.com/sysinternals/downloads/debugview>`_ to display the messages. The default settings from DebugView is enough to capture the traces from the application.
0276 .. figure:: images/setup_miscs_system_debugview.webp
0277     :alt:
0278     :align: center
0280     digiKam Running Under Windows With DebugView
0282 - **Download Face Engine Data**: With this button you can load face engine deep-learning model files if you pass this stage at first-run.