immich-power-tools : analyse pratique fondée sur le README
Des outils puissants pour organiser votre bibliothèque immich. Immich Power Tools Un client immich non officiel pour fournir de meilleurs outils pour organiser et gérer votre compte immich.
En bref
- De quoi s’agit-il ?
- Power tools for organizing your immich library. Immich Power Tools A unofficial immich client to provide better tools to organize and manage your immich account.
- À qui s’adresse-t-il ?
- Ce projet convient aux lecteurs dont le besoin correspond précisément aux fonctions documentées de immich-power-tools. Avant adoption, vérifiez le chemin propre au dépôt : commande d exemple, fichier de configuration, version publiée et résultat observé.
- Puis-je l’utiliser commercialement ?
- Oui, sous conditions strictes. AGPL-3.0 est une licence à copyleft réseau : si des personnes utilisent une version modifiée via un réseau, par exemple comme service hébergé, vous devez leur proposer son code source sous la même licence.
- Est-il encore maintenu ?
- Oui. Les derniers commits datent d’il y a 2 jours.
- En quel langage est-il écrit ?
- Principalement TypeScript, d’après les statistiques de langage de GitHub.
Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 14 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.
ANALYSE OPEN SOURCE APPROFONDIE
Pourquoi ce projet existe
Le README commence par une histoire : l'auteur a migré une bibliothèque Google Photos vers Immich, et bien que les médias et les albums aient été transférés, les outils d'organisation semblaient trop restrictifs. Ce projet existe pour combler cette lacune en gérant des opérations en masse qu'Immich ne propose pas, comme la mise à jour de plusieurs fiches personnes à la fois ou la fusion de visages similaires. Il est décrit comme un client Immich non officiel, donc il ne fait pas partie du projet Immich.
Ce que propose l'outil
La liste des fonctionnalités couvre la mise à jour en masse des données personnes avec des filtres avancés, des suggestions de fusion de personnes basées sur la similarité des visages, la détection des emplacements manquants en copiant les coordonnées de médias similaires, des suggestions d'albums potentiels basées sur les motifs de personnes et de médias, des analyses de bibliothèque telles que les médias dans le temps et les données EXIF, une recherche intelligente en langage naturel, et un décalage de date en masse pour corriger les horodatages désynchronisés. Le README inclut également une liste de contrôle montrant les éléments implémentés : fusion intelligente, suppression et partage en masse d'albums, albums potentiels, personnes dans l'album, emplacement manquant, statistiques avec EXIF et graphique des médias dans le temps, mode sombre, support Docker, authentification et publication vers GitHub Packages. Certains éléments comme l'édition en masse et les filtres ne sont pas encore cochés.
Exécution avec Immich
L'outil est conçu pour fonctionner aux côtés d'Immich. Pour Docker Compose, le README fournit une définition de service d'exemple qui ajoute un conteneur power-tools avec un volume de données, le port 8001 mappé sur 3000, et un fichier d'environnement. Le fichier d'environnement doit inclure IMMICH_API_KEY, IMMICH_URL, EXTERNAL_IMMICH_URL, DB_PORT et DB_HOST, où DB_HOST pointe vers le conteneur de base de données Immich. Une méthode Portainer utilise une commande docker run avec le même réseau. Le README note que Power Tools v0.22.0 et supérieur nécessitent Immich 3.0 ou plus récent. Pour le développement local, bun est requis et le README montre la copie de .env.example vers .env puis l'exécution de bun run dev, avec le port Postgres exposé.
Recherche intelligente et services externes
La fonction de recherche intelligente, appelée Find, utilise une API compatible OpenAI pour analyser la requête en langage naturel. Le README liste des exemples pour OpenAI, Groq et des fournisseurs locaux comme Ollama ou LM Studio, avec les variables d'environnement AI_BASE_URL et AI_MODEL. Il indique explicitement que seul le texte de recherche est envoyé au fournisseur d'IA et qu'aucune donnée personnelle de bibliothèque n'est partagée ; la recherche de médias utilise l'API Smart Search d'Immich. Pour la carte de chaleur, une clé API JavaScript Google Maps est utilisée, et le README précise que seules les données de localisation sont envoyées à Google Maps. Ces deux services sont facultatifs, et le README contient des liens vers les emplacements de code pour le tracé de la carte et l'analyse IA.
Pile technique, licence et état du dépôt
Le dépôt est écrit en TypeScript et utilise Next.js pour l'infrastructure, Tailwind CSS pour le style, Shadcn pour les composants UI et Axios pour les appels API. La licence est AGPL-3.0, une licence copyleft dont le préambule garantit aux utilisateurs la liberté de copier, distribuer et modifier le logiciel, et pour les logiciels de serveur réseau, exige que le code source modifié soit fourni aux utilisateurs du serveur. Selon les métadonnées du dépôt, le projet compte 2 640 étoiles, 53 forks et 119 problèmes ouverts, et n'est pas archivé. Le README indique également que le projet est encore en itération.
Ce que le README ne couvre pas
Le README ne contient pas de benchmarks de performance, d'audits de sécurité ni de garanties de disponibilité en production. Il ne spécifie pas non plus d'historique de versions au-delà de la note de compatibilité Immich 3.0, et ne documente pas de journal des modifications. Le texte de licence contient une clause de non-garantie, mais l'extrait fourni ne reproduit pas l'intégralité de l'avertissement. Si vous avez besoin de ces détails, ils ne sont pas établis par les sources.
Conclusion éditoriale
Ce projet convient aux lecteurs dont le besoin correspond précisément aux fonctions documentées de immich-power-tools. Avant adoption, vérifiez le chemin propre au dépôt : commande d exemple, fichier de configuration, version publiée et résultat observé. Les performances et garanties absentes du README restent à établir dans votre contexte.
Notes de la communauté