Installation

Visit the download page of the digiKam Web site for up to date information on installing the current version of digiKam.

您可以在 KDE Attic 中找到所有 digiKam 的之前版本。

备注

Bundles with -debug in the file-name include debug symbols that allow developers to interpret debugger traces when the application stops working. The bundles that include debug symbols are large, but they can will help developers find and fix coding errors. See the Get Involved section for details.

最低系统要求

  • Operating System: 64-bit Windows 10 or newer, Apple macOS 64-bit based on Intel or Apple Silicon (M1 or later), or 64-bit Linux. See details below.

  • CPU: x86 Intel, AMD, or Arm; at least one 2 GHz core for standard photo processing, 4 cores for large photo or panorama processing, 8 cores for deep-learning capabilities such as face detection, image quality sorting, and auto-tags. See details below.

  • GPU: OpenGL 2.0 正常工作且兼容。在 Windows 上,您也可以使用驱动程序与 DirectX 9 或 11 兼容良好的显卡。

  • RAM: At least 4 GB for standard photo processing, 8 GB for large photo or panorama processing, 16 GB for deep-learning capabilities such as face detection and image quality sorting. See details below.

备注

If your computer is at the lower end of the CPU and RAM requirements, you can reduce preview lag by adjusting two digiKam configuration settings. To access these settings under Linux, select Settings ‣ Configure digiKam… from the menu-bar. (Under MacOS you instead select digiKam ‣ Preferences… from the menu-bar.) The configuration options are separated into categories displayed on independent pages. To minimize preview lag, uncheck the Use large thumbnail size for high screen resolution option on the Configure/Views/Icons page, and select the Preview shows embedded view if possible (faster) option on the Configure/Views/Preview page.

  • Monitors: Although the application can be used on a single screen, using multiple screens will improve the experience especially when reviewing items.

A Double-Screen Linux Station with Main Window on the Left and Light Table on the Right

小技巧

如果您的屏幕提供高 DPI 支持,请勾选 按照系统屏幕缩放比率进行高分辨率缩放 ,并使用 自定义字体

  • Storage: NVMe and SSD are the best choice for robust and speedy hosting of the digiKam database and collection.

在 Linux 平台运行 digiKam

digiKam can be installed on non-KDE Desktops without any issues. The application is offered in the form of 2 binaries:

  • Qt6 as main version based on last Qt framework. The minimum Ubuntu 22.04 has no such minimal requirements.

  • Qt5 as prior version based on older Qt framework. The minimum Ubuntu 20.04 has no such minimal requirements.

AppImage is a bundle hosting all the necessary dependencies to run digiKam. Nothing else is installed on your system. Turn on the executable property of the AppImage file and run it. That’s all…

AppImage 可执行程序启动时的录屏

小技巧

The AppImage bundle also includes the Showfoto Stand-Alone Image Editor. To run it, instead of digiKam, just add showfoto as an argument to the AppImage command line, like this:

./digiKam-X.Y.Z-Qt6-x86-64.appimage showfoto

备注

The AppImage bundle provides more startup options which can be listed with the help argument from the command line.

在 Windows 平台运行 digiKam

Using on a Standard Desktop

digiKam runs only on 64-bit versions of Windows 10 and newer. We cannot guarantee that digiKam runs on server or embedded versions of Windows.

The application is offered in the form of 2 installers:

  • Qt6 as main version based on last Qt framework.

  • Qt5 as prior version based on older Qt framework.

