# Immich Power Tools: Enhance Your Immich Photo Library Management

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/varun-raj-immich-power-tools
Generated for open source discovery and AI-assisted research.

Immich Power Tools is an unofficial client designed to significantly improve the organization and management of your Immich photo library. It offers a suite of features for bulk operations, smart suggestions, and detailed analytics, streamlining workflows for users migrating from services like Google Photos. This tool helps users efficiently manage people, albums, locations, and more within their self-hosted photo solution.

GitHub: https://github.com/varun-raj/immich-power-tools
OSRepos URL: https://osrepos.com/repo/varun-raj-immich-power-tools

## Summary

Immich Power Tools is an unofficial client designed to significantly improve the organization and management of your Immich photo library. It offers a suite of features for bulk operations, smart suggestions, and detailed analytics, streamlining workflows for users migrating from services like Google Photos. This tool helps users efficiently manage people, albums, locations, and more within their self-hosted photo solution.

## Topics

- immich
- photo-sharing
- tools
- TypeScript
- self-hosted
- photo management
- utility

## Repository Information

Last analyzed by OSRepos: Wed Mar 04 2026 01:16:45 GMT+0000 (Western European Standard Time)
Detail views: 16
GitHub clicks: 19

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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:

yaml
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`).

bash
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:

bash
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](https://github.com/immich-power-tools/immich-power-tools){:target="_blank"}
*   **Demo Video**: [Watch Demo Video here](https://www.loom.com/embed/13aa90d8ab2e4acab0993bdc8703a750?sid=7149890-b745-473f-b239-a7bdbe6efc21){:target="_blank"}
*   **Support the Project**: [Buy me a coffee](https://www.buymeacoffee.com/varunraj){:target="_blank"}