I maintain this and other Home Assistant add-ons in my free time: keeping up with upstream changes, HA changes, and testing on real hardware takes a lot of time (and some money). I use around 5-10 of my >110 addons so regularly I install test machines (and purchase some test services such as vpn) that I don't use myself to troubleshoot and improve the addons

If this add-on saves you time or makes your setup easier, I would be very grateful for your support!

Addon informations

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

About

Immich Power Tools provides advanced tools for organizing and managing your Immich photo library. This addon extends Immich's capabilities with powerful features for photo organization, analysis, and management.

Key features:

Advanced photo organization tools
Batch operations for photo management
AI-powered photo analysis and tagging
Geographic photo mapping with Google Maps integration
Duplicate detection and management
Advanced search and filtering capabilities

This addon is based on the immich-power-tools project.

Configuration

Webui can be found at <your-ip>:8001.

Options

Option	Type	Default	Description
`IMMICH_URL`	str	Required	Internal Immich server URL (e.g., `http://homeassistant:3001`)
`EXTERNAL_IMMICH_URL`	str	Required	External Immich server URL for browser access
`IMMICH_API_KEY`	str	Required	Immich API key for authentication
`DB_HOST`	str	Required	Database hostname (e.g., `core-mariadb` or `homeassistant`)
`DB_USERNAME`	str	Required	Database username
`DB_PASSWORD`	str	Required	Database password
`DB_DATABASE_NAME`	str	Required	Database name (usually `immich`)
`DB_PORT`	str	Required	Database port (usually `5432` for PostgreSQL)
`GOOGLE_MAPS_API_KEY`	str		Google Maps API key for geographic features
`GEMINI_API_KEY`	str		Google Gemini API key for AI features

Example Configuration

IMMICH_URL: "http://homeassistant:3001"
EXTERNAL_IMMICH_URL: "https://your-immich-domain.com"
IMMICH_API_KEY: "your-immich-api-key-here"
DB_HOST: "core-mariadb"
DB_USERNAME: "immich"
DB_PASSWORD: "your-db-password"
DB_DATABASE_NAME: "immich"
DB_PORT: "5432"
GOOGLE_MAPS_API_KEY: "your-google-maps-api-key"
GEMINI_API_KEY: "your-gemini-api-key"

Prerequisites

Before using this addon, ensure you have:

Immich server running - This addon requires a working Immich installation
Database access - You need direct access to your Immich database
Immich API key - Generate an API key from your Immich admin panel

Getting API Keys

Immich API Key:

Open your Immich web interface
Go to Administration > API Keys
Click Create API Key
Copy the generated key

Google Maps API Key (optional):

Visit the Google Cloud Console
Create a new project or select an existing one
Enable the Maps JavaScript API
Create credentials (API key)

Google Gemini API Key (optional):

Visit Google AI Studio
Create a new API key for Gemini

Custom Scripts and Environment Variables

This addon supports custom scripts and environment variables through the addon_config mapping:

Custom scripts: See Running Custom Scripts in Addons
env_vars option: Use the add-on env_vars option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.

Installation

The installation of this add-on is pretty straightforward and not different in comparison to installing any other Hass.io add-on.

Add my Hass.io add-ons repository to your Hass.io instance.
Install this add-on.
Configure all required database and API settings.
Click the Save button to store your configuration.
Start the add-on.
Check the logs of the add-on to see if everything went well.
Open the webUI to start using the power tools.

Support

Create an issue on github, or ask on the home assistant community forum

For more information about Immich Power Tools, visit: https://github.com/varun-raj/immich-power-tools