Files
wiki/Catalogue-Self-Hosted/apps/app-immich-power-tools.md
2026-06-09 18:40:21 +02:00

99 lines
4.0 KiB
Markdown

---
title: Immich Power Tools
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, photos, immich, ai, tools, self-hosted]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Photos, https://github.com/immich-app/immich-power-tools]
---
# 📸 Immich Power Tools
> **Boîte à outils additionnelle pour Immich** : gérez tags, métadonnées, albums et doublons en masse, là où l'UI native d'Immich montre ses limites.
## 📋 Informations Générales
| Attribut | Valeur |
|----------|--------|
| **Nom** | Immich Power Tools |
| **Slug** | app-immich-power-tools |
| **Description** | Outils de gestion avancée pour utilisateurs Immich |
| **Site officiel** | [immich-power-tools.vercel.app](https://immich-power-tools.vercel.app) |
| **Repository** | [immich-app/immich-power-tools](https://github.com/immich-app/immich-power-tools) |
| **Stars** | 2 527 ⭐ |
| **Licence** | MIT |
| **Langage principal** | TypeScript, Svelte |
| **Catégorie** | Photos |
| **Tags** | [catalogue, photos, immich, ai, tools, self-hosted] |
## 📝 Description
**Immich Power Tools** est né d'un constat simple : Immich est un gestionnaire de photos excellent, mais certaines opérations de masse (renommer des centaines de photos, appliquer un tag à un album entier, nettoyer les doublons) restent fastidieuses dans son UI officielle. Ce projet vient combler ce manque.
L'application se connecte à votre **instance Immich via son API** et propose une UI dédiée aux opérations avancées : **gestion en masse de tags**, **édition rapide de métadonnées** (date, lieu, description), **détection et fusion de doublons** (avec comparaison visuelle), **batch EXIF** (réécrire la date depuis le nom de fichier ou l'EXIF), **statistiques d'utilisation** (espace, types de fichiers, répartition par album).
⚠️ **Prérequis absolu** : il vous faut une **clé API Immich** avec les droits appropriés, générée depuis l'UI Immich (Paramètres > Clés d'API). C'est une dépendance externe : l'app n'est pas un serveur autonome, c'est un **client web** que vous hébergez.
## 🚀 Installation
### Via Docker (recommandé)
```yaml
# docker-compose.yml
services:
immich-power-tools:
image: ghcr.io/immich-app/immich-power-tools:latest
container_name: immich-power-tools
restart: unless-stopped
environment:
- PUBLIC_IMMICH_API_URL=https://photos.example.com/api
ports:
- 8089:8080
```
### Installation manuelle
```bash
git clone https://github.com/immich-app/immich-power-tools.git
cd immich-power-tools
npm install
npm run build
# Servir le dossier build/ via n'importe quel serveur statique
```
## ⚙️ Configuration
- **Clé API Immich** : à fournir dans l'UI au premier lancement, stockée en `localStorage` du navigateur.
- **URL de l'API** : pointe vers votre instance Immich (même domaine ou cross-origin autorisé).
- **CORS** : Immich doit autoriser le domaine d'Immich Power Tools, sinon configurer un reverse proxy commun.
- **HTTPS** : obligatoire pour que les navigateurs modernes acceptent l'API fetch.
## 🔗 Alternatives
- **[[app-immich]]** — Sans qui cet outil n'a pas de raison d'exister
- **[[app-photoprism]]** — Natif plus complet côté édition, mais Immich reste plus moderne
- **[[app-damselfly]]** — Équivalent pour Windows + tagging IA local
## 🔒 Sécurité
- **Clé API sensible** : elle donne accès complet à vos photos — limiter les permissions au strict nécessaire.
- **Pas d'auth propre** : repose entièrement sur l'auth de la clé API Immich.
- **Exposition réseau** : à garder sur LAN ou derrière VPN, pas d'ouverture Internet directe.
## 📚 Ressources
- [Démo en ligne](https://immich-power-tools.vercel.app)
- [Repository GitHub](https://github.com/immich-app/immich-power-tools)
- [Documentation Immich API](https://immich.app/docs/api)
## 🔗 Pages Liées
- [[cat-photos]]
- [[app-immich]]
- [[app-damselfly]]
- [[app-photoprism]]
- [[app-traefik]]
- [[recettes-docker-compose]]
- [[securisation-home-lab]]