digiKam is available as a non-signed installable (Setup Program) version and as a standalone (Archive) version.

  • 安装版需要 管理员权限,直接安装在您的电脑上,它也会在程序列表中显示。

    • 您电脑上的所有用户都可以使用。

    • digiKam 安装文件位置固定,始终都在同一个文件夹里。

    When the file is downloaded, and the installer is started, a security warning will appear because the installer does not come from the Windows Store.

    The Windows Warning When you Try to Run digiKam Installer after Downloading

    You need to set the Windows Config Panel/Applications and Features to allow applications to be installed from sources outside the Microsoft store.

    The Windows Applications and Features Panel to Authorize digiKam Installation

    Because the installer is not signed, Microsoft Windows Defender will display an information dialog when the installer is started a second time.

    The Windows Information When you Run digiKam Installer

    Once the installer is running, follow the instructions from the assistant to install digiKam on your computer.

    备注

    If a previous version of digiKam is present on your system, the Windows installer will warn you to uninstall the previous version before proceeding with the new installation.

    如果您的系统上存在旧版的 digiKam , Windows 安装程序就会出现这样的警告

    提示您卸载旧版 digiKam 的 Windows 对话框

    安装 digiKam 新版本的 Windows 对话框

  • Standalone version: Doesn’t need administrator rights and isn’t installed or listed as a program, but is only accessible by the user who has downloaded the file.

    • Allows a normal user to use digiKam without a full installation.

    • You can also copy the digiKam folder onto any external drive and run it on a different computer without installing it. However, your personal settings and downloads within digiKam are limited to the computer you work on.

在 Windows 域中使用

If you want to use digiKam with domain users based on Windows Active Directory and/or Group Policies (GPOs) make sure all users have read/write access to the following folders:

%AppData%\digikam

%LocalAppData%\digikam

%LocalAppData%\digikamrc

%LocalAppData%\digikam_systemrc

%LocalAppData%\kxmlgui5\digikam\digikamui.rc

Similar requirements also exist for the Showfoto stand Alone Image Editor:

%AppData%\showfoto

%LocalAppData%\showfoto

%LocalAppData%\showfotorc

%LocalAppData%\showfoto_systemrc

%LocalAppData%\kxmlgui5\digikam\showfotoui.rc

Also make sure no GPO is blocking the access to these folders.

在 macOS 上运行 digiKam

The non-Signed Package

digiKam runs with on Apple-silicon based Macs (Qt6) and also on legacy Intel-based Macs 64-bit (Qt5). Minimum system requirements depend on the version of digiKam being installed:

digiKam 版本

Qt version

支持的 macOS 版本

>= 8.5.0

Qt6 and Qt5

macOS 11.3 Silicon and Intel (BigSur) or newer

7.10.0 及以上版本

Qt5 only

macOS 10.15 Intel (Catalina) or newer

7.0.0 及以上版本

Qt5 only

macOS 10.13 Intel (High Sierra) or newer

6.4.0 及以上版本

Qt5 only

macOS 10.12 Intel (Sierra) or newer

6.1.0 及以上版本

Qt5 only

macOS 10.11 Intel (El Capitan) or newer

6.0.0 及以上版本

Qt5 only

macOS 10.8 Intel (Mountain Lion) or newer

备注

Macports , which was used to build the digiKam PKG, has a rolling release policy making it difficult to provide binary compatibility with older versions of macOS. Macports packages are frequently updated for security reasons, and this can require a more recent macOS SDK.

When the PKG file is downloaded, and the installer is started, Apple Gatekeeper will display a security warning because the package is not signed.

The macOS Warning When you Try to Run the digiKam Installer after Downloading

You need to allow the installer to run by clicking on Open Anyway in the macOS System Settings/Security and Privacy dialog (scroll down to see the Security section).

授权 digiKam PKG 安装的 macOS 安全面板

Once the installer is running, follow the instructions from the assistant to install digiKam onto your computer.

The digiKam macOS PKG is running and Ready to Install

Application Permissions

Once installed, digiKam will need to access some system resources to run properly. The system will ask for permissions when digiKam is run, depending on actions performed by user. See below for some examples of permissions that may need to be set in the macOS Security and Privacy policy configuration panel:

  • Automation: You must allow digiKam to control Apple’s Finder app when you try to open an album in the Finder file manager through digiKam.

The macOS Security and Privacy Panel with the Automation Permissions

  • Accessibility: You must allow digiKam to control your computer if you want to change the desktop wallpaper with digiKam.

The macOS Security and Privacy Panel with the Accessibility Permissions

  • Files And Folders: You must allow digiKam to access files and folders outside the Photos directory, if you place your collections elsewhere on your computer.

