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

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

ghcr.iolinux/amd640.1.3大小: 49.58 MB更新于 2026年11月8日

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 了解更多详情。

专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告