immich-power-tools: Organize and Manage Immich Libraries

Overview

Immich Power Tools is an unofficial client that adds organization and management workflows for an Immich library. It focuses on tasks that can be tedious in Immich's standard interface, such as editing people data in bulk, reviewing potential merges, and finding assets that need location information.

It runs alongside an Immich instance and connects using an Immich API key and database access. It is most useful for people with libraries they actively organize, especially when bulk operations, library statistics, or assisted search are part of their workflow.

Key Features

• Update people data in bulk with filters, and review suggested face merges.
• Find potential albums based on library assets and people.
• Locate assets without location data and update them with the asset's location.
• View library analytics, including asset timelines and EXIF data.
• Search with natural-language queries through Immich's Smart Search API, with optional AI-based query parsing.
• Offset dates for selected assets to correct date discrepancies.
• Manage albums with bulk delete and sharing options.

Use Cases

• Immich users organizing a large library can update people records and handle suggested face merges in batches.
• People migrating photo collections to Immich can use potential album suggestions and people tools to continue organizing after import.
• Users with assets missing location metadata can find and update those items without checking every asset individually.
• Library owners who want an overview of asset timelines or EXIF data can use the built-in statistics.
• Users who want to search using phrases such as a year and a person's name can enable optional AI query parsing for the Find page.

Getting Started

The project is designed to run alongside Immich. Add the service to your Docker Compose setup and configure its Immich URL, API key, and database connection:

services:
  power-tools:
    image: ghcr.io/immich-power-tools/immich-power-tools:latest
    ports:
      - "8001:3000"
    env_file:
      - .env

See the repository README for the full configuration, including volumes, networking, and required environment variables.

Alternatives

• Lychee: Lychee is a standalone photo-management platform for uploading, organizing, and sharing photos, rather than a tool for bulk-managing an Immich library.

Considerations

• This is an unofficial Immich client, so it depends on Immich being available and correctly configured.
• The service needs an Immich API key with all permissions, plus access to the Immich database. The README's Docker setup also calls for the service to share a network with Immich.
• Power Tools v0.22.0 and later require Immich 3.0 or newer; check version compatibility before upgrading.
• Smart Search query parsing requires an optional OpenAI-compatible provider. The README says only the search text is sent for parsing, while asset queries use Immich's Smart Search API.
• The repository is not archived. Its AGPL-3.0 license is relevant if you plan to modify or redistribute the software.