Immich Power Tools: Enhance Your Immich Photo Library Management

Introduction

Immich Power Tools is an unofficial client designed to significantly enhance the organization and management of your Immich photo library. Built with TypeScript, this project addresses common challenges faced by users, especially those migrating large photo collections from services like Google Photos. It provides a robust set of features to streamline workflows, allowing for efficient bulk operations and advanced management of people, albums, and asset metadata within your self-hosted Immich instance.

Installation

Immich Power Tools is designed to run alongside your existing Immich setup. The recommended method for installation is via Docker Compose.

Using Docker Compose

Add the following service definition to your docker-compose.yml file, ensuring it's on the same network as your other Immich services:

services:
  # Other services...
  power-tools:
    container_name: immich_power_tools
    image: ghcr.io/varun-raj/immich-power-tools:latest
    ports:
      - "8001:3000"
    env_file:
      - .env

You will also need to configure your .env file with the Immich API Key, Immich URL, and database connection details. Ensure the DB_HOST points to your Immich PostgreSQL container name (e.g., immich_postgres).

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

DB_PORT = "5432"
DB_HOST = "immich_postgres"

# Optional
GEMINI_API_KEY= # Gemini API Key

For obtaining your Immich API Key, refer to the official Immich documentation. It is crucial to select all permissions when generating the API key for full functionality.

Alternative: Docker Run

If you prefer, you can run the container using docker run and then connect it to your Immich network:

docker run -d --name immich_power_tools -p 8001:3000 --env-file .env ghcr.io/varun-raj/immich-power-tools:latest
docker network connect immich_default immich_power_tools

Examples

Immich Power Tools offers a comprehensive suite of features to enhance your Immich experience:

• Manage People Data in Bulk: Update people data efficiently with advanced filters.
• People Merge Suggestion: Bulk merge people based on suggested face similarities.
• Update Missing Locations: Identify and update assets in your library that lack location data.
• Potential Albums: Discover and create albums based on assets and people in your library.
• Analytics: Gain insights into your library with statistics on assets over time, EXIF data, and more.
• Smart Search: Perform natural language searches, such as "show me all my photos from 2024 of <person name>".
• Bulk Date Offset: Correct asset dates by offsetting them by a specified amount, useful for fixing synchronization issues.

Why Use Immich Power Tools?

This tool is invaluable for anyone looking to take their Immich library management to the next level. It addresses the limitations of native Immich for bulk operations, saving significant time and effort. Whether you are organizing a newly migrated library, refining people tags, or ensuring all your photos have accurate metadata, Immich Power Tools provides the necessary functionalities to maintain a well-organized and easily searchable photo collection. It empowers users with greater control and efficiency over their self-hosted digital assets.

Links

• GitHub Repository: https://github.com/immich-power-tools/immich-power-tools
• Demo Video: Watch Demo Video here
• Support the Project: Buy me a coffee