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

Immich Power Tools

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

[!IMPORTANT] Immich v3.0兼容性：Power Tools v0.22.0及以上版本需要Immich 3.0或更新版本。

观看演示视频

🎒功能特性

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

支持我 🙏

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

💭 背景故事

最近我将整个Google相册库迁移到了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:
# Other 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"

# Optional - AI Configuration for Smart Search (Find)
AI_API_KEY=your_api_key_here # API key for your OpenAI-compatible provider
AI_MODEL="gpt-4o-mini" # e.g. gpt-4o-mini, llama-3.1-8b-instant, llama3.1

获取Immich API密钥请参考：https://immich.app/docs/features/command-line-interface#obtain-the-api-key

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

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

方法2 - Portainer

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

docker run

# Run the power tools from docker
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

# Add Power tools to the same network as 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

# Optional - AI Configuration for Smart Search (Find)
AI_API_KEY="" # API key for your OpenAI-compatible provider
AI_BASE_URL="https://api.openai.com/v1" # Base URL for OpenAI-compatible API
AI_MODEL="gpt-4o-mini" # Model used for parsing search queries in "Find"

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

获取Immich API密钥请参考：https://immich.app/docs/features/command-line-interface#obtain-the-api-key

运行开发服务器：

bun run dev

功能特性

Immich相关

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

技术相关

• 深色模式
• Docker化
• 身份验证
• 推送到github packages

[!IMPORTANT] Immich v3.0 兼容性：Power Tools v0.22.0 及更高版本需要 Immich 3.0 或更新版本。

观看演示视频

用于 Find 页面智能查询解析的 OpenAI 兼容 AI 提供商

任何 OpenAI 兼容的 API 均可用于解析“Find”页面中的搜索查询。您可以使用 OpenAI 和 Groq 等标准提供商，或通过 Ollama 或 LM Studio 运行本地模型。我们不会向 AI 提供商发送任何个人库数据；仅发送您的搜索文本进行解析。实际资产查询使用 https://immich.app/docs/api/search-smart。

[!NOTE] 使用 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 了解更多详情。