ghcr.io/varun-raj/immich-power-tools:0.17.0

Immich Power Tools

一个非官方的Immich客户端，提供更好的工具来组织和管理您的Immich账户。开发此工具旨在加快您在Immich中组织人物和相册的工作流程。

在此观看演示视频

🎒功能

• 批量管理人物数据 👫：支持批量更新人物数据，并提供高级筛选选项
• 人物合并建议 🎭：基于相似度批量合并建议的人物面孔
• 更新缺失位置 📍：查找库中没有位置信息的资源，并使用资源的位置更新它们
• 潜在相册 🖼️：根据库中的资源和人物查找可能创建的相册
• 分析 📈：获取库的分析数据，如资源随时间的变化、EXIF数据等
• 智能搜索 🔎：使用自然语言搜索您的库，支持如 "show me all my photos from 2024 of " 之类的查询
• 批量日期偏移 📅：将选定资源的日期偏移指定的时间量。主要用于修正与实际日期不同步的资源日期

支持我 🙏

如果您觉得此工具有用，请考虑通过请我喝杯咖啡来支持我。

💭 背景故事

最近，我将整个Google Photos库迁移到了Immich，成功将所有资源及其相册迁移到了Immich。但有些方面，比如人物匹配，还存在不足。总体而言，我喜欢Immich的UI，但在内容组织方面，我觉得它相当受限，不得不批量处理很多事情，而不是打开每个资源单独操作。因此，我开发了这个工具（并持续迭代），以让自己和其他Immich用户的生活更轻松。

🚀 快速开始

🐬 使用Docker

Power-tools旨在与Immich一起使用，有两种运行方式。

方法1 - Docker Compose（推荐）

将以下内容作为新服务添加到您的docker compose中，与其他Immich服务一起。确保power-tools与Immich在同一网络中。

power-tools请参考示例docker-compose-all-immich.yml文件。

services:
# 其他服务...
power-tools:
container_name: immich_power_tools
image: ghcr.io/immich-power-tools/immich-power-tools:latest
volumes:
- immich-power-tools-data:/app/data
ports:
- "8001:3000"
env_file:
- .env

volumes:
immich-power-tools-data:

将Immich API密钥和Immich URL添加到env文件中（您已为Immich准备的那个）。您还需要添加DB_PORT（默认5432）和DB_HOST，后者必须设置为Immich数据库容器的名称（默认immich_postgres）。

DB_PORT``DB_HOST``immich_postgres

IMMICH_API_KEY= # your_immich_api_key
IMMICH_URL = "http://local-ip-of-immich:port" # Your immich instace ip address and port
EXTERNAL_IMMICH_URL = "https://external-address" # External address of immich

DB_PORT = "5432"
DB_HOST = "immich_postgres"

# 可选 - 智能搜索（查找）的AI配置
AI_API_KEY=your_api_key_here # 您的OpenAI兼容提供商的API密钥
AI_MODEL="gpt-4o-mini" # 例如 gpt-4o-mini, llama-3.1-8b-instant, llama3.1

获取Immich API密钥请参考：[***]

[!NOTE] 创建API密钥时，请确保为该API密钥选择所有权限。

[!NOTE] 创建API密钥时，请确保为该API密钥选择所有权限。

方法2 - Portainer

如果您使用Portainer，请使用docker run运行容器，并将power tools添加到与Immich相同的网络中。

docker run

# 从Docker运行power tools
docker run -d --name immich_power_tools -p 8001:3000 -v immich-power-tools-data:/app/data --env-file .env ghcr.io/immich-power-tools/immich-power-tools:latest

# 将Power tools添加到与Immich相同的网络
docker network connect immich_default immich_power_tools

🚀 本地开发

请使用bun运行项目。如果尚未安装bun，请访问bun.sh进行安装。

bun``bun将.env.example复制粘贴到.env并填写值。

.env.example``.env

IMMICH_URL="" # Immich URL
IMMICH_API_KEY="" # Immich API Key
DB_USERNAME="" # Postgress Database Username
DB_PASSWORD = "" # Postgres Database Password
DB_HOST = "" # Postgres Host (IP address or hostname of the database)
DB_PORT = "" # Postgres Port number (Default: 5432)
DB_DATABASE_NAME="" # Name of the database

# 可选 - 智能搜索（查找）的AI配置
AI_API_KEY="" # 您的OpenAI兼容提供商的API密钥
AI_BASE_URL="https://api.openai.com/v1" # OpenAI兼容API的基础URL
AI_MODEL="gpt-4o-mini" # "查找"中用于解析搜索查询的模型

