IGOLz/ImmichGallery

这是什么？

核心功能

• 01时间线、收藏、视频、归档和最近删除等视图
• 02支持缩放、实况照片、幻灯片播放及 HDR 显示的查看器
• 03相册、人物、地图与地点，以及智能搜索和 OCR 搜索
• 04上传时支持重复检测，并可将原图或相册打包为 ZIP 下载
• 05支持多个账户和服务器，凭据保存在 macOS 钥匙串中

适用场景

• 在 Mac 上浏览自建 Immich 照片库，无需依赖浏览器标签页
• 在桌面应用中整理相册、人物和元数据
• 从 Finder 将照片文件夹上传到 Immich 服务器

快速上手

1. 1

   从最新版本下载 DMG 文件，并将应用拖到“应用程序”文件夹

2. 2

   克隆仓库

   git clone https://github.com/IGOLz/ImmichGallery.git
3. 3

   从命令行构建应用

   xcodebuild -project ImmichGallery.xcodeproj -scheme ImmichGallery -configuration Release -derivedDataPath build/DerivedData build

使用前须知

• !这是早期预览版，可能会编辑、移动或删除你 Immich 服务器上的照片。
• !需要 Immich 服务器（v2.0 或更高版本），且仅支持 macOS 15 或更高版本。
• !从源码构建需要 Xcode 26 或更高版本。

收录于专题

标签

常见问题

ImmichGallery 是什么？

面向 Immich 自建照片库的原生 macOS 客户端，界面风格接近 Apple 照片。 Immich Gallery 是一个独立的 macOS 应用，用于连接 Immich 服务器并以原生界面浏览照片库。它使用 SwiftUI 开发，支持侧边栏、工具栏、快捷键、多窗口与标签页、Quick Look、与 Finder 之间的拖放、系统分享菜单以及快捷指令。

ImmichGallery 可以免费使用吗？用的什么许可证？

ImmichGallery 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

ImmichGallery 还在维护吗？

活跃维护中。ImmichGallery 最近一次提交是在 2026年11月6日。

ImmichGallery 适合用来做什么？

在 Mac 上浏览自建 Immich 照片库，无需依赖浏览器标签页 在桌面应用中整理相册、人物和元数据 从 Finder 将照片文件夹上传到 Immich 服务器

ImmichGallery 怎么安装和运行？

从最新版本下载 DMG 文件，并将应用拖到“应用程序”文件夹 克隆仓库: git clone https://github.com/IGOLz/ImmichGallery.git 从命令行构建应用: xcodebuild -project ImmichGallery.xcodeproj -scheme ImmichGallery -configuration Release -derivedDataPath build/DerivedData build

在哪里获取 ImmichGallery？

源代码和安装说明在 GitHub 上：https://github.com/IGOLz/ImmichGallery