This project provides a suite of unofficial tools for organizing and managing Immich libraries, targeting Immich users who need more advanced bulk operations and insights than the native client offers. It aims to streamline workflows for managing people, albums, and asset metadata, enhancing the overall user experience.

How It Works

The tools leverage Immich's API to perform bulk operations and data analysis. Key features include bulk editing of people data, suggesting merges for duplicate individuals based on facial similarity, and identifying assets lacking location data to update them. It also offers album creation suggestions, library analytics, natural language search, and bulk date offsetting for metadata correction.

Quick Start & Requirements

• Installation: Recommended via Docker Compose. Add the provided service definition to your existing Immich docker-compose.yml.
• Prerequisites: Immich instance, Immich API Key, and optionally Google Maps API Key and Gemini API Key for enhanced features.
• Setup: Requires configuring .env file with Immich URL and API key.
• Documentation: Immich API Key acquisition: https://immich.app/docs/features/command-line-interface#obtain-the-api-key

Highlighted Details

• Bulk management of people data, including suggested merges based on facial similarity.
• Features for updating missing location data and identifying potential new albums.
• Library analytics, natural language search, and bulk date offset capabilities.
• Optional integration with Google Maps for heatmaps and Gemini for natural language search parsing.

Maintenance & Community

The project is actively developed by varun-raj. Contributions are welcome. Further community interaction details are not specified in the README.

Licensing & Compatibility

The project is not explicitly licensed in the README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

Some features like "Bulk Edit" and "Filters" are marked as incomplete. The project is unofficial and relies on Immich's API, which could be subject to change. The use of external APIs (Google Maps, Gemini) is optional but requires separate API keys.