Immich
Fiches d'aide à propos d'Immich

Commencer à utiliser Immich
Immich c'est quoi ? 
Immich est un service de sauvegarde de photos, visant à remplacer Google Photos de manière open-source, sans limite de qualité et stockage, et dans le respect de votre vie privée. Ce service permet de sauvegarder vos photos depuis vos appareils mobiles de manière automatique mais également depuis une page web via une interface aguicheuse et fluide.
Mieux que des mots, une petite démo vaut mieux que mille mots : Portail de démo
Pour tester l'application mobile vous pouvez utiliser https://demo.immich.app/api comme URL du point de terminaison du serveur.
Email
Mot de passe
demo@immich.app
demo
Comment se connecter ?
Interface web
Vous avez été convaincue par la démo et souhaitez vous lancer ? Pour commencer à utiliser le service il va vous falloir un compte. Vous pouvez contacter Quentin Ferrara par le biais de votre choix pour obtenir ce compte. Vous devez fournir une adresse mail valide pour recevoir vos identifiants de connexion.
La connexion se fait désormais par l'intermédiaire d'identifiants fournis par Authentik, rendez-vous à la page dédiée sur le wiki pour en apprendre plus. Rendez-vous ici ou suivez le lien reçu dans le mail pour vous connecter pour la première fois sur l'interface web. Vous pouvez également vous rendre sur le portail des services et accéder au service par ce biais.
Application mobile
Entrez l'adresse du serveur : https://immich.ananas-services-group.fr
Puis cliquez sur OAuth et entrez vos identifiants Authentik : 
Et voilà, vous êtes connectés sur l'interface web et sur l'application mobile ! 

Sauvegarder ses photos
Depuis l'interface web
Pour sauvegarder vos photos depuis l'interface web un glisser-déposer permet d'envoyer vos photos et vidéos vers le serveur. Vous pouvez également appuyer sur le bouton "Envoyer" en haut à droite de l'interface. 
Les photos sont ensuite affichées dans la timeline triées par date. Si les dates des photos sont fausses, il est possible de changer la date de vos photos et vidéos directement sur l'interface web en cliquant sur la photo/vidéo concernée et en éditant la date qui s'affiche sur le côté. 
Dans la vue "Album", il est possible de créer des albums, d'y ajouter des photos et même d'y importer directement des photos depuis un dossier sur votre ordinateur. Les photos importer ici sont également affichées dans la timeline. 
Dans la vue "Utilitaire", il vous est possible de sélectionner des photos à conserver et à supprimer parmi des doublons.
Depuis l'application
Depuis l'application, depuis les paramètres de l'application dans la partie "Sauvegardé", activer la sauvegarde automatique. Il est également possible de choisir sous quelles conditions les photos sont envoyées automatiquement au serveur. Voici un exemple ci-dessous : 
Pour sauvegarder vos photos vous devrez également sélectionner les dossiers à sauvegarder. Vous pouvez le faire depuis les réglages. 
La première sauvegarde peut prendre du temps, il est préférable d'être connecté à un réseau wifi et d'avoir branché le chargeur de son téléphone. 

