Documentation on digiKam

Documentation on digiKamhttps://www.digikam.org/documentation/Recent content in Documentation on digiKamHugoen-usFri, 21 Nov 2025 00:00:00 +0000FAQshttps://www.digikam.org/documentation/faq/Fri, 21 Nov 2025 00:00:00 +0000https://www.digikam.org/documentation/faq/<h1 id="table-of-contents"><img src="https://www.digikam.org/img/content/icons/toc.webp" width="30" height="30" /> Table of Contents</h1> <ul> <li><a href="#import-tool">Import Tool</a> <ul> <li><a href="#my-camera-is-not-in-the-list-of-supported-devices">My camera is not in the list of supported devices</a></li> <li><a href="#how-to-use-a-usb-mass-storage-camera">How to use a USB Mass Storage Camera</a></li> <li><a href="#why-do-i-get-an-error-no-default-album-selected-to-process-download">Why Do I Get an Error: “No Default Album Selected to Process Download”?</a></li> </ul> </li> <li><a href="#run-time-issues">Run Time Issues</a> <ul> <li><a href="#why-is-my-nvidia-gpu-not-recognized-under-windows-as-a-compatible-device-with-the-opencl-accelerator-for-ai-models">Why Is My NVIDIA GPU Not Recognized Under Windows as a Compatible Device with the OpenCL Accelerator for AI Models?</a></li> <li><a href="#why-does-video-playback-in-digikam-on-windows-have-no-sound">Why Does Video Playback in digiKam on Windows Have No Sound?</a></li> <li><a href="#why-is-digikam-can-be-slow-or-unresponsive-under-windows">Why is digiKam Can be Slow or Unresponsive Under Windows?</a></li> <li><a href="#digikam-freezes-at-startup-with-or-without-main-window">digiKam Freezes at Startup With or Without Main Window</a></li> <li><a href="#thumbnail-generation-fails-on-large-files">Thumbnail Generation Fails on Large Files</a></li> <li><a href="#why-are-my-raw-images-so-dark">Why are my RAW images so dark?</a></li> <li><a href="#some-properties-in-sidebar-are-unknown-or-unavailable">Some Properties in Sidebar are Unknown or Unavailable</a></li> <li><a href="#how-can-i-inform-you-about-bugs-and-wishes">How can I inform you about bugs and wishes?</a></li> <li><a href="#what-can-i-do-if-digikam-always-crashes-when-doing-something">What can I do if digiKam always crashes when doing something?</a></li> <li><a href="#how-to-deal-with-utf-8-encoding-issues">How to deal with UTF-8 encoding issues?</a></li> <li><a href="#exiftool-not-found-at-startup">ExifTool not Found at Startup</a></li> <li><a href="*heif-metadata-not-updated">HEIF Metadata Not Updated</a></li> </ul> </li> <li><a href="#database">Database</a> <ul> <li><a href="#digikam-does-not-work-when-the-album-library-is-on-a-network-share">digiKam does not work when the album library is on a network share</a></li> <li><a href="#how-to-import-tags-from-another-program">How to Import Tags from Another Program?</a></li> <li><a href="#how-to-migrate-a-database-between-different-computers">How to Migrate a Database Between Different Computers?</a></li> <li><a href="#why-low-performances-when-processing-items-in-parallel-on-windows-with-mysql-or-mariadb">Why Low Performances When Processing Items in Parallel on Windows With MySQL or MariaDB?</a></li> </ul> </li> <li><a href="#customizations">Customizations</a> <ul> <li><a href="#how-to-create-a-color-theme">How to create a color theme?</a></li> <li><a href="#how-can-i-change-the-default-external-video-player">How can I change the default external video player?</a></li> <li><a href="#how-can-i-change-the-text-font-size">How can I change the text font size?</a></li> <li><a href="#how-to-change-the-single-click-behavior-on-a-thumbnail">How to change the single-click behavior on a thumbnail?</a></li> <li><a href="#how-can-i-change-the-browser-used-with-the-more-info-button-from-the-map-sidebar">How can I change the browser used with the More Info button from the map sidebar?</a></li> <li><a href="#is-digikam-available-in-my-language">Is digiKam available in my language?</a></li> </ul> </li> <li><a href="#setup">Setup</a> <ul> <li><a href="#why-does-digikam-display-google-maps-with-a-for-development-only-overlay">Why Does digiKam Display Google Maps With a “for development only” Overlay?</a></li> <li><a href="#why-does-digikam-show-a-location-not-found-error">Why Does digiKam Show a “Location not Found” Error?</a></li> <li><a href="#why-are-many-data-files-downloaded-at-application-startup">Why Are Many Data Files Downloaded at Application Startup?</a></li> <li><a href="#why-download-of-data-files-fails-at-application-startup">Why Download of Data Files Fails at Application Startup?</a></li> <li><a href="#where-are-all-configuration-files-used-by-digikam-located">Where Are All Configuration Files Used by digiKam Located?</a></li> <li><a href="#why-do-macos-and-windows-warn-about-non-signed-bundles">Why Do macOS and Windows Warn About Non-Signed Bundles?</a></li> </ul> </li> <li><a href="#workflow">Workflow</a> <ul> <li><a href="#how-to-include-or-exclude-an-album-and-all-its-sub-albums-in-digikam">How to Include or Exclude an Album and All Its Sub-Albums in digiKam?</a></li> <li><a href="#which-file-format-should-i-use">Which File Format Should I Use?</a></li> <li><a href="#how-to-copy-files-outside-the-digikam-collection">How to Copy Files Outside the digiKam Collection?</a></li> <li><a href="#how-can-i-ignore-or-remove-multiple-detected-faces-at-once-in-digikam">How Can I Ignore or Remove Multiple Detected Faces at Once in digiKam?</a></li> <li><a href="#why-are-my-small-or-low-resolution-images-with-faces-being-ignored">Why Are My Small or Low-Resolution Images With Faces Being Ignored?</a></li> <li><a href="#where-can-i-find-the-list-of-internal-keyboard-shortcuts">Where Can I Find the List of Internal Keyboard Shortcuts?</a></li> <li><a href="#how-can-i-display-more-photo-properties-in-icon-view">How Can I Display More Photo Properties in Icon View?</a></li> <li><a href="#does-digikam-support-non-latin-scripts-and-special-characters">Does digiKam Support Non Latin Scripts and Special Characters?</a></li> </ul> </li> <li><a href="#contribute">Contribute</a> <ul> <li><a href="#digikam-does-not-compile">digiKam does not compile</a></li> <li><a href="#digikam-mixes-english-and-my-native-language-in-the-main-menu">digiKam Mixes English and My Native Language in the Main Menu</a></li> <li><a href="#a-section-of-the-documentation-is-incomplete-or-does-not-exist-yet">A Section of the Documentation Is Incomplete or Does Not Exist Yet</a></li> </ul> </li> </ul> <p><strong>🟠 Skill Level:</strong> INTERMEDIATE</p>Release Plan & Changeloghttps://www.digikam.org/documentation/releaseplan/Sun, 25 Mar 2018 00:00:00 +0000https://www.digikam.org/documentation/releaseplan/<h1 id="table-of-contents"><img src="https://www.digikam.org/img/content/icons/toc.webp" width="30" height="30"/> Table of Contents</h1> <ul> <li><a href="#digikam-version-9-2026-202x">digiKam Version 9</a></li> <li><a href="#digikam-version-8-2023-2025">digiKam Version 8</a></li> <li><a href="#digikam-version-7-2020-2022">digiKam Version 7</a></li> <li><a href="#digikam-version-6-2018-2019">digiKam Version 6</a></li> <li><a href="#digikam-version-5-2016-2018">digiKam Version 5</a></li> <li><a href="#digikam-version-4-2014-2015">digiKam Version 4</a></li> <li><a href="#digikam-version-3-2012-2013">digiKam Version 3</a></li> <li><a href="#digikam-version-2-2011-2012">digiKam Version 2</a></li> <li><a href="#digikam-version-1-2009-2010">digiKam Version 1</a></li> <li><a href="#digikam-former-versions-2001-2008">digiKam Former Versions</a></li> </ul> <p><strong>🟠 Skill Level:</strong> INTERMEDIATE</p> <hr> <h2 id="digikam-version-9-2026-202x"><img src="https://www.digikam.org/img/content/icons/09.webp" width="30" height="30"/> digiKam Version 9 [2026-202x]</h2> <table> <thead> <tr> <th>Release Date</th> <th>Version</th> <th>Bugzilla Files Closed</th> <th>Changelog and New Features</th> </tr> </thead> <tbody> <tr> <td>2026.06.07</td> <td>9.1.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=9.1.0">104</a></td> <td><ul><li><strong>Import:</strong> USB Mass Storage driver now supports video thumbnails.</li><li><strong>Advanced Search:</strong> Added “Clear All Groups” button in the SearchView interface.</li><li><strong>Preview:</strong> Added support for Pixel motion photos (short videos embedded in pictures taken on Google Pixel phones) and improved audio output selection for the video media player.</li><li><strong>Database:</strong> Schema updated to support time-zone with registered item time-stamps.</li></ul></td> </tr> <tr> <td>2026.03.08</td> <td>9.0.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=9.0.0">402</a></td> <td><ul><li><strong>Qt6 Migration:</strong> Full port to Qt 6.10.1 (AppImage/macOS) and Qt 6.9.1 (Windows) with KDE Frameworks 6.20.0.</li><li><strong>New Cameras:</strong> Libraw 20260215 adds 1200+ models (Canon EOS R1, Fujifilm GFX 100S II, Leica Q3, Nikon Z6-III, Sony A9-III, DJI/Skydio drones).</li><li><strong>Survey Tool:</strong> New separate window for efficient item review with full preview features.</li><li><strong>UI/UX:</strong> Customizable date format, modern welcome page, 3-tab filters (Properties, Tags, People), customizable color labels, regex for ignored directories.</li><li><strong>Sorting & Search:</strong> New sort options (Pick/Color Labels, Orientation, GPS, File Format) and advanced search (empty properties, Creator/Author dropdowns, recently modified items).</li><li><strong>Editor:</strong> Marching-ants selection effect and histogram indicators for Curves/Levels/White Balance.</li><li><strong>Geolocation:</strong> Bulk coordinate editing, GPS icon opens Geolocation tab.</li><li><strong>Website:</strong> Major redesign with new screenshots, descriptions, and updated content.</li></ul></td> </tr> </tbody> </table> <h2 id="digikam-version-8-2023-2025"><img src="https://www.digikam.org/img/content/icons/08.webp" width="30" height="30"/> digiKam Version 8 [2023-2025]</h2> <table> <thead> <tr> <th>Release Date</th> <th>Version</th> <th>Bugzilla Files Closed</th> <th>Changelog and New Features</th> </tr> </thead> <tbody> <tr> <td>2025.10.19</td> <td>8.8.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=8.8.0">106</a></td> <td><ul><li><strong>Tags Manager</strong>: added a new tool to import/export tags hierarchy from text file.</li> <li><strong>Focus Points</strong>: new camera supported.</li> <li><strong>Color Management</strong>: Windows/macOS/Wayland screen color profiles supported.</li> <li><strong>Image Editor</strong>: new tool to blur the subject background and simulate the depth-of-field of a lens.</li> <li>G’Mic-Qt 3.6 support.</li></ul></td> </tr> <tr> <td>2025.06.30</td> <td>8.7.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=8.7.0">241</a></td> <td><ul><li>Introduced a new AI based auto-rotation tool.</li> <li>Enhanced OpenCV/OpenCL/Cuda support with deep-learning engine.</li> <li>Background <strong>Face Recognition</strong> at new face tag assigned.</li> <li>Introduced a new G’Mic generic plugin working in layer mode.</li></ul></td> </tr> <tr> <td>2025.03.16</td> <td>8.6.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=8.6.0">136</a></td> <td><ul><li>Classiffiers and Model Pipelines complete rewrite with better performances and Face Image Quality Assessment (FIQA) used by <strong>Face Management</strong> and <strong>Auto-tags</strong>.</li> <li><strong>Auto-tags</strong> and <strong>Image Quality Sorting</strong> scan options integrated in left sidebar tabs.</li></ul></td> </tr> <tr> <td>2024.11.16</td> <td>8.5.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=8.5.0">173</a></td> <td><ul><li><strong>Bundles</strong> : first <em>Native Apple Silicon Arm64 Package</em> based on Qt and KDE version 6 frameworks.</li> <li><strong>Face Detection</strong>: introduced a new default YuNet DNN model.</li> <li><strong>Face Recognition</strong>: introduced a new default SFace face recognition DNN model.</li></ul></td> </tr> <tr> <td>2024.07.14</td> <td>8.4.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=8.4.0">170</a></td> <td><ul><li><strong>Batch Queue Manager</strong>: new GMic-Qt tool.</li> <li><strong>Auto-Tags</strong>: added online translations support.</li> <li><strong>DNG Writer</strong>: JPEG-XL compression support.</li> <li><strong>Bundles</strong>: Qt 6.7.2 used with Windows and Linux AppImage.</li></ul></td> </tr> <tr> <td>2024.03.17</td> <td>8.3.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=8.3.0">248</a></td> <td><ul><li>Introduced a new <strong>Auto-Tags</strong> tool based of deep-learning to identify and mark image contents automatically.</li> <li><strong>Video SlideShow</strong>: improvements to support Time-lapse, frames equalization, OSD, and audio track.</li></ul></td> </tr> <tr> <td>2023.12.03</td> <td>8.2.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=8.2.0">253</a></td> <td><ul><li><strong>Bundles</strong>: Windows version compiled natively with <a href="https://vcpkg.io">Microsoft VCPKG</a> tool-chain.</li> <li>Major bug fixes release.</li></ul></td> </tr> <tr> <td>2023.07.06</td> <td>8.1.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=8.1.0">457</a></td> <td><ul><li>Major bug triaging release.</li></ul></td> </tr> <tr> <td>2023.04.16</td> <td>8.0.0</td> <td><a href="https://bugs.kde.org/buglist.cgi?f1=cf_versionfixedin&limit=0&o1=equals&order=bug_id&product=digikam&v1=8.0.0">422</a></td> <td><ul><li><strong>Portability</strong>: Qt6 and KF6 frameworks port with Qt5 backward compatibility.</li> <li><strong>Image Quality Sorting</strong>: introduced a new image parser based on deep-learning engine.</li> <li><strong>Documentation</strong>: huge online manual update migrated from Docbook to <a href="https://www.sphinx-doc.org">Sphinx</a>/<a href="https://en.wikipedia.org/wiki/ReStructuredText">Restructured Text</a> with translations supports.</li></ul></td> </tr> </tbody> </table> <p><img src="https://www.digikam.org/img/content/documentation/digikam850.webp" alt="Native Apple Silicon Version of digiKam 8.5.0"></p>