确保您的机器上暴露了PostgreSQL端口。

获取Immich API密钥请参考：[***]

运行开发服务器：

bun run dev

功能

Immich相关

• 管理人物智能合并
• 智能合并
• 管理相册 批量删除 批量分享 批量编辑 筛选器 潜在相册 相册中的人物
• 批量删除
• 批量分享
• 批量编辑
• 筛选器
• 潜在相册
• 相册中的人物
• 缺失位置
• 统计 EXIF数据 资源随时间变化图表
• EXIF数据
• 资源随时间变化图表

技术相关

• 深色模式
• Docker化
• 身份验证
• 推送到GitHub Packages

技术栈

• Next.js 用于基础架构
• Tailwind CSS 用于样式
• Shadcn 用于UI组件
• Axios 用于API调用

外部服务

这些服务完全可选，您可以在不使用它们的情况下使用本工具。它们仅用于某些功能。但我们不会向这些服务发送任何个人数据。

用于热图的Google Maps Google Maps Javascript API密钥用于渲染热图的地图图层。渲染热图时，我们仅向Google Maps发送位置数据，不发送其他任何数据。绘制热图数据的代码：src/pages/assets/geo-heatmap.tsx:32

用于热图的Google Maps Google Maps Javascript API密钥用于渲染热图的地图图层。渲染热图时，我们仅向Google Maps发送位置数据，不发送其他任何数据。

绘制热图数据的代码：src/pages/assets/geo-heatmap.tsx:32

绘制热图数据的代码：src/pages/assets/geo-heatmap.tsx:32

用于“查找”中智能查询解析的OpenAI兼容AI提供商 任何OpenAI兼容的API都可用于解析“查找”页面中的搜索查询。您可以使用OpenAI和Groq等标准提供商，或使用Ollama或LM Studio运行本地模型。我们不会向AI提供商发送任何个人库数据；仅发送您的搜索文本进行解析。实际的资源查询使用Immich的智能搜索API。

使用AI解析的代码：src/helpers/ai.helper.ts

使用AI解析的代码：src/helpers/ai.helper.ts

示例：

项目仓库 README（补充）

一个非官方的Immich客户端，提供更好的工具来组织和管理您的Immich账户。开发此工具旨在加快您在Immich中组织人物和相册的工作流程。

观看演示视频

🎒功能特性

• 批量管理人物数据 👫：支持批量更新人物数据，并提供高级筛选功能
• 人物合并建议 🎭：基于相似度建议相似面孔，支持批量合并人物
• 更新缺失位置 📍：查找库中无位置信息的资源，并使用资源的位置更新它们
• 潜在相册 🖼️：根据库中的资源和人物，发现可能创建的相册
• 数据分析 📈：获取库的分析数据，如资源随时间的变化、EXIF数据等
• 智能搜索 🔎：使用自然语言搜索您的库，支持如“显示我2024年的所有照片”等查询
• 批量日期偏移 📅：将选定资源的日期偏移指定的时间量。主要用于修正与实际日期不同步的资源日期

支持我 🙏

如果您觉得此工具有用，请考虑通过请我喝杯咖啡来支持我。

💭 开发背景

最近我将整个Google相册库迁移到了Immich，成功迁移了所有资源及其相册。但在人物匹配等方面存在一些不足。总体而言，我喜欢Immich的UI，但在内容组织方面感觉相当受限，不得不进行大量批量操作，而不是逐个打开资源进行处理。因此，我开发了这个工具（并持续迭代），旨在让自己和其他Immich用户的生活更轻松。

🚀 快速开始

🐬 使用 Docker

Power-tools设计为与Immich一起使用，有两种运行方式。

方法 1 - Docker Compose（推荐）

将以下内容作为新服务添加到您的docker compose中，与其他Immich服务并列。确保power-tools与Immich在同一网络中。

请参考示例docker-compose-all-immich.yml文件。

services:
# 其他服务...
power-tools:
container_name: immich_power_tools
image: ghcr.io/immich-power-tools/immich-power-tools:latest
volumes:
- immich-power-tools-data:/app/data
ports:
- "8001:3000"
env_file:
- .env

volumes:
immich-power-tools-data:

将Immich API密钥和Immich URL添加到env文件中（您已为Immich准备的那个）。您还需要添加DB_PORT（默认5432）和DB_HOST，后者必须设置为Immich数据库容器的名称（默认immich_postgres）。

IMMICH_API_KEY= # your_immich_api_key
IMMICH_URL = "http://local-ip-of-immich:port" # 您的Immich实例IP地址和端口
EXTERNAL_IMMICH_URL = "https://external-address" # Immich的外部地址

DB_PORT = "5432"
DB_HOST = "immich_postgres"

# 可选 - 智能搜索（查找）的AI配置
AI_API_KEY=your_api_key_here # 兼容OpenAI的提供商的API密钥
AI_MODEL="gpt-4o-mini" # 例如 gpt-4o-mini, llama-3.1-8b-instant, llama3.1

获取Immich API密钥请参考：[***]

[!NOTE] 创建API密钥时，请确保为API密钥选择所有权限。

方法 2 - Portainer

如果您使用Portainer，请使用docker run运行容器，并将power tools添加到与Immich相同的网络中。

# 从Docker运行power tools
docker run -d --name immich_power_tools -p 8001:3000 -v immich-power-tools-data:/app/data --env-file .env ghcr.io/immich-power-tools/immich-power-tools:latest

# 将Power tools添加到与Immich相同的网络
docker network connect immich_default immich_power_tools

🚀 本地开发

[!NOTE] 请使用bun运行项目。如果尚未安装bun，请访问bun.sh进行安装。

将.env.example复制粘贴到.env并填写值。

IMMICH_URL="" # Immich URL
IMMICH_API_KEY="" # Immich API密钥
DB_USERNAME="" # Postgres数据库用户名
DB_PASSWORD = "" # Postgres数据库密码
DB_HOST = "" # Postgres主机（数据库的IP地址或主机名）
DB_PORT = "" # Postgres端口号（默认：5432）
DB_DATABASE_NAME="" # 数据库名称

# 可选 - 智能搜索（查找）的AI配置
AI_API_KEY="" # 兼容OpenAI的提供商的API密钥
AI_BASE_URL="https://api.openai.com/v1" # 兼容OpenAI的API基础URL
AI_MODEL="gpt-4o-mini" # "查找"功能中用于解析搜索查询的模型

[!NOTE] 确保您的机器上暴露了Postgres端口。

获取Immich API密钥请参考：[***]

运行开发服务器：

bun run dev

功能列表

Immich相关

• 管理人物
• 智能合并
• 管理相册
• 批量删除
• 批量分享
• 批量编辑
• 筛选器
• 潜在相册
• 相册中的人物
• 缺失位置
• 统计数据
• EXIF数据
• 资源随时间变化图表

技术相关

• 深色模式
• Docker化
• 身份验证
• 推送到GitHub Packages

技术栈

• Next.js 用于基础架构
• Tailwind CSS 用于样式
• Shadcn 用于UI组件
• Axios 用于API调用

外部服务

这些服务完全是可选的，您可以在不使用它们的情况下使用此工具。它们仅用于某些功能。但我们不会向这些服务发送任何个人数据。

• Google Maps 用于热图 Google Maps JavaScript API密钥用于渲染热图的地图图层。渲染热图时，我们仅向Google Maps发送位置数据，不发送任何其他数据。

绘制热图数据的代码：src/pages/assets/geo-heatmap.tsx:32

• 用于 Find 页面智能查询解析的 OpenAI 兼容 AI 提供商
  任何与 OpenAI 兼容的 API 都可用于解析“Find”页面中的搜索查询。您可以使用OpenAI和Groq等标准提供商，或通过Ollama或LM Studio运行本地模型。我们不会向 AI 提供商发送任何个人媒体库数据；仅发送您的搜索文本进行解析。实际的资产查询使用Immich 的智能搜索 API。

使用 AI 解析的代码：src/helpers/ai.helper.ts

示例：

• OpenAI： AI_BASE_URL=https://api.openai.com/v1，AI_MODEL=gpt-4o-mini
• Groq： AI_BASE_URL=https://api.groq.com/openai/v1，AI_MODEL=llama-3.1-8b-instant
• Ollama（本地）： AI_BASE_URL=http://localhost:11434/v1（如果在 Docker 中运行 Power Tools，则为http://host.docker.internal:11434/v1），AI_MODEL=llama3.1

贡献指南

欢迎为该项目做出贡献，我乐于接受任何建议和改进。请阅读CONTRIBUTING.md了解更多详情。