Migrer ses photos avec Immich Go
Avantages 
Téléversez facilement de gros exports Google Photos : Immich-Go excelle dans la gestion des archives massives que vous téléchargez depuis Google Photos via Google Takeout. Il traite efficacement ces archives tout en préservant des métadonnées précieuses telles que la localisation GPS, la date de capture et les informations d'album.
Téléversements flexibles : Immich-Go n'est pas limité à Google Photos. Vous pouvez téléverser des photos directement depuis vos dossiers sur ordinateur, l'arborescence des dossiers et des archives ZIP.
Installation simple : Immich-Go ne nécessite pas NodeJS ni Docker pour son installation. Cela facilite le démarrage, même pour ceux qui sont moins familiers avec les environnements techniques.
Priorisez la qualité : Immich-Go rejette toutes les versions de résolution inférieure qui pourraient être incluses dans Google Photos Takeout, garantissant que vous avez les meilleures copies possibles sur votre serveur Immich.
Meilleures pratiques pour Google Photos :
Extraction de vos photos :
- Choisissez le format ZIP lors de la création de votre export pour faciliter l'importation.
- Sélectionnez la plus grande taille de fichier disponible (50 Go) pour minimiser le nombre de parties d'archive.
- Téléchargez toutes les parties sur votre ordinateur.
Importation de vos photos :
- Si votre export est au format ZIP, vous pouvez l'importer directement sans avoir besoin de décompresser les fichiers au préalable.
- Il est important d'importer toutes les parties de l'export ensemble, car certaines données peuvent être réparties sur plusieurs fichiers.
- Utilisez `/path/to/your/files/takeout-*.zip` comme nom de fichier.
- Pour les fichiers .tgz (archives tar compressées), vous devrez décompresser tous les fichiers dans un dossier unique avant d'importer. Lorsque vous utilisez l'outil d'importation, n'oubliez pas l'option `-google-photos`.
- Vous pouvez supprimer tous les fichiers ou dossiers indésirables de votre export avant l'importation.
- Redémarrer un import interrompu ne causera aucun problème et reprendra le travail là où il s'était arrêté.
Beaucoup de fichiers ne sont pas importés : Quelles sont les options ?
- Vérifiez si toutes les parties de l'export ont été incluses dans le traitement.
- Demandez un nouvel export, soit pour une année entière, soit par petits incréments.
- Forcez l'importation de fichiers malgré l'absence de JSON. Utilisez l'option `-upload-when-missing-JSON`.
- Pour des éclaircissements sur le raisonnement derrière cette alternative à immich-cli, veuillez lire la motivation ici.
⚠️ Ceci est une version préliminaire, pas encore testée de manière extensive.  
⚠️ Conservez une copie de sauvegarde de vos fichiers pour plus de sécurité.
Exécution de immich-go
immich-go est un outil en ligne de commande qui doit être exécuté à partir d'une fenêtre de terminal. Le programme immich-go utilise l'API Immich, donc il nécessite l'adresse du serveur et une clé API valide.
Sur Linux, macOS et FreeBSD :
./immich-go -server=URL -key=KEY -general_options COMMAND -command_options... {path/to/files}
Important :
Les utilisateurs de macOS doivent explicitement autoriser l'exécution de immich-go. Ouvrez Confidentialité et sécurité > Paramètres de sécurité pour autoriser.
Sur les systèmes Windows :
.\immich-go -server=URL -key=KEY -general_options COMMAND -command_options... {path/to/files}
Gestion des options booléennes
Les options booléennes ont une valeur par défaut indiquée ci-dessous. Mentionner une option sur la ligne de commande change l'option à TRUE. Pour forcer une option à FALSE, utilisez la syntaxe suivante : 
-option=FALSE.
Exemple : immich-go vérifie le certificat SSL du serveur. Vous pouvez désactiver ce comportement en activant l'option 
-skip-verify-ssl. Il suffit d'ajouter 
-skip-verify-ssl. 
-skip-verify-ssl est équivalent à 
-skip-verify-ssl=TRUE. Pour désactiver la fonctionnalité (qui est le comportement par défaut), utilisez 
-skip-verify-ssl=FALSE.
Options partagées avec toutes les commandes
Paramètre
Description
Valeur par défaut
-use-configuration=path/to/config/file
Spécifie le fichier de configuration à utiliser. L'URL du serveur et la clé API sont stockées dans le fichier de configuration immich-go.
Linux : 
$HOME/.config/immich-go/immich-go.json
-server=URL
URL du service Immich, exemple 
http://:2283 ou 
https://your-domain.tld
 
