ghcr.io/varun-raj/immich-power-tools:0.1.3
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 了解更多详情。
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务