Warning, /documentation/digikam-doc/maintenance_tools/maintenance_newitems.rst is written in an unsupported language. File is not indexed.
0001 .. meta:: 0002 :description: digiKam Maintenance Tool to Scan for New Items 0003 :keywords: digiKam, documentation, user manual, photo management, open source, free, learn, easy, maintenance, scan, new, items 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 .. _maintenance_newitems: 0012 0013 Scan for New Items 0014 ================== 0015 0016 .. contents:: 0017 0018 .. figure:: images/maintenance_new_items.webp 0019 :alt: 0020 :align: center 0021 0022 The digiKam Maintenance Options to Scan for New Items 0023 0024 This process will scan the collections you defined in :menuselection:`Settings --> Configure digiKam...` and the **Collections** dialog page, i.e. image files you added to your collections while digiKam was not running. You can run this process also automatically on digiKam startup by checking Scan for new items at startup in :menuselection:`Settings --> Configure digiKam...` and the **Miscellaneous** dialog page. 0025 0026 While the scan for new items process is under progress, notification on the bottom right of main windows will be visible to indicate the amount of items already done. 0027 0028 .. figure:: images/maintenance_scan_process.webp 0029 :alt: 0030 :align: center 0031 0032 The Scan for New Items Process working in the background 0033 0034 .. note:: 0035 0036 This process can also be directly called by the main menu, From :menuselection:`Tools --> Scan for New Items` to scan all collections. 0037 0038 This process can be also called automatically at startup using the **Scan for new items at startup** option in :menuselection:`Setting --> Configure digiKam...` and the **Behavior** tab from the **Miscellaneous** dialog page. Take a care that scanning for new items at startup can take a while and slow-down application initialization. 0039 0040 To be precise, this option will 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 status-bar 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. 0041 0042 Another option from this setup panel named **Fast scan (detects new, deleted and renamed items)** can also be turn on 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. 0043 0044 .. figure:: images/maintenance_scan_setup.webp 0045 :alt: 0046 :align: center 0047 0048 The digiKam Options to Scan for New Items from the Setup Dialog 0049 0050 .. note:: 0051 0052 To identify files quickly and register items changes in database while scanning, digiKam uses a hash. This is not a full hash of the file for performance reasons, but it's reliable enough. The file size is therefore included. digiKam uses these parameters to try to find files again during a scan if they have been moved or renamed externally. To have a scan process the most efficient, we recommend doing file operations within digiKam, not by an external application as a file manager.