-api=URL
URL du point de terminaison API Immich (
http://container_ip:3301)
 
-device-uuid=VALUE
Force l'identification de l'appareil
$HOSTNAME
-client-timeout=duration
Définit le délai d'attente pour les appels au serveur. La durée est un nombre décimal avec un suffixe d'unité, tel que "300ms", "1.5m" ou "45m".
5m
-skip-verify-ssl
Ignorer la vérification SSL pour l'utilisation avec des certificats auto-signés
false
-key=KEY
Une clé générée par l'utilisateur. Les photos téléchargées appartiendront au propriétaire de la clé.
 
-log-level=LEVEL
Ajuste la verbosité des journaux : ERROR, WARNING, INFO
INFO
-log-file=/path/to/log/file
Écrire tous les messages dans un fichier
Linux : 
$HOME/.cache/immich-go/immich-go_YYYY-MM-DD_HH-MI-SS.log
-log-json
Sortie du journal sous forme de fichier JSON délimité par des lignes
false
-time-zone=time_zone_name
Définit le fuseau horaire pour les dates sans information de fuseau horaire
Le fuseau horaire du système
-no-ui
Désactiver l'interface utilisateur
false
-debug-counters
Activer la génération d'un CSV à côté du fichier journal
false
-api-trace
Activer le suivi des appels API
false
Commande upload
Utilisez cette commande pour télécharger des photos et vidéos depuis un répertoire local, un dossier compressé ou tous les fichiers zip générés par la procédure d'exportation de Google Photos.
Paramètres et options :
Paramètre
Description
Valeur par défaut
-album="NOM DE L'ALBUM"
Importer les actifs dans l'album Immich NOM DE L'ALBUM.
 
-dry-run
Aperçu de toutes les actions telles qu'elles seraient effectuées.
FALSE
-create-album-folder
Générer des albums immich après les noms de dossier.
FALSE
-use-full-path-album-name
Utiliser le chemin complet du fichier pour déterminer le nom de l'album.
FALSE
-album-name-path-separator
Détermine comment plusieurs (sous) dossiers, le cas échéant, seront joints.
 
-create-stacks
Empiler jpg/raw ou des rafales.
FALSE
-stack-jpg-raw
Contrôler l'empilage des photos jpg/raw.
FALSE
-stack-burst
Contrôler l'empilage des rafales.
FALSE
-select-types=".ext,.ext,.ext..."
Liste des extensions acceptées.
 
-exclude-types=".ext,.ext,.ext..."
Liste des extensions exclues.
 
-when-no-date=FILE
NOW
Utiliser la date du fichier ou l'heure actuelle si la date ne peut pas être déterminée.
-exclude-files=pattern
Ignorer les fichiers basés sur un modèle.
@eaDir/
Exclusion de fichiers basée sur un modèle
Utilisez 
-exclude-files=PATTERN pour exclure certains fichiers ou répertoires du téléchargement. Répétez l'option pour chaque modèle dont vous avez besoin. Les répertoires suivants sont exclus automatiquement :
@eaDir/
@__thumb/
SYNOFILE_THUMB_.
Lightroom Catalog/
thumbnails/
.DS_Store/
Exemple : La commande suivante exclut tous les fichiers dans des répertoires appelés 
backup ou 
draft et tout fichier se terminant par "copy)".
immich-go -server=xxxxx -key=yyyyy upload -exclude-files=backup/ -exclude-files=draft/ -exclude=copy).*  /path/to/your/files
Options Google Photos
Paramètres spécialisés pour la gestion de Google Photos :
Paramètre
Description
Valeur par défaut
-google-photos
Importer depuis une archive structurée Google Photos, recréant les albums correspondants.
 
-from-album="ALBUM GP"
Créer l'album dans immich et importer les actifs de l'album.
 
-create-albums
Contrôle la création d'albums Google Photos dans Immich.
TRUE
-keep-untitled-albums
Les albums sans titre sont importés dans immich avec le nom du dossier comme titre.
FALSE
-use-album-folder-as-name
Utiliser le nom du dossier au lieu du titre de l'album.
FALSE
-keep-partner
Spécifie l'inclusion ou l'exclusion des photos prises par un partenaire.
TRUE
-partner-album="album du partenaire"
importer les actifs du partenaire dans l'album donné.
 
