安装

你可以访 digiKam 官网的 软件下载页面 ,查看最新版本 digiKam 的安装要求。

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

备注

文件名中带有 -debug 的安装包包含 调试符号 ,可以帮助开发人员在程序停止运行时查看调试信息。这类安装包体积会比较大,但对开发者排查和修复代码错误非常有帮助。具体信息请参考 参与贡献 部分。

最低系统要求

  • 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 Artificial Intelligence usages, such as Face Workflow, Auto-Tags, Aesthetic Detection, Red Eye Removal, and Auto-Transform features.

  • GPU: OpenGL 2.0 that works correctly and is compatible. On Windows, you can also use a card with good, compatible DirectX 9 or 11 drivers. It’s highly recommended to use a device with OpenCL support (as CUDA based device like NVIDIA cards) to speed-up Artificial Intelligence engine.

  • RAM: At least 4 GB for standard photo processing, 8 GB for large photo or panorama processing, 16 GB for Artificial Intelligence capabilities.

备注

如果你的电脑正好处于最低配置边缘,可以通过调整 digiKam 的两个设置来减少预览卡顿。在 Linux 下,点击菜单栏的 设置 ‣ 配置 digiKam… 进入设置页面。(在 macOS 下,请点击菜单栏的 digiKam ‣ 首选项… )。 配置选项按类别分布在不同的页面中。为了减少预览卡顿,可以取消勾选 使用高分辨率缩略图 选项(位置在“配置 digiKam - 视图 - 图标”页面),并启用 预览时显示图像内嵌的预览图(如果可用/更快) 选项(位置在“配置 digikam - 视图 - 预览”页面)。

  • 显示器:digiKam 在单屏幕下可以正常使用,不过如果你连接多屏幕,体验会更好,尤其是在查看照片时。

双屏 Linux 工作站, 主窗口 在左侧, 多图对比 窗口在右侧。

小技巧

如果您的屏幕提供高 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:主版本,基于最新的 Qt 框架。最低支持 Ubuntu 22.04,无其他附加要求。

  • Qt5:旧版本,基于较早的 Qt 框架。最低支持 Ubuntu 20.04,无其他附加要求。

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 文件的录屏

小技巧

AppImage 安装包中还包含一个 独立运行的图片编辑器 —— Showfoto 。要使用它,只需在运行 AppImage 命令时加上 showfoto 参数,例如:

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

备注

AppImage 安装包还提供了一些启动参数,可以通过命令行加上 help 参数查看完整选项列表。

在 Windows 平台运行 digiKam

在标准桌面环境中使用

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.

该程序提供两种安装包形式:

  • Qt6:主版本,基于最新的 Qt 框架

  • Qt5:旧版本,基于较早的 Qt 框架

digiKam 提供两种类型的 Windows 安装方式,一种是 可安装 版本(安装程序形式),一种是 独立版本 (压缩包形式)。

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

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

    • digiKam 的所有文件都会安装在同一个文件夹里。

    当你下载完文件并启动安装程序时,系统可能会弹出安全警告提示,因为这个安装程序不是来自 Windows 应用商店。

    尝试运行 digiKam 安装程序后的 Windows 警告

    你需要在 Windows 设置面板 - 应用和功能 中允许安装来自 Microsoft 商店以外来源的应用。

    在“应用和功能”面板中授权安装 digiKam

    由于安装程序未经过数字签名,当你第二次运行它时,Windows Defender 可能会弹出提示对话框。

    Windows Defender 在你运行 digiKam 安装程序时显示的信息

    一旦启动安装程序,按提示操作即可将 digiKam 安装到你的电脑上。

    备注

    如果系统中已经安装了旧版本的 digiKam,安装程序会提示你先卸载旧版本,才能继续新版本的安装。

    如果您的系统上存在旧版的 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.

    • 所以如果一个普通用户不想走一遍完整安装过程也可以使用 digiKam。

    • 你也可以把 digiKam 文件夹复制到任意外接硬盘,然后在其他电脑上直接运行,无需安装。但请注意,你在 digiKam 中的个人设置和下载内容只会保留在当前使用的电脑上。

在 Windows 域中使用

如果你想在基于 Windows 域控(Active Directory)和 / 或组策略 (GPOs ) 环境中为域用户使用 digiKam,请确保所有用户都对以下文件夹有读写权限:

%AppData%\digikam

%LocalAppData%\digikam

%LocalAppData%\digikamrc

%LocalAppData%\digikam_systemrc

%LocalAppData%\kxmlgui5\digikam\digikamui.rc

独立运行的 Showfoto 图像编辑器 的要求类似:

%AppData%\showfoto

%LocalAppData%\showfoto

%LocalAppData%\showfotorc

%LocalAppData%\showfoto_systemrc

%LocalAppData%\kxmlgui5\digikam\showfotoui.rc

也要确保没有 GPO 阻挡对这些文件夹的访问。

在 macOS 上运行 digiKam

