Bibliothèques externes et outils tiers

Si vous avez déjà hébergé Immich vous-même, vous êtes peut-être habitué à des fonctionnalités qui reposent sur un accès direct au serveur, comme les bibliothèques externes ou les outils qui se connectent à la base de données Immich. PixelUnion étant un service géré, certaines de ces fonctionnalités fonctionnent différemment. Cet article explique ce qui est possible et ce qui ne l’est pas.

Les bibliothèques externes ne sont pas disponibles

Dans une installation Immich auto-hébergée, une bibliothèque externe permet à Immich de lire des photos depuis un dossier qui existe déjà sur le serveur ou sur un disque monté, par exemple un partage NAS. Immich indexe ces fichiers là où ils se trouvent, sans les copier dans son propre stockage.

Cette fonctionnalité n’est pas disponible sur PixelUnion. Votre environnement PixelUnion fonctionne dans notre centre de données et n’a pas accès aux dossiers de votre propre ordinateur ou NAS. Pour la même raison, l’endpoint API /api/library, qui gère les bibliothèques externes, est désactivé.

À la place, toutes les photos et vidéos sur PixelUnion se trouvent dans une bibliothèque gérée classique : les fichiers sont téléversés dans votre environnement et stockés par PixelUnion. Cela signifie aussi que vous gardez le contrôle total sur tout son contenu. Vous pouvez modifier, mettre à la corbeille et supprimer n’importe quelle photo, ce qui n’est pas possible avec les fichiers en lecture seule d’une bibliothèque externe.

Alternatives

Pour transférer des photos d’un dossier ou d’un NAS vers PixelUnion, téléversez-les :

• Immich Go : un outil en ligne de commande qui téléverse un dossier entier en une seule fois. Si vous le relancez plus tard, il ne téléverse que les nouveaux fichiers. Exemple :

  ./immich-go upload from-folder --server=https://yourname.pixelunion.eu --api-key=YOUR_API_KEY /path/to/your/photos
  

  Consultez Migrer depuis un autre serveur Immich pour savoir comment télécharger Immich Go et créer une clé API.

• L’application mobile : sauvegardez automatiquement la pellicule et d’autres dossiers de votre téléphone. Consultez Application Mobile.

• L’interface web : glissez-déposez des fichiers ou des dossiers dans votre navigateur. Consultez Télécharger des Photos.

Vous utilisez déjà votre propre serveur Immich avec une bibliothèque externe ? Vous pouvez transférer cette bibliothèque vers PixelUnion avec Immich Go, consultez Migrer depuis un autre serveur Immich.

Utiliser l’API Immich et des outils tiers

Vous pouvez utiliser l’API Immich avec vos propres clés API, donc la plupart des outils construits sur l’API fonctionnent avec PixelUnion. Créez une clé API dans Paramètres du compte → Clés API. Seuls deux endpoints sont désactivés : /api/library (bibliothèques externes) et /api/system-config (configuration du serveur).

Certains outils tiers ont besoin de plus que l’API. Ils se connectent directement à la base de données Immich ou lisent le système de fichiers du serveur. PixelUnion ne fournit d’accès direct à aucun des deux, donc ces outils, ou les fonctionnalités qui en dépendent, ne fonctionneront pas.

Immich Power Tools en est un exemple : plusieurs de ses fonctionnalités interrogent directement la base de données Immich. Les fonctionnalités qui utilisent uniquement l’API peuvent fonctionner, mais attendez-vous à ce qu’une partie de l’outil soit indisponible.

Avant de vous appuyer sur un outil tiers, vérifiez dans sa documentation s’il nécessite une connexion à la base de données ou un accès au système de fichiers.

Supprimer les doublons sans outils supplémentaires

Immich intègre une détection des doublons. Dans l’interface web, allez dans Utilitaires → Examiner les doublons pour comparer des photos similaires côte à côte et choisir celles à conserver. Les doublons sont détectés par utilisateur, donc les photos téléversées par deux utilisateurs différents ne sont pas comparées entre elles.

Conserver la structure de vos albums dans une sauvegarde locale

Vos données sont sauvegardées par PixelUnion, consultez Backups : comment nous sauvegardons vos données. Si vous souhaitez aussi votre propre copie locale, sachez que de nombreux outils de téléchargement enregistrent les fichiers eux-mêmes, mais pas les albums auxquels ils appartiennent.

Il existe plusieurs façons de conserver vos albums :

1. immich-archiver : notre propre outil de téléchargement écrit un fichier .json à côté de chaque photo et vidéo, qui indique notamment les albums auxquels elle appartient. Consultez Télécharger Toutes les Photos et Vidéos.
2. Télécharger album par album : ouvrez un album dans l’interface web et téléchargez-le. Vous obtenez un fichier ZIP contenant toutes les photos et vidéos de cet album, mais aucune information d’album au-delà du dossier lui-même.
3. Utiliser l’API : l’API Immich renvoie tous vos albums et les photos de chaque album, vous pouvez donc écrire votre propre script si vous avez besoin d’une autre structure.

Besoin d’aide ?

Vous ne savez pas si un outil ou une méthode de travail fonctionnera avec PixelUnion ? Contactez notre équipe de support et nous vous aiderons à le vérifier.