-discard-archived
Ne pas importer les actifs archivés.
FALSE
-auto-archive
Archiver automatiquement les photos qui sont également archivées dans Google Photos.
TRUE
-upload-when-missing-JSON
Télécharger des photos non associées à un fichier de métadonnées JSON.
FALSE
Détection des rafales
Actuellement, les rafales suivant ce schéma sont détectées :
xxxxx_BURSTnnn.*
xxxxx_BURSTnnn_COVER.*
xxxxx.RAW-01.COVER.jpg et 
xxxxx.RAW-02.ORIGINAL.dng
xxxxx.RAW-01.MP.COVER.jpg et 
xxxxx.RAW-02.ORIGINAL.dng
xxxxxIMG_xxxxx_BURSTyyyymmddhhmmss.jpg et 
xxxxxIMG_xxxxx_BURSTyyyymmddhhmmss_COVER.jpg (Huawei Nexus 6P)
yyyymmdd_hhmmss_xxx.jpg (Samsung)
Exemples d'utilisation : importer une archive d'exportation Google Photos
Pour illustrer, voici une commande qui importe des photos d'une archive d'exportation Google Photos capturées entre le 1er juin et le 30 juin 2019, tout en générant automatiquement des albums :
./immich-go -server=http://mynas:2283 -key=zzV6k65KGLNB9mpGeri9n8Jk1VaNGHSCdoH1dY8jQ upload -create-albums -google-photos -date=2019-06 ~/Download/takeout-*.zip             
Détermination des métadonnées
immich-go obtient les premières données disponibles dans l'ordre suivant :
Date de capture :
Google Photos Takeout
Champ JSON Google Photos 
photoTakenTime
Nom du fichier : ex 
PXL_20220909_154515546.jpg
Données EXIF de la photo
Importation de dossier
Fichier XMP
Localisation GPS :
Google Photos Takeout
Champ JSON Google Photos 
geoDataExif
Champ JSON Google Photos 
geoData
Champ d'album JSON Google Photos 
locationEnrichment
Données EXIF de la photo
Exemple d'utilisation : nettoyage du serveur immich après avoir fusionné une archive Google Photos et les fichiers originaux
Cette commande examine le contenu du serveur immich, supprime les images de moindre qualité et préserve les albums :
./immich-go -server=http://mynas:2283 -key=zzV6k65KGLNB9mpGeri9n8Jk1VaNGHSCdoH1dY8jQ duplicate -yes
Commande outil
Cette commande introduit des outils en ligne de commande pour manipuler votre serveur immich.
Sous-commande album delete [regexp]
Cette commande supprime les albums qui correspondent au modèle donné.
Exemple :
./immich-go -server=http://mynas:2283 -key=zzV6k65KGLNB9mpGeri9n8Jk1VaNGHSCdoH1dY8jQ tool album delete \d{4}-\d{2}-\d{2}
Installation
Installation depuis la release GitHub :
L'installation de immich-go est un processus simple. Visitez la page de la dernière release et sélectionnez le fichier binaire compatible avec votre système :
Darwin : arm-64, x86-64
Linux : arm-64, armv6-64, x86-64
Windows : arm-64, x86-64
FreeBSD : arm-64, x86-64
Téléchargez l'archive correspondant à votre OS/architecture sur votre machine et décompressez-la.
Ouvrez une fenêtre de commande, allez dans le répertoire où immich-go se trouve, et tapez la commande immich-go avec les paramètres et la commande obligatoires.
⚠️ Veuillez noter que la version Linux x86-64 est la seule testée.
Installation à partir des sources :
Pour une installation basée sur les sources, assurez-vous d'avoir les outils de développement nécessaires pour le langage Go en place. Téléchargez les fichiers sources ou clonez le dépôt.
go build -ldflags "-X 'main.version=$(git describe --tag)' -X 'main.date=$(date)'"
Installation avec Nix :
immich-go est emballé avec Nix et distribué via nixpkgs. Vous pouvez essayer immich-go sans l'installer avec :
nix-shell -I "nixpkgs=https://github.com/NixOS/nixpkgs/archive/nixos-unstable-small.tar.gz" -p immich-go
# Ou avec les flocons activés
nix run "github:nixos/nixpkgs?ref=nixos-unstable-small#immich-go" -- -help
Ou vous pouvez ajouter immich-go à votre configuration.nix dans la section 
environment.systemPackages.
Sources : 
Un outil existe pour migrer de grandes quantités de photos depuis un PC/Mac vers Immich de manière automatisée. 
https://github.com/simulot/immich-go?tab=readme-ov-file