未签名的包

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 版本

支持的 macOS 版本

>= 8.5.0

Qt6 和 Qt5

macOS 11.3 Silicon 和 Intel (BigSur) 或更高版本

7.10.0 及以上版本

仅 Qt5

macOS 10.15 Intel (Catalina) 或更高版本

7.0.0 及以上版本

仅 Qt5

macOS 10.13 Intel (High Sierra) 或更高版本

6.4.0 及以上版本

仅 Qt5

macOS 10.12 Intel (Sierra) 或更高版本

6.1.0 及以上版本

仅 Qt5

macOS 10.11 Intel (El Capitan) 或更高版本

6.0.0 及以上版本

仅 Qt5

macOS 10.8 Intel (Mountain Lion) 或更高版本

备注

digiKam 的 PKG 安装包是通过 Macports 构建的。由于 MacPorts 实行“滚动更新”策略,这使得它难以与旧版本的 macOS 保持二进制兼容性。出于安全考虑,MacPorts 的软件包会频繁更新,这通常需要较新的 macOS SDK 才能运行。

从 macOS Ventura 系统开始,“系统偏好设置”面板改版,所有 Apple 设备都采用了相同的界面。由于 digiKam 也可以安装在 Ventura 之前的系统版本上,下面会分别提供两种系统的截图。

GateKeeper 规则

当你下载好 PKG 文件并启动安装程序时,Apple 的 GateKeeper 会弹出安全提示,因为该安装包没有签名。

Ventura 之前和之后版本系统在你尝试运行 digiKam 安装程序时的安全警告

你需要在 系统设置 - 安全性与隐私 对话框中点击 仍要打开 来允许安装程序运行(向下滚动可以看到 安全性 相关选项)。

Ventura 之前和之后版本的 macOS 安全设置界面,授权 digiKam 安装包运行

在 macOS Ventura 及之后的版本中,系统会再次弹出确认窗口,双重确认是否运行此应用。

macOS Ventura 及更新系统下,digiKam 的第二次运行确认对话框

安装程序启动后,按照安装向导的提示完成 digiKam 安装即可。

digiKam 的 macOS 安装包正在运行并准备安装

应用权限

安装完成后,digiKam 需要访问部分系统资源才能正常运行。首次运行 digiKam 时,系统会根据你的操作请求相应权限。以下是一些可能需要在 系统设置 - 安全性与隐私 中手动授权的权限示例:

  • 自动化 :如果你想通过 digiKam 打开访达文件管理器中的某个相册,你需要允许 digiKam 控制 Apple 的访达应用。

Ventura 之前和之后的 macOS 安全与隐私设置界面中的自动化权限

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

Ventura 之前和之后的 macOS 安全与隐私设置界面中的辅助功能权限

  • Full Disk: You must allow digiKam to access files and folders outside the Photos directory, if you place your collections elsewhere on your computer. Also, full disk access allow digiKam to access data from other applications if you use the gPhoto2 driver to communicate with your camera for example.

Ventura 之前和之后的 macOS 安全与隐私设置界面中的完整磁盘访问权限

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

Ventura 之前和之后的 macOS 安全与隐私设置界面中的照片权限

备注

首次运行 digiKam 时,如果你将图库路径指向 Apple 照片的标准图库位置,macOS 会自动弹出对话框请求你授权访问该图库。

Ventura 之前和之后版本系统,在应用启动时请求访问 Apple Photo 图库的弹窗

配置文件

digiKam 的全局永久性设置会根据不同操作系统平台,保存在以下位置:

  • General settings for mostly all the application configuration. 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 refering to the all configuration available from Setup/Miscs/System dialog page. 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 eg. the toolbar contents and positions. 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

类似于 digiKam, Showfoto(一款独立运行的图像编辑器) 也会将设置保存在以下位置:

  • General settings for mostly all the application configuration. 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 refering to the all configuration available from Setup/Miscs/System dialog page. 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 eg. the toolbar contents and positions. 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

备注

  • LinuxmacOS 系统中,字符 ~ 表示当前用户的“主目录”。

  • 在 Windows 系统中,%_变量名_% 表示系统中的一个 特殊文件夹 ,通常指向用户空间下的缓存目录。

应用程序更新

重要

如果你要进行一个大版本更新,比如从 digiKam 7 到 digiKam 8,我们建议备份 你的数据库文件 ,因为一般来说,内部数据库纲目结构会有变化。通常情况下,digiKam 能够将数据表从旧版本迁移到新版本,并且在程序启动时自动完成,但在任何情况下,升级应用程序之前,最好保存这些重要的 digiKam 文件。更多建议请看本手册中的 数据库备份 部分。

如果你通过捆绑包(比如 Linux AppImage、macOS 软件包或 Windows 安装程序)安装的,那么可以使用 帮助 ‣ 检查新版软件菜单项 来更新应用程序。另外,也请查看“配置 digiKam”中的 行为设置页面 中的更新设置。

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