具有文件和文件夹访问权限的 macOS 安全和隐私面板

  • Full Disk: You must allow digiKam to access data from other applications if you use the gPhoto2 driver to communicate with your camera.

The macOS Security and Privacy Panel with the Full Disk Access Permissions

  • Photos: You must allow digiKam to access your photos if you want digiKam to include the Apple Photos collection in your personal account.

The macOS Security and Privacy Panel with the Photos Access Permissions

备注

When digiKam is first run, if you point your collection to the standard Apple Photo library, MacOS will automatically ask you to grant access to the library.

The macOS dialog to grant access to Apple Photo library

配置文件

digiKam 应用程序范围内的持久化设置,根据您的平台,存储在以下位置。

  • General settings for the application. Delete this file and restart digiKam to reset the application to factory settings
    • Linux: ~/.config/digikamrc

    • Windows: %LocalAppData%\digikamrc

    • macOS: ~/Library/Preferences/digikamrc

  • System settings for the application. Delete this file and restart digiKam to reset the application to factory settings
    • Linux: ~/.config/digikam_systemrc

    • Windows: %LocalAppData%\digikam_systemrc

    • macOS: ~/Library/Preferences/digikam_systemrc

  • Cache location storing temporary files
    • Linux: ~/.cache/digikam

    • Windows: %LocalAppData%\digikam

    • macOS: ~/Library/Caches/digikam

  • Contains internal configuration files and downloaded deep-learning models
    • Linux: ~/.local/share/digikam

    • Windows: %AppData%\digikam

    • macOS: ~/Library/Application Support/digikam

  • Contains UI configuration. If your UI is broken, delete this file
    • Linux: ~/.local/share/kxmlgui5/digikam/digikamui5.rc

    • Windows: %LocalAppData%\kxmlgui5digikam\digikamui5.rc

    • macOS: ~/Library/Application Support/digikam/kxmlgui5/digikam/digikamui5.rc

Similar to digiKam, the Showfoto stand Alone Image Editor also has persistent settings stored at the following locations:

  • General settings for the application. Delete this file and restart digiKam to reset the application to factory settings
    • Linux: ~/.config/showfotorc

    • Windows: %LocalAppData%\showfotorc

    • macOS: ~/Library/Preferences/showfotorc

  • System settings for the application. Delete this file and restart digiKam to reset the application to factory settings
    • Linux: ~/.config/showfoto_systemrc

    • Windows: %LocalAppData%\showfoto_systemrc

    • macOS: ~/Library/Preferences/showfoto_systemrc

  • Cache location storing temporary files
    • Linux: ~/.cache/showfoto

    • Windows: %LocalAppData%\showfoto

    • macOS: ~/Library/Caches/showfoto

  • Contains internal configuration files and downloaded deep-learning models
    • Linux: ~/.local/share/showfoto

    • Windows: %AppData%\showfoto

    • macOS: ~/Library/Application Support/showfoto

  • Contains UI configuration. If your UI is broken, delete this file
    • Linux: ~/.local/share/kxmlgui5/showfoto/showfoto ui5.rc

    • Windows: %LocalAppData%\kxmlgui5showfoto\showfotoui5.rc

    • macOS: ~/Library/Application Support/showfoto/kxmlgui5/showfoto/showfotoui5.rc

备注

The character ‘~’ indicates the home directory on the system of the current user.

应用程序更新

重要

If you update digiKam to a new major version, for example from version 7 to version 8, we recommend you first backup your database files, since the internal schema may have changed. Typically, digiKam is able to migrate tables from an older version to a new one, and all of this is done automatically at startup. But it’s always better to save these important files before upgrading the application. See the Database Backup section in this manual for more recommendations.

If you use a bundle such as the official Linux AppImage, macOS package, or Windows installer, the application can be updated using the Help ‣ Check For New Version menu entry. See the updates settings on the Behavior page of the configuration dialog.

使用“检查每周测试版本”